Connect Telegram

Telegram is the channel integration you can configure from Dashboard today. Create a Telegram bot, save its token on the agent detail page, register the webhook, and complete pairing when required.

Start free Read quick start

Preconditions

Before you start, confirm that:

The agent already exists.
The agent status is running. The page only allows token save and webhook registration while the agent is running.
You can access Telegram and create a bot through @BotFather.
You have copied the bot token from @BotFather.

If the agent is still provisioning, wait for status sync before configuring Telegram.

Connect steps

Open Dashboard and go to the target agent detail page.
Find Channels / Telegram.
In Telegram, open @BotFather, create a bot, and copy the bot token.
Return to Hast and paste the token into the Telegram configuration field.
Click Save and register webhook.
After saving, check the webhook status in Dashboard.
If the Telegram bot asks for pairing, enter the code from the bot into the pairing field in Dashboard.
Click Pair to complete binding.

After the token is saved, Hast syncs the Telegram configuration to the running agent and attempts to register the webhook. Telegram messages then enter the runtime through that webhook.

Statuses

You may see these states:

Webhook registered: the token is saved and the webhook is registered. Telegram can send messages to the agent runtime.
Saved (deploy to register webhook): the configuration is saved, but the agent is not running yet. Confirm webhook state again after it runs.
Paired successfully: the pairing code has been submitted and the Telegram bot is bound to the agent.

If you regenerate the bot token or switch to another Telegram bot, save and register the webhook again.

Troubleshooting

Button disabled: confirm that the agent status is running.
Token save failed: copy the token again from @BotFather and remove extra spaces.
Webhook not registered: refresh the agent detail page, confirm the agent is still running, and save again.
Pairing code invalid: confirm the code came from the same Telegram bot and has not expired.
Bot does not respond: confirm the page shows Webhook registered and that you are using the same bot in Telegram.
Still blocked: resync agent status or check the agent detail page for runtime errors.