Telegram tools
See what the Telegram bot can do in a chat, which rights it needs and where Telegram's own limits apply.
Reading a chat
TelegramChatInfodescribes the chat.TelegramGetMembersCountreturns how many members the chat has.TelegramMemberInfodescribes one member.
Telegram's Bot API can return a member count but cannot list every member of a group.
Messages and moderation
TelegramSendposts a message in any chat the bot can reach.TelegramPinMessage,TelegramUnpinMessageandTelegramDeleteMessagemanage messages.TelegramBanMemberandTelegramUnbanMemberremove and restore access.TelegramPromoteMembersets a member's administrator rights. It replaces the rights they had.TelegramSetChatTitleandTelegramSetChatDescriptionchange the chat itself.TelegramApicalls any Bot API method that has no dedicated tool.
The bot needs the matching right in the chat: to pin or delete messages, to manage members or to change chat details. Without it, the call fails with Telegram's error.
Forum topics
TelegramCreateForumTopic, TelegramEditForumTopic and TelegramCloseForumTopic manage topics in a forum group.
What the bot cannot do
- It cannot manage the chat creator.
- It can grant only rights it holds itself.
- It may be limited to deleting other people's messages within the first 48 hours, depending on the chat type.
- Chat titles are limited to 128 characters and descriptions to 255.
- Messages are sent as plain text, long replies are split into 4,000-character messages, and photo captions are limited to 1,024 characters.
TelegramApioutput is cut at 4,000 characters, and that tool should be used only when no dedicated tool covers the task.
Related guides
- Telegram Plugin
- Connect the Telegram bot
- Follow Chetty's replies in Telegram
- Telegram — everyday use in a chat.