Telegram Webhooks
Receive raw Telegram updates from connected accounts
Telegram webhooks deliver raw Telegram updates from connected accounts to your HTTPS endpoint. Use them to react to messages, edits, deletions, reactions, typing activity, and other Telegram events without polling.
Configure Telegram events from Settings → API Keys → Webhooks. You can subscribe to specific update types or use telegram.* to receive every supported update, then choose all accessible accounts in the selected workspaces or a fixed set of accounts.
Common update types
| Event | When it is sent |
|---|---|
telegram.updateNewMessage | A new message arrives in a private chat or basic group |
telegram.updateNewChannelMessage | A new message is posted in a channel or supergroup |
telegram.updateEditMessage | A private-chat or basic-group message is edited |
telegram.updateEditChannelMessage | A channel or supergroup message is edited |
telegram.updateDeleteMessages | Messages are deleted from a private chat or basic group |
telegram.updateDeleteChannelMessages | Messages are deleted from a channel or supergroup |
telegram.updateMessageReactions | Reactions on a message change |
telegram.updateUserTyping | A user starts typing, recording, or uploading in a private chat |
telegram.updateChatUserTyping | A user starts typing, recording, or uploading in a basic group |
telegram.updateReadHistoryInbox | Incoming messages are marked as read |
Channel and supergroup activity often has a separate Channel event type. Subscribe to both variants when your integration handles private chats, groups, and channels.
For signature verification, retries, timeouts, and failure handling, see the webhooks guide.
suggestBirthday
Suggest a birthday to another user, see [here »](https://core.telegram.org/api/profile#birthday) for more info on birthdays in the API.
updateAiComposeTones
The list of saved AI composer tones of the current user has changed, and should be refetched using `aicompose.RawGetTonesRequest`.