Telegram

Communication Bot token Windmill docs

Send messages and photos, and manage chats and members, through the Telegram Bot API — from any Windmill script, flow or app.

Set up in 3 steps

1

Create a bot with BotFather

In Telegram, search for BotFather and start a chat. Send /newbot, then follow the prompts to name your bot — BotFather replies with the API token.

2

Add the resource in Windmill

Open Resources, add a resource of type telegram, and paste the token.

3

Run your first script

Fork any script below and send a message to a chat your bot has been added to.

Scripts

Building blocks, if none of the projects above fit. Fork one, run it, or call it as a step inside your own flow.

Submit a script →

Trigger flows from Telegram

Telegram is not only a destination. These inbound paths are supported today.

Bot webhooks

Register a flow's webhook URL with Telegram's setWebhook and every update your bot receives starts a run.

Resource type

The shape of the credential every script on this page expects.

FieldTypeRequiredWhat it is
tokenstringNoBot API token

Questions

Is my token stored on the hub?

Never. It lives only in your own Windmill workspace, encrypted at rest.

How do I find a chat id?

The Bot API has no way to list chats — an id only arrives in an update. Message your bot, then run the list chats script below: it returns the pending updates, each carrying its chat id.

My bot does not see messages in a group

Bots run in privacy mode by default and only receive commands and replies. Send /setprivacy to BotFather to turn it off.