Skip to content

Telegram

Link your Telegram account once and Telegram becomes another place to use Donkit. You can chat with Donkit and with your agents there, get notifications with answer buttons, give a published agent its own Telegram bot, and let an agent work as a secretary in your personal Telegram chats (Telegram Business). It is in Beta.

Telegram works wherever the platform has it switched on. It is not available on installations without internet access.

Linking Telegram

Link once from Account → Telegram on the web, or from the matching Telegram screen of the Android, iPhone, iPad and Mac apps. The link uses Log In With Telegram: the app opens Telegram, you confirm there, and you come back to the app.

  • Only an existing account can link. There is no sign-up through Telegram. If someone who has not linked Telegram writes to a bot, the bot answers with a button to the Donkit app, where they sign up or sign in and then link. After linking, the page offers Back to Telegram.
  • One Telegram account, one Donkit account. Linking again replaces the older link on either side.
  • The bot can write to you first. Linking lets the Donkit bot message you, which is what notifications need.
  • One link for everything. The same link also serves the support bot.
  • Unlink. Unlink Telegram on the same page (web and apps) stops all Telegram delivery and chat for you. It does not delete your Business data; disconnecting Business does (see Privacy and retention).
  • Blocking a bot. If you block a bot in Telegram, delivery to you stops. It resumes when you write to the bot again.

Chat with Donkit

Open the Donkit bot from Account → Telegram. Its main chat is your Direct when Direct is available to you, and otherwise one rolling conversation with Donkit. If you lose access to Direct, new Telegram messages go to a rolling conversation. Where topics are on for the bot in Telegram, each topic is a separate conversation; where they are off there is one rolling conversation, and /new starts another.

These are ordinary conversations: you see them on the web and in the apps too. Messages you write on the web are not copied into Telegram. Telegram shows the replies to what you asked there, plus your notifications.

Commands

Command What it does
/new Starts a new conversation.
/agent Shows your agents, then the ones shared with you, to pick one. One agent at a time, as with a single pin on the web.
/agent off Goes back to Donkit.
/stop Stops the answer in progress, like the stop button.
/account Chooses whether new conversations belong to your personal account or to an organization. Personal is the default.
/settings Gives you a link to your settings.

What you can send

  • Text.
  • Voice messages and video notes. They are transcribed with your dictation allowance, and the audio is not kept.
  • Photos and files up to 20 MB. For larger ones the bot tells you to upload on the web.

What comes back. While the agent works, the reply streams as a live draft, with a short status line for the tools it uses (never their arguments) and a stop button. The final answer arrives as one message, split when it is long. Files the agent produces arrive as files up to 50 MB, and as a link when larger. A canvas arrives as a link. If you write while the agent is still working, your message is taken in as an interjection, as on the web.

Questions and cards. Cards with a closed set of options (choose, confirm) get buttons in Telegram. Anything else, such as secrets, connecting an account, or a proposal to create an agent or a project, shows Continue on Donkit, because secrets are never typed into Telegram.

Credits are used as in any chat. When they run out the bot says so and offers a top-up link. If an agent is paused or you have no access to it, the bot explains briefly.

Notifications and buttons

Telegram is a channel in your notification table. By default it is on wherever push is on, except for announcements, which are off. A reply, a question or a decision is not sent to Telegram while that chat is open in one of your apps.

What happened What arrives in Telegram
An agent's reply is ready The reply text, with Open.
An agent asks you something, a project decision or a task is waiting for you The answer buttons, plus Reply.
A workflow run failed Open run.
Your credits ran out Top up.

A pressed button is replaced by a disabled one that shows your answer. If you press an old button, Telegram tells you it is already answered.

If you answer a notification with a Telegram reply, your message goes into that notification's conversation and the agent continues there. A reply to a decision notification answers the decision.

Telegram also carries other things you set up:

  • Tasks can be delivered to Telegram.
  • A workflow Notify step can send to you through the Donkit bot.
  • An agent can message you in Telegram. It can write only to you, never to an arbitrary chat.

If a Telegram message cannot reach you because you blocked the bot, the events that have push still reach you by push.

Agent bots

An author can give a published agent its own Telegram bot, so people use the agent from Telegram. The Telegram panel sits in the agent's publishing settings: on the web next to API, in the publish group of the build menu on phones, and next to API in the Mac app.

Create a Telegram bot (recommended). The author needs a linked Telegram. Pressing the button opens Telegram, the author confirms the new bot in one step, and the platform sets it up: it holds the bot's token, and takes the name, description, photo and commands from the agent. The author owns the bot in Telegram and can Rotate token in the panel.

Use your own bot. Paste a token from @BotFather. This is the secondary path; creating a bot is preferred.

Each agent has one bot. Disconnect bot removes it from the agent. A bot that was created through the panel stays in the author's Telegram account and can be deleted there.

Some switches exist only in @BotFather and cannot be turned on from the app: topics in private chats, and Business mode. The panel shows which of them are off and the one step to turn them on.

For people who use the agent. Every message goes through the same checks as on the web: a linked Telegram, the agent's access and permissions, and the agent's consent screen. If something is missing, the bot sends a button to the agent's published page, which handles linking and consent and then offers Back to Telegram. For an agent behind a password, the password is entered on that web page.

