Telegram
Read bounded bot updates and send, edit, or delete Telegram bot messages
Connect Telegram when a project needs a bot to inspect chats, receive a bounded page of updates, or manage messages. Telegram uses a workspace-supplied BotFather token rather than a Swarmz OAuth application. A Swarmz administrator controls whether the connector is visible; each workspace supplies its own bot token.
The connection is shared by a project. Telegram does not provide the published app-user OAuth model used by providers such as Calendly or Twitch.
Before you connect
Create a bot with BotFather, copy its bot token, and add the bot to every chat or channel it needs to access. Grant only the Telegram chat permissions required by the workflow. Never paste the token into chat or project source; enter it in the connector's secure credential form.
Available operations
| Operation | What it does | Limit per minute |
|---|---|---|
get_me | Reads the connected bot identity | 20 |
get_webhook_info | Reads the bot's current webhook status | 20 |
get_chat | Reads one chat's metadata | 30 |
get_updates | Polls one page of up to 100 pending updates without long polling | 20 |
send_message | Sends one bot message | 20 |
edit_message | Edits one bot message | 20 |
delete_message | Deletes one bot message | 20 |
Swarmz can inspect an existing webhook configuration but does not create or change Telegram webhooks in this release. get_updates uses a zero-second timeout, so it does not hold a project request open while waiting for new messages.
Connect Telegram
Ask for a bot workflow, for example: “Use a shared Telegram bot to notify this channel when a support request is created,” or “Poll the bot's next page of updates and show new commands in an admin view.”
Select Add, enter the BotFather token in the secure form, and link the connection to the project. The AI can then call the released Bot API operations. Sending, editing, and deleting messages require AI write approval.
Verify Telegram
- Run
get_meand confirm the bot username. - Add the bot to a test chat, then run
get_chatwith its chat ID or@channelusername. - Send a message, edit it, and delete it while confirming each result in Telegram.
- Send a message to the bot and poll updates. Advance the offset when the app has processed an update.
- Revoke the token in BotFather and confirm the next call asks for a replacement credential.
If reads work but messages fail, check the bot's role and permissions in that chat. Telegram bot privacy mode can also hide group messages that are not commands or direct replies. Rotate a leaked token in BotFather immediately, then replace it in the secure connector form.