Template

Incident Triage Alert

When your error-monitoring tool (Sentry or a similar one) reports a problem, the bot writes a short AI summary and sends it to your admins in Telegram. No need to check email.

Who it's for: For small tech teams that already use Sentry-style error monitoring and want alerts where people look first. Only contacts tagged admin get the message, never your customers.

  1. ๐Ÿšจ Incident Alert ยท Sentry Payments are failing on checkout: a missing field breaks the order request. Start with the latest release. ๐Ÿ“ฆ Project: shop-backend ๐Ÿ”บ Severity: error ๐Ÿ”„ Status: new ๐Ÿž Issue: TypeError: cannot read 'currency' of undefined ๐Ÿ”— https://sentry.io/issues/4821
  2. ๐Ÿšจ Incident Alert ยท Sentry The same checkout problem was marked resolved after a fix. ๐Ÿ“ฆ Project: shop-backend ๐Ÿ”บ Severity: error ๐Ÿ”„ Status: resolved ๐Ÿž Issue: TypeError: cannot read 'currency' of undefined ๐Ÿ”— https://sentry.io/issues/4821
The alert your admins get in Telegram

How it works

  • Your error-monitoring tool (Sentry, or anything sending the same webhook format) fires a webhook the moment an issue is created, resolved, or changes status
  • The bot reads the real details out of that webhook โ€” project, severity, status, title, and link โ€” with no manual copy-pasting
  • AI turns that into a short, readable summary instead of a wall of raw fields
  • The alert goes out instantly to every contact tagged as an admin in your bot โ€” no chat ID or user ID hardcoded anywhere
  • From there, your team can extend the flow with acknowledgement or escalation steps whenever you're ready

Setup requirements

  • In your monitoring tool (Sentry or equivalent), add a webhook integration pointed at your bot's webhook URL, ending in /webhooks/sentry/issues.
  • On the Contacts page, tag your internal responders with admin โ€” or change the adminAudienceTag variable if your team already uses a different tag.
  • Send a test issue through the webhook and confirm your tagged admins receive the summary with project, severity and a link to the issue.
  • Review the AI prompt so the summary matches how your team actually talks about severity and urgency, then adjust it if needed.

Details

Good to know

  • Built for the standard Sentry issue-webhook shape, so anything else that sends webhooks the same way (an action plus issue details) works too.
  • Delivery is audience-based, not address-based: the bot looks at who's tagged admin (or whatever tag you choose) at the moment the alert fires, so nobody has to touch chat IDs.
  • It alerts on every issue event your monitoring tool sends by default. If you only want alerts for certain events โ€” say, new and regressed issues, not every status change โ€” that's a filter to set on the monitoring side, in your alert rules.
  • This version notifies and summarizes; it doesn't take any remediation action on its own. Acknowledgement, escalation, or auto-creating a ticket are natural next steps to add once the basics are working.

Common questions

  • Should alerts go to contacts tagged admin, or a different tag your team already uses?
  • Which kinds of issue events should actually trigger an alert โ€” every one, or just new and regressed issues?
  • Should this stay notify-only for now, or should a later version also open a ticket in GitHub or Jira automatically?

Keep in mind

  • Keep this for your internal team only โ€” never point it at a customer-facing audience, since incident alerts can include sensitive details.
  • Don't treat an alert as confirmation something is fixed โ€” it only reflects what your monitoring tool reported at that moment.
  • Be mindful of what your monitoring payload includes: if it can carry secrets, tokens or stack traces you don't want circulating, the admin-only audience is your safeguard, so don't broaden who receives these alerts.

The flow behind this bot

This is the whole flow you get. Once you add the template, you can change any message, button or step.

Ready to build on this?

Clone the template into your workspace and edit every message, button and action โ€” nothing is locked.