Iris.Md logoIris.Md
← All channels

Telegram

stable

Bot API · groups, channels, inline mode.

In
✓
Out
✓
Auth
Bot token
§ Required environment

Env vars

IRIS_TELEGRAM_BOT_TOKEN
Required

Token from @BotFather.

IRIS_TELEGRAM_ALLOWED_USERS
Required

Comma-separated list of Telegram user IDs allowed to talk to the bot.

IRIS_TELEGRAM_WEBHOOK_URL
Optional

Public HTTPS URL if you prefer webhooks over long-polling.

§ Setup

Step by step

  1. 01

    Create the bot

    Talk to @BotFather, run /newbot, follow the prompts, and copy the token it gives you.

  2. 02

    Export the token

    Drop the token into your environment (or ~/.iris/config.toml).

    export IRIS_TELEGRAM_BOT_TOKEN="123456:ABC-DEF..."
export IRIS_TELEGRAM_ALLOWED_USERS="42424242"
  3. 03

    Enable the channel

    Tell Iris.Md to wire up Telegram and reload.

    iris channels enable telegram
iris reload
  4. 04

    Say hello

    Open Telegram, find your bot, send /start. The agent should reply with its capability list.

§ Success

You're done when

  • ✓@BotFather token saved in environment or config.toml
  • ✓Your Telegram user ID is in IRIS_TELEGRAM_ALLOWED_USERS
  • ✓iris channels list shows telegram: ok
  • ✓Sending /start returns a capability list