Skip to content

Webhooks and your users' data

The events your bot sends to your systems, and what happens to the projects and history of the people who use it.

Webhooks for the bot#

Subscribe a webhook destination to these events. They are signed exactly like render events; see verifying webhooks.

EventWhen
credits.lowYour balance fell below 200 while the bot worked (at most daily).
credits.exhaustedThe bot refused work because your balance was short (at most every 6 hours).
app.suspendedWe suspended the app; its keys and bot stop.
telegram.end_user.limit_reachedSomeone hit your per-person daily cap (once per person per day).
telegram.end_user.first_seenSomeone used the bot for the first time (once per person).
telegram.end_user.blockedYou blocked someone, in the console or with the API (once per block).

Your users' data#

Each person gets an account that belongs to your app and to nothing else: their projects are invisible to other people using your bot, to other apps, and to your own editor. You see who used the bot and what it cost, not their footage, and you can delete one person's projects and history from the Telegram tab. Deleting the app deletes all of them. What they spent stays on your ledger.