Telegram
MESSAGING · MESSAGING
Conversations read and replied to from the Telegram account they pair.
Acts as the person, not as itself
Each user connects their own account. Every call carries both identities — the agent and the person it is acting for — so the agent can never reach past what that individual can already do.
Credentials never touch the agent
Tokens live in the vault and attach server-side at call time. The agent holds a session, not a secret, and revoking access does not mean rotating a key.
Every call on the record
Who asked, which agent acted, which action ran, and the verdict that let it through — one audit trail across every integration, not one per vendor.
What an agent can do
Each action is granted on its own. An agent allowed to read is not thereby allowed to write, and the scope beside each row is what the acting user must have connected for it to run at all.
telegram_delete_chats_by_chat_idWRITEDelete a chat. DELETE /api/v1/chats/{chat_id}. Delete a chat. Supported for WhatsApp and LinkedIn only.
telegram_delete_messages_by_message_idWRITEDelete a message. DELETE /api/v1/messages/{message_id}. Delete a message. Supported for WhatsApp and LinkedIn only. For LinkedIn, it is only possible within the first 60 minutes after the message is sent.
telegram_get_chat_attendeesREADList all attendees. GET /api/v1/chat_attendees. Returns a list of messaging attendees. Some optional parameters are available to filter the results.
telegram_get_chat_attendees_by_attendee_id_chatsREADList all 1to1 chats for a given attendee. GET /api/v1/chat_attendees/{attendee_id}/chats. Returns a list of chats where a given attendee is involved.
telegram_get_chat_attendees_by_attendee_id_syncREADResynchronize chats for a given attendee. GET /api/v1/chat_attendees/{attendee_id}/sync. Starts or monitors the synchronization of all chats for a given attendee.
telegram_get_chat_attendees_by_idREADRetrieve an attendee. GET /api/v1/chat_attendees/{id}. The id of the wanted attendee.
telegram_get_chat_attendees_by_id_pictureREADDownload a chat attendee picture. GET /api/v1/chat_attendees/{id}/picture. Download the profile picture of an attendee or picture of a group chat.
telegram_get_chat_attendees_by_sender_id_messagesREADList all messages for a given attendee. GET /api/v1/chat_attendees/{sender_id}/messages. Returns a list of messages where a given attendee is involved.
telegram_get_chatsREADList all chats. GET /api/v1/chats. Returns a list of chats. Some optional parameters are available to filter the results.
telegram_get_chats_by_chat_idREADRetrieve a chat. GET /api/v1/chats/{chat_id}. Retrieve the details of a chat.
telegram_get_chats_by_chat_id_attendeesREADList all attendees from a chat. GET /api/v1/chats/{chat_id}/attendees. Returns a list of messaging attendees related to a given chat. Some optional parameters are available to filter the results.
telegram_get_chats_by_chat_id_messagesREADList all messages from a chat. GET /api/v1/chats/{chat_id}/messages. Returns a list of messages related to the given chat. Some parameters are available to filter the results.
telegram_get_chats_by_chat_id_syncREADSynchronize a conversation from its beginning. GET /api/v1/chats/{chat_id}/sync. This route can be used both to initiate a synchronization process and to monitor its status via regular polling.
telegram_get_messagesREADList all messages. GET /api/v1/messages. Returns a list of messages. Some optional parameters are available to filter the results.
telegram_get_messages_by_message_idREADRetrieve a message. GET /api/v1/messages/{message_id}. Retrieve the details of a message.
telegram_get_messages_by_message_id_attachments_by_attachment_idREADRetrieve an attachment from a message. GET /api/v1/messages/{message_id}/attachments/{attachment_id}. Retrieve one of the attachment linked to a message. The provider answers this route with the file's raw bytes. This connection has no artifact transport, so the tool returns the file's content type and byte length instead of its contents.
telegram_patch_chats_by_chat_idWRITEPerform an action on a given chat. PATCH /api/v1/chats/{chat_id}. Perform an action like changing the read status, muting the chat, retrieving a group invite link, etc.
telegram_patch_messages_by_message_idWRITEEdit a message. PATCH /api/v1/messages/{message_id}. Edit a message. Supported for WhatsApp and LinkedIn Classic only. WhatsApp may reject edits after an indicative 15-minute window following the original send time. LinkedIn Classic edits are only possible within the first 60 minutes after the message is sent.
telegram_post_chatsWRITEStart a new chat. POST /api/v1/chats. IRREVERSIBLE OUTWARD ACTION: this is visible to someone other than the account owner and cannot be undone through this API. Start a new conversation with one or more attendee. Attachments are not supported on this connection: the messaging provider accepts this operation only as multipart/form-data, and its file properties (attachments, linkedin.follow_up.attachments, video_message, voice_message) are omitted from this tool's schema because unbounded bytes must not enter a tool argument. Every text field is available and is sent as a multipart text part.
telegram_post_chats_by_chat_id_messagesWRITESend a message in a chat. POST /api/v1/chats/{chat_id}/messages. IRREVERSIBLE OUTWARD ACTION: this is visible to someone other than the account owner and cannot be undone through this API. Send a message to the given chat with the possibility to link some attachments. Attachments are not supported on this connection: the messaging provider accepts this operation only as multipart/form-data, and its file properties (attachments, video_message, voice_message) are omitted from this tool's schema because unbounded bytes must not enter a tool argument. Every text field is available and is sent as a multipart text part.
telegram_post_messages_by_message_id_forwardWRITEForward a message. POST /api/v1/messages/{message_id}/forward. IRREVERSIBLE OUTWARD ACTION: this is visible to someone other than the account owner and cannot be undone through this API. Forward a message to a chat. (Whatsapp only)
telegram_post_messages_by_message_id_reactionWRITEAdd a reaction to a message. POST /api/v1/messages/{message_id}/reaction. IRREVERSIBLE OUTWARD ACTION: this is visible to someone other than the account owner and cannot be undone through this API. Add a reaction to a message. (Whatsapp, LinkedIn, Telegram, Instagram)
Often connected alongside
Put Telegram behind one governed endpoint.
Same permissions, same audit trail, whatever else you connect next.