A bot created through the panel for a private agent can be restricted to the owner and the people who have access, and Telegram is kept in step with the agent's permissions. That works for up to 10 people. With more, the bot stays open and the agent's own checks decide on every message.

The agent's usual payer pays (the owner, the user, or a sponsor). Groups and channels are not supported.

Business

Telegram Business lets an agent read your personal Telegram chats and reply in them as a secretary. You need Telegram's Business features on your Telegram account, and a bot set up for it in @BotFather (Business mode).

Two kinds of bot can serve it:

  • The Donkit Business bot. Donkit handles it in your personal account.
  • A custom agent's own bot. That agent handles it, in your own space with it.

Telegram allows one Business bot per Telegram account. In Telegram, open Settings → Business → Chatbots and add the bot; the connection then appears in the Telegram Business section of Account → Telegram.

Consent comes first. If your Telegram is not linked, or you have not agreed yet, the connection does nothing: no message is stored or read, and the bot sends you a button to the consent page. The page tells you:

  • which agent and which author;
  • which AI models and providers read your messages;
  • what risky abilities the agent has (outside services, shared tables, MCP servers, webhooks);
  • that messages are kept 30 days;
  • that everything sent in your name is recorded in a journal;
  • how to disconnect.

Consent is tied to what the agent can do. If the agent changes so that more can leave, the connection pauses until you agree again.

Telegram asks you to give the bot rights to reply, to read, and to delete messages it sent. The profile, gift, star and story rights are never used; leave them off.

Three modes, chosen per chat. Open the chat list of a connection in Account → Telegram and pick a mode for each chat.

Mode What the agent does
Read only (the default) Messages are only stored. The agent can look through them when you ask, and a scheduled task can summarize them, for example every morning.
Drafts After 20 seconds of quiet in that chat, the agent prepares a reply. You get a card with the contact, the last messages and the draft, with Send, Edit and Skip. Edit sends your own reply text instead. Nothing goes out until you press.
Autopilot The agent replies by itself. Only for chats you switch on one by one, with a confirmation. Each reply is followed by a digest line with Undo, within the time Telegram allows for deleting.

Automatic replies are limited to 50 a day in one chat and 300 a day across a connection, since each one is billed to you. Past a limit, the agent stops preparing replies for a while and tells you once; messages are still stored.

Telegram lets a bot reply only in a chat where the contact wrote in the last 24 hours. An older draft shows as expired and cannot be sent, and autopilot never replies outside that window. There is no live streaming in these chats; the agent shows "typing".

While Direct reads your chats. When you turn on Telegram in the list of what Direct reads, Direct prepares the replies to the chats of the Donkit Business bot instead of the agent. In Account → Telegram the chat list then says that Direct reads these chats and offers two choices instead of three: Wait for my yes (the card in Direct, and the same card in the chat with the bot, wait for your press; a chat that was in Read only shows as this) and Always answer (replies go out by themselves; choosing it asks first, in Direct's words). The limits, the 24-hour window and the digest with Undo are the same. A custom agent's own bot is not affected, and with Telegram turned off in Direct the three modes work as above. The chat list of a connection in the Android, iPhone, iPad and Mac apps offers the same two choices and says the same.

The agent can list your chats, read a chat, search the messages stored for you, and reply according to the chat's mode. In Read only a reply is refused.

When the agent prepares a reply to a contact on its own (in Drafts or Autopilot), it treats the contact's messages as someone else's words. It can still look things up in its memory of you, your profile, its knowledge and your files. It cannot search or open the web, read your other Telegram chats, use any of your connected accounts, save anything to memory, your profile, knowledge or files, run code, ask other agents, send email or Telegram messages, or create tasks, workflows, projects or agents.

Privacy and retention

  • 30 days. Business messages are kept for exactly 30 days, then deleted. This is not configurable.
  • Encrypted, kept apart. Messages are stored encrypted, and the key is kept apart from the platform's other secrets.
  • Only for you. They are used to provide the service to you and are shown only to you. No author and no organization admin can see them. They are not used to train models or to build datasets. They are read only by the models and providers named on the consent page.
  • A journal of what was sent. The Journal of a connection lists every message the agent sent in your name: when, which chat, the text and the mode.
  • Deleting. Disconnect on a connection, or Delete my Telegram data, deletes that connection's messages, chats and per-contact conversations at once. Deleting your account removes them too. A message deleted in Telegram is deleted here too, together with the per-contact conversation that may have quoted it.
  • Where the conversations are. Per-contact conversations live in the Telegram Business section, not in your chat list.
  • Bots. Each bot has a privacy policy set in Telegram.

Telegram itself still holds the originals of your chats.

What the author sees

For agent bots and for Business, the author sees usage counts like for any other way of using the agent: for example how many people connected and how many messages were handled. The author never sees the content of messages and never sees contact names.

When the agent prepares a reply to a contact, the Security page of the agent's account lists its guard decisions like any others, but nothing of what the agent passed to its tools is stored with them, and an entry does not say which conversation, file or record it was about. Such a reply never asks for an approval: an action that would need one is refused. It is also never sent to a detector service an organization connected to its guard: if the organization marked that service as required, the action is refused instead.

See What the author of an agent can see for the general picture.