Netlify
Receive Netlify deploys and form submissions in Telegram.
Add the webhook
For deploys, open your site settings, then Notifications → Deploy notifications → Add notification → Outgoing webhook:
| Field | Value |
|---|---|
| Event to listen for | One of the deploy events below |
| URL to notify | https://thook.altr.dev/hooks/netlify/{unique_path} |
| JWS secret token | The secret key from the bot |
Netlify marks the JWS secret token as optional, but Thook requires it: unsigned requests are rejected with 401. Create one notification for each event you want.
For forms, open Forms → Form notifications → Add notification → Outgoing webhook and use the same URL and token.
Supported events
- Deploy started
- Deploy succeeded
- Deploy failed
- Deploy locked and deploy unlocked
- Form submission
What you get
🔴 Deploy failed · Netlify
my-site · main
Build script returned non-zero exit code: 2
[ Deploy log ]📥 New form submission · Netlify
contact · my-site.example
👤 Alessandro · [email protected]
Hello, I would like to know more.
📍 203.0.113.7
[ Open site ]A failed deploy shows the error and a button to its log in Netlify. An automatic deploy is not credited to a person.
Troubleshooting
401: the JWS secret token is empty or differs from the bot secret. Thook also checks that the signature belongs to the request body.- No form messages: the form notification is separate from the deploy ones, add it under Forms.