docs

Telegram Notifications

yamlautohealer.yml · notify

1234567workflows:  backend:    # ... issue, repo, agents, validation ...    notify:      telegram:        bot_token: ${TELEGRAM_BOT_TOKEN}        chat_id: ${TELEGRAM_CHAT_ID}

Add TELEGRAM_BOT_TOKEN and TELEGRAM_CHAT_ID to ~/.autohealer/.env. Each workflow needs at least one notifier; you can combine Telegram with Discord.

Setup

Create a bot with @BotFather and copy the bot token into TELEGRAM_BOT_TOKEN.
Add the bot to your group or channel and send a test message.
Resolve the chat ID (channel IDs often start with -100) and set TELEGRAM_CHAT_ID.
Reference both values under notify.telegram in your workflow.

Message types

Autohealer sends HTML-formatted Telegram messages for three run events. Each message includes the workflow name, repository, and issue URL or ID.

Event	Message title	Notes
Run started	Autohealer run started	Issue title in the body
Draft PR created	Autohealer created a draft PR	Includes the pull request URL
Run failed	Autohealer run failed	Reason plus optional detail sections (validation output, review feedback, and similar)

Link previews are disabled. Messages longer than Telegram's limit are truncated. Secrets from your env and config are redacted before messages are sent. Delivery errors are logged but do not fail the run.

Validate

shellsh

autohealer config validate