01
Trigger on event
- Listen for a new event
- Parse and validate the payload
- Take an action with the linked tool
Telegram
18 tools available
Telegram is a cloud-based messaging app with a focus on security and speed. Build bots to send messages, manage chats, and interact with users.
Connect Telegram to Definable to automate repetitive tasks, sync data with the rest of your stack, trigger on real-world events. Personas call Telegram's 18 tools directly from chat or scheduled flows. You can wire it into any persona to read, write, and react when an event fires.
Connect Telegram to your stack with Workflow
AI-native automation between Telegram and 53+ other tools — built, run, and self-healed by Workflow.
Common workflows with Telegram
02
Daily summary
- Pull yesterday's activity
- Summarise with the model of your choice
- Send the digest via email or Slack
03
Cross-tool sync
- Read records from one app
- Transform with a persona
- Write the result back via this integration
Telegram actions 18
Every Telegram action below is a callable tool any Definable persona can invoke.
Answer Callback Query
Use this method to send answers to callback queries sent from inline keyboards. The answer will be displayed to the user as a notification at the top of the chat screen or as an alert.
Export Chat Invite Link
Generate a new primary invite link for a chat; any previously generated primary link is revoked. The bot must be an administrator in the chat for this to work and must have the appropriate administrator rights.
Delete Message
Delete a message, including service messages. Limitations: cannot delete messages older than 48 hours in groups, forwarded messages, or content in protected chats (returns 400 'message can’t be deleted'). Bot must have delete/manage rights in the target chat; works reliably only on bot-authored messages in groups. Verify permissions via TELEGRAM_GET_CHAT or TELEGRAM_GET_CHAT_ADMINISTRATORS before calling. On flood control, Telegram returns HTTP 429 with a retry_after field; honor that backoff value.
Edit Message
Edit text messages sent by the bot. Only bot-authored messages can be edited; editing messages from other users will fail. In groups, the bot must have edit permissions.
Forward Message
Forward messages of any kind. Service messages can't be forwarded.
Get Chat Info
Get up to date information about the chat (current name of the user for one-on-one conversations, current username of a user, group or channel, etc.). The bot must be a member of or have access to the target chat; calls fail if the bot was never added, was removed, or is blocked.
Get Chat Administrators
Get a list of administrators in a chat. On success, returns an Array of ChatMember objects containing information about all chat administrators except other bots. Only meaningful for supergroups and channels; private chats yield no useful data. The bot must be a member of the chat; if the bot has admin rights, its own entry will appear in the result, useful for verifying its permissions before moderation actions.
Get Chat History
Get chat history messages via the getUpdates polling method, filtered by chat_id. Returns only updates from the specified chat. Bot can only retrieve messages sent after it joined the chat; missing older messages is expected. Requires no active webhook — a webhook causes HTTP 409 conflict; delete it before using this tool. Empty result arrays (ok=true) indicate no accessible messages, not a failure. Returned message dates are Unix timestamps in UTC seconds.
Get Chat Member
Get a chat member's status/role (including the bot itself) to preflight permissions and troubleshoot 403/empty-history issues. Use before sending messages to verify bot membership and permissions.
Get Chat Members Count
Get the number of members in a chat. The bot must be an administrator in the chat for this to work. Insufficient admin permissions surface as authorization errors, not as a zero or empty count.
Get Bot Info
Get basic information about the bot using the Bot API getMe method. Returns fields like id, username, first_name, and capabilities. If the response returns ok=false, the bot token is invalid or revoked and must be replaced before any other API calls. Bot name, bio, and profile description are read-only via the Bot API; modify them via BotFather.
Get Updates
Use this method to receive incoming updates using long polling. An Array of Update objects is returned. IMPORTANT: This method will not work if an outgoing webhook is set up. Webhooks and getUpdates are mutually exclusive — call deleteWebhook first to switch modes (409 Conflict otherwise). Notes: - Only one method (webhook or polling) can be active at a time - Updates available for up to 24 hours if unclaimed - Recalculate offset after each response to avoid duplicates - Empty result array (ok=true) is valid, meaning no new updates - On HTTP 429, honor the retry_after value; keep polling to ~1 request/second - Only chats with updates since the bot joined or last offset appear in results - Update objects vary by type; always check update.message and update.message.text exist before accessing
Send Document
Send general files (documents) to a Telegram chat using the Bot API. Prefer over TELEGRAM_SEND_PHOTO when original file format or image resolution must be preserved. Rapid sends trigger flood control (HTTP 429 with `retry_after` seconds); limit to ~1 message/second per chat and wait the specified `retry_after` duration before retrying.
Send Location
Send point on the map location to a Telegram chat using the Bot API.
Send Message
Send a text message to a Telegram chat using the Bot API. Bots must be members of target groups/channels with post rights. Rate limit: ~1 msg/sec per chat, ~30 msg/sec globally; exceeding returns 429 with retry_after seconds that must be honored.
Send Photo
Send photos to a Telegram chat using the Bot API. Telegram compresses and re-encodes images; use TELEGRAM_SEND_DOCUMENT to preserve original resolution/format. Each call produces a separate post; no media-group/album support. Returns HTTP 429 with `retry_after` seconds when sending too rapidly.
Send Poll
Send a native poll to a Telegram chat using the Bot API.
Set Bot Commands
Use this method to change the list of the bot's commands. See https://core.telegram.org/bots#commands for more details about bot commands.
Chatwork
Chatwork is a team communication platform featuring group chats, file sharing, and task management, aiming to enhance collaboration and productivity for businesses
Dailybot
DailyBot simplifies team collaboration and tasks with chat-based standups, reminders, polls, and integrations, streamlining workflow automation in popular messaging platforms
Discord
An instant messaging and VoIP social platform.
Discord Bot
Discordbot refers to automated programs on Discord servers, performing tasks like moderation, music playback, and user engagement to enhance community interactions
Microsoft Teams
Microsoft Teams integrates chat, video meetings, and file storage within Microsoft 365, providing virtual collaboration and communication for distributed teams
Missive
Missive is a collaborative email and chat application designed to streamline team communication and task management.
Frequently asked questions
What can I automate with Telegram on Definable?
Anything Telegram exposes through its API. Common team chat workflows on Definable include automate repetitive tasks, sync data with the rest of your stack, trigger on real-world events. Personas can call any of the 18 Telegram tools directly, then chain the result into another integration without you writing code.
How does Telegram authentication work?
Telegram uses API_KEY on Definable. You connect once from the integrations page, scoped to the permissions you choose, and from then on any persona that has the integration enabled can act on your behalf. Tokens are encrypted at rest and rotated automatically.
Is the Telegram integration included in my Definable plan?
Yes — every Definable plan, including Starter, includes access to all 18 Telegram tools. You only need a separate Telegram subscription if Telegram itself charges per seat or per API call.
Is using Telegram through Definable secure?
Every call from a persona to Telegram is logged with the user, persona, prompt, and response. Tokens never leave Definable's secrets vault, scopes are configurable per persona, and you can revoke access at any time from the integration page.
How do I get started with Telegram on Definable?
Sign up for Definable, open the integrations page, find Telegram, and connect via OAuth or API key. You can immediately attach Telegram to any persona and start running workflows. The free Starter plan includes 5,000 credits/month.
What Telegram actions does Definable expose?
Definable exposes all 18 Telegram actions as callable tools — including `Answer Callback Query`, `Export Chat Invite Link`, `Delete Message`, plus 15 more. Each tool gets a typed parameter schema so personas know exactly how to call it.
Ready to automate with Telegram?
Wire it up in minutes. No coding required.