# Telegram Webhooks (/docs/telegram-webhooks)



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 [#common-update-types]

| Event                                                                                                  | When it is sent                                                 |
| ------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------- |
| [`telegram.updateNewMessage`](/docs/telegram-webhooks/telegram.updateNewMessage)                       | A new message arrives in a private chat or basic group          |
| [`telegram.updateNewChannelMessage`](/docs/telegram-webhooks/telegram.updateNewChannelMessage)         | A new message is posted in a channel or supergroup              |
| [`telegram.updateEditMessage`](/docs/telegram-webhooks/telegram.updateEditMessage)                     | A private-chat or basic-group message is edited                 |
| [`telegram.updateEditChannelMessage`](/docs/telegram-webhooks/telegram.updateEditChannelMessage)       | A channel or supergroup message is edited                       |
| [`telegram.updateDeleteMessages`](/docs/telegram-webhooks/telegram.updateDeleteMessages)               | Messages are deleted from a private chat or basic group         |
| [`telegram.updateDeleteChannelMessages`](/docs/telegram-webhooks/telegram.updateDeleteChannelMessages) | Messages are deleted from a channel or supergroup               |
| [`telegram.updateMessageReactions`](/docs/telegram-webhooks/telegram.updateMessageReactions)           | Reactions on a message change                                   |
| [`telegram.updateUserTyping`](/docs/telegram-webhooks/telegram.updateUserTyping)                       | A user starts typing, recording, or uploading in a private chat |
| [`telegram.updateChatUserTyping`](/docs/telegram-webhooks/telegram.updateChatUserTyping)               | A user starts typing, recording, or uploading in a basic group  |
| [`telegram.updateReadHistoryInbox`](/docs/telegram-webhooks/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](/docs/webhooks).