noisebell/remote/zulip-bot

Zulip Bridge

Receives webhooks from the cache service and posts door status updates into a Zulip stream.

Validates inbound webhooks with a Bearer token, then sends a stream message through the Zulip API using a bot email and API key.

API

Method	Path	Auth	Description
POST	/webhook	Bearer	Status update from the cache service
GET	/health	-	Health check

Configuration

NixOS options under services.noisebell-zulip:

Option	Default	Description
domain	required	Caddy virtual host domain
zulipUrl	required	Base URL of the Zulip server
botEmail	required	Zulip bot email address
apiKeyFile	required	Zulip bot API key file
stream	required	Zulip stream for updates
topic	noisebell	Zulip topic for updates
imageBaseUrl	https://noisebell.extremist.software/image	Base URL for status image links
webhookSecretFile	required	Shared secret with the cache service
port	3003	Listen port