Telegram Setup

Moira workflows can send Telegram notifications at specific steps using telegram-notification nodes. This requires a Telegram bot and your chat ID.

1. Open Telegram and search for @BotFather
2. Send /newbot
3. Choose a display name (e.g., “My Moira Notifications”)
4. Choose a username ending in bot (e.g., my_moira_bot)
5. BotFather will reply with a bot token — copy it (format: 123456789:ABCdefGHIjklMNOpqrsTUVwxyz)

Method A — @userinfobot:

1. Search for @userinfobot in Telegram
2. Send any message
3. The bot replies with your user ID — that is your chat ID

Method B — Bot API:

1. Send any message to your new bot
2. Open https://api.telegram.org/bot<TOKEN>/getUpdates in a browser
3. Find "chat":{"id":XXXXXXX} — that number is your chat ID

1. Open Moira and go to Settings
2. Click the Telegram tab
3. Enter your Bot Token in the corresponding field
4. Enter your Chat ID in the corresponding field
5. Make sure Enabled is toggled on
6. Click Save for each setting

On the same Telegram tab in Settings, click Test Notification. You should receive a message from your bot in Telegram.

If you’re using Moira through an MCP client (Claude Code, Claude Desktop), you can start the guided setup workflow:

start({ workflowId: "moira/telegram-setup", parentExecutionId: "none" })

The workflow walks through bot creation, chat ID retrieval, settings configuration, and sends a test notification.

The bot cannot send messages until you send it a message first. Open Telegram, find your bot, send any text (e.g., “hello”), then retry.

The bot token is incorrect or expired. Go to @BotFather, send /mybots, select your bot, and check the token. Generate a new one if needed.

Temporary connectivity issue. Wait a moment and retry. If persistent, check that the Moira server can reach api.telegram.org.

Bots created via @BotFather do not respond to messages by default. They only send notifications when Moira triggers a telegram-notification node. This is expected behavior.

1. Verify you sent a message to the bot (required by Telegram API)
2. Check your chat ID is correct (use @userinfobot to confirm)
3. Verify Telegram is enabled in Settings > Telegram tab
4. Check the bot token has not been revoked