Skip to main content

​
Setup

1

Create the bot

In Telegram, message @BotFather, send /newbot, follow the prompts, and copy the bot token it gives you.
2

Configure the channel

In the Portal: Agents → (agent) → Channels → Telegram → Set up. Paste the bot token. That is the only field.
3

Enable it

Flip the channel’s enable switch. This is the step that registers the webhook with Telegram — saving the token alone does not.
4

Confirm

The status chip should read Connected. Message the bot and check you get a reply.

​
How inbound works

Noorle registers a webhook with Telegram pointing at https://hooks.noorle.com/webhooks/telegram/{agent_id} and mints a 32-character secret for it. Telegram sends that secret back on every update in the x-telegram-bot-api-secret-token header, and Noorle rejects updates without it. You never configure the URL or the secret. Disabling the channel deletes the webhook registration. The Portal shows the bot’s username on the channel row once connected.

​
Rotating the token

Get a new token from @BotFather, paste it in, save — then re-enable the channel. Changing the credential force-disables it.

​
Limits

​
Cost

Telegram messages are free. The agent’s model and tool usage bills normally.

​
Autonomy

Telegram is an unattended surface. A tool call that would pause for approval is denied. See Autonomy and approvals.

​
Linking users

For the agent to know which Noorle user a Telegram sender is, link their Telegram User ID under Settings → Users → (user) → Linked Platforms. Telegram links immediately — no verification step.

​
Troubleshooting

​
Next