Skip to main content

Telegram Webhook

Trigger Aisle workflows from Telegram messages and bot interactions. Unlike most webhook integrations, Telegram registration is handled automatically by Aisle - no manual URL configuration needed.

Connector Setup

First, connect Telegram from the Connectors page. You'll need a Telegram Bot API token. To create a bot:

  1. Open Telegram and message @BotFather
  2. Send /newbot and follow the prompts to name your bot
  3. Copy the API token BotFather gives you
  4. Paste it when connecting Telegram in Aisle

Once the connector is active, Aisle automatically registers the webhook URL with Telegram. You do not need to configure anything in Telegram's settings manually.

Setup Instructions

Telegram Webhook Trigger Settings

Step 1: Create the workflow

Create a new workflow and select Telegram as the trigger type.

Step 2: Configure trigger settings

In the workflow's Trigger Settings tab:

  • Secret Token (optional) - a token Aisle sends with every request to Telegram and checks on incoming webhooks. Adds an extra verification layer.
  • Event Types (optional) - filter which Telegram event types trigger this workflow. Leave empty to receive all event types.

Supported event types: message, edited_message, channel_post, edited_channel_post, callback_query, poll_answer, inline_query, my_chat_member, chat_member, chat_join_request

Workflow input variables

VariableDescription
event_typeTelegram event type (message, callback_query, etc.)
chat_idChat or channel ID
user_idSender's user ID
textMessage text or callback query data
message_idMessage ID
callback_dataData from inline keyboard button press
payloadComplete raw Telegram update object

Troubleshooting

Workflow not triggering - Verify the bot has been added to the group or channel you're monitoring. Users must /start the bot in direct message conversations.

Only some events arriving - Check the event type filter in trigger settings. If types are configured, only those types will trigger the workflow.