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
  • Deploy restored (a previous deploy is published again)
  • Deploy deleted
  • Deploy request pending, accepted and rejected (deploy previews that wait for a review)
  • Form submission

What you get

The meaning of the icons is in the quick start.

🔴 Deploy failed · Netlify

🌐 my-site · main
⚠️ Build script returned non-zero exit code: 2

Deploy log
🟢 Deploy succeeded · Netlify

🌐 my-site · main
🌍 my-site.example · 🕒 1m 12s

👤 alice

Open site
📥 New form submission · Netlify

📑 contact · my-site.example
✍️ Hello, I would like to know more.
📍 203.0.113.7

👤 Alessandro · [email protected]

Open site

A failed deploy shows the error and a link 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.