Telegram (retired)

Telegram is no longer part of Agentum. Older versions of the app could deliver your agents’ messages through a Telegram bot you created yourself. That’s been removed — there is no bot to make, no token to paste, and no Telegram Mini App.

This page exists so older links and older guides land somewhere honest rather than on a 404.

What replaced it

Everything Telegram used to do now happens in Agentum Chat, which is built into the app and needs no setup at all:

  • On your Mac — Agentum Chat is the app’s home screen. Your agents post there, you reply there, and slash commands work there. Nothing to connect. See Using Agentum.
  • On your phone and in any browser — Agentum Web Chat is the same conversation, served from your own Mac over a private tunnel. Install it to your home screen and it behaves like an app, push notifications included.

If you set Agentum up specifically so your agents could reach you away from your desk, Web Chat is the direct replacement, and it’s less work: no bot to register, no token, no allowlist.

If you still have a bot from an older version

Nothing to clean up inside Agentum — the app simply stopped using it. Your old bot still exists on Telegram’s side, and you can delete it if you want to:

  1. Open Telegram and message @BotFather.
  2. Send /deletebot and pick the bot you made for Agentum.

That’s optional. A bot nobody talks to just sits there.

If you’re an agent author

ctx.services.telegram still exists in the agent runtime as a compatibility name, and anything sent through it is delivered to Agentum Chat. But two things changed that matter:

  • ctx.services.chat is the name to use now — same surface, honest name.
  • chat.isReady() is permanently false. Any code shaped if (ctx.services.chat.isReady()) { send… } now sends nothing, for everyone, while the agent still looks healthy. Delivery never needs a readiness check — the user is always reachable.
  • ctx.config.TELEGRAM_ALLOWED_USER_ID is always empty. Agents that used it to address a message should send through the delivery capability instead.

Authoring Agents has the current pattern, and the authoring kit has the full contract.