AddThisFeature

Telegram Bot Notifications

Deliver alerts and summaries to a Telegram user, group, or channel through a bot.

moderate Sales & Marketing Tools

What it adds

A Telegram delivery channel that sends selected app notifications to a destination each user has proven they control.

What your agent is told to do

5
  1. 1

    Add Telegram as a destination on the app's existing notification preferences rather than as a standalone feature, so a user's per-event choices, quiet hours, and unsubscribe controls apply to it unchanged.

  2. 2

    Establish the destination by having the user start a conversation with the bot and present a short-lived code the app issued, then bind whatever chat that arrives from. Never let a user type a raw chat identifier into a form.

  3. 3

    Keep the bot credential encrypted at rest and resolved only on the server at send time. It must not appear in configuration exposed to the browser, in logs, or in error reports.

  4. 4

    Send from the app's background-job system with retries and backoff, and treat the throttling response as a signal to wait rather than to keep hammering.

  5. 5

    Escape formatting markup in every value interpolated into a message. Content the app renders safely in HTML will break or misformat a Telegram message if it is passed through untouched.

Edge cases it handles

8
  • A manually entered chat identifier can point at a stranger's conversation. Bind the destination only from a chat the user demonstrably initiated with a code the app issued and that expires quickly.
  • Formatting markup in user-supplied text will either corrupt the message or cause the send to be rejected outright. Escape it for whichever formatting mode the message uses, and be consistent about which mode that is.
  • A bot removed from a group, blocked by a user, or stripped of posting permission will fail permanently. Recognise these as terminal, stop retrying, mark the destination inactive, and prompt the user to reconnect.
  • A send that times out may have succeeded. Carry a stable identifier per notification and record what was delivered, so a retry does not send the same alert a second time.
  • The bot token is a full account credential. It must be encrypted at rest, redacted from every log and stack trace, and rotatable without redeploying.
  • Messages have a length ceiling. Truncate long summaries at a readable boundary and link back into the app rather than sending a rejected payload.
  • A group destination means everyone in that group sees the notification. Warn the user before binding a group, and never route personal or account-sensitive content to one.
  • When Telegram is unreachable, the triggering action must still complete and the user must be able to see in the app that the notification is pending or failed.

Definition of done

8
  • A destination can only be bound from a chat the user initiated with a short-lived code.
  • Telegram appears as a destination inside the existing notification preferences, honouring per-event choices.
  • Bot credentials are encrypted at rest and absent from logs and client assets.
  • Interpolated user content cannot break message formatting or cause a rejected send.
  • Blocked bots, removed group memberships, and missing permissions mark the destination inactive without endless retries.
  • Retried jobs never deliver the same notification twice.
  • The feature matches the existing design system.
  • No existing functionality is broken.

Related features

How it works

  1. 1

    Copy the link

    Grab the Markdown instruction URL for this feature.

  2. 2

    Give it to your AI

    Paste it into Claude Code, Cursor, v0, Lovable — whatever you build with.

  3. 3

    It inspects, then implements

    Your agent reads your existing app first, then adds the feature to fit it.

Works with your stack

These instructions are written to adapt. They tell the agent to detect your framework, match your existing design system, and reuse what you already have — rather than assuming a particular stack.

Need it tighter than that? Customize the feature and tell it exactly what you're running.