Setting Up Chat Webhooks

Chat Webhooks

Webhooks allow external services to post messages to your chat channels automatically.

Enabling Webhooks

1. Open the channel where you want to receive webhook messages.
2. Click the Settings icon (admin only).
3. Find the Webhook section.
4. Enable the webhook toggle.
5. Copy the Webhook URL.

Sending Messages via Webhook

Send a POST request to the webhook URL with a JSON body:

Method: POST /api/chat/webhook/{token}
Content-Type: application/json
Body: {"content": "Your automated message here"}

Use Cases

• CI/CD pipeline notifications (build success/failure)
• Monitoring alerts from external tools
• Automated status updates from third-party services

Security

If you suspect a webhook token has been compromised, regenerate it from the channel settings. The old token will immediately stop working.

Webhooks are rate-limited to 60 requests per minute per IP address to prevent abuse.