Aleph

Telegram

Connect a Telegram bot to an agent for direct messages, group conversations, files, and targeted schedule delivery.

Connect a bot

  1. Use BotFather and /newbot to create a bot.
  2. Copy the HTTP API token.
  3. In the wizard's optional Channels step or the saved agent's Channels page, choose Connect Telegram.
  4. Paste the token and complete the connection.

Aleph stores the token in the agent scope's encrypted Vault and registers a webhook when a public webhook base URL is configured.

Direct messages and groups

Direct messages use pairing by default. Approve the first user's code from the Channels page.

In groups, requireMention defaults to true. Normal messages are buffered as ambient context; an @mention, command, or reply to the bot triggers a turn and ingests unseen context once. Disable bot privacy with BotFather and re-add the bot if you want it to receive ordinary group messages.

Aleph keeps one conversation per Telegram chat ID.

Local development

Production uses HTTPS webhooks. Local operators can set CHANNEL_DEV_POLLING=true instead of exposing a tunnel. This is deployment configuration, not bundle configuration.