---
title: Telegram-triggered AI agent
slug: telegram-triggered-ai-agent
image: https://archbee-image-uploads.s3.amazonaws.com/oAyFj2GHlBeBVWF5OAir2/gvw7MCf9IvCEkGouCPFMQ_triggers-1.png
docTags: 
createdAt: 2026-03-19T11:02:28.651Z
---

This Telegram-triggered AI agent scenario watches a Telegram Bot chat for new user messages and the agent replies to them.

![](https://api.archbee.com/api/optimize/oAyFj2GHlBeBVWF5OAir2/g4kPE9MzgIGT_NZtx_RgT_telegram-trigger-ai-agent.png)

## Prerequisites

- A Telegram account&#x20;
- A [Telegram bot](https://core.telegram.org/bots/tutorial)
  - Your token (you'll use this when creating a webhook in Make)

## Step 1. Add a  Watch Updates module

The **Telegram Bot&#x20;**> **Watch Updates** module watches for new messages from your bot channel in Telegram.

To add the **Telegram Bot&#x20;**> **Watch Updates** module:&#x20;

::::WorkflowBlock
:::WorkflowBlockItem
In the Scenario Builder, click the giant plus.&#x20;
:::

:::WorkflowBlockItem
In the app search, search for and click **Telegram Bot**.&#x20;
:::

:::WorkflowBlockItem
Click the **Watch Updates** module.&#x20;
:::

:::WorkflowBlockItem
In **Webhook name**, name your webhook to identify it later.&#x20;
:::

:::WorkflowBlockItem
In **Connection**, click **Add&#x20;**&#x74;o create a new Telegram Bot connection:&#x20;

1. In **Connection name**, name your connection to identify it later.&#x20;
2. In **Token**, paste the token you received when you created the Telegram bot.&#x20;
3. Click **Save**.&#x20;
:::

:::WorkflowBlockItem
Click **Save**.
:::

:::WorkflowBlockItem
Click **Save&#x20;**&#x6F;n the Scenario toolbar.&#x20;
:::
::::

You've now added th&#x65;**&#x20;Telegram Bot** > **Watch Updates&#x20;**&#x6D;odule to your scenario.

## Step 2. Add a route to reply to /start or non-text messages

When you start a conversation with a Telegram Bot, the bot sends a `/start` message to your scenario. As `/start` isn't a unique user message, you don't want it to trigger your agent.&#x20;

Additionally, this example Slack scenario only accepts text, excluding non-text media, such as images, videos, or audio files.&#x20;

Add a route that sends a welcome message in response to `/start`, or requests text-only messages in response to non-text messages.

To add a route:&#x20;

:::::WorkflowBlock
:::WorkflowBlockItem
Click the plus icon next to the **Telegram Bot&#x20;**> **Watch Updates** module.&#x20;
:::

:::WorkflowBlockItem
In the app search, search for and click **Flow control**.&#x20;
:::

:::WorkflowBlockItem
Click **Router**.&#x20;
:::

:::WorkflowBlockItem
Click the 1st route.&#x20;
:::

:::WorkflowBlockItem
In **Label**, enter `Welcome response`.&#x20;
:::

::::WorkflowBlockItem
In **Condition**, configure the fields based on the following:

- Map the `Message: Text` value from the **Telegram Bot** > **Watch Updates** module.&#x20;
- Text operators: Equal to&#x20;
- `/start`

:::hint{type="info"}
Make sure you've selected `Message:Text` here, rather than a similar value, such as`Edited Channel Post: Text`.
:::
::::

:::WorkflowBlockItem
Click **Add OR rule** to add a second condition for non-text messages:

- Map the `Message: Text` value from the **Telegram Bot** > **Watch Updates** module.&#x20;
- Basic operators: Does not exist

::Image[]{src="https://api.archbee.com/api/optimize/oAyFj2GHlBeBVWF5OAir2/4QMBOvbfNFOoV2ZuAhpJe-20260211-161404.png" size="50" width="473" height="425" position="center" darkWidth="473" darkHeight="425" showCaption="false"}
:::

:::WorkflowBlockItem
Click **Save**.&#x20;
:::

:::WorkflowBlockItem
Click **Save&#x20;**&#x6F;n the Scenario  toolbar.&#x20;
:::

:::WorkflowBlockItem
Click the giant plus next to the 1st route.&#x20;
:::

:::WorkflowBlockItem
In the app search, search for and click **Telegram Bot**.&#x20;
:::

:::WorkflowBlockItem
Click the **Send a Text message or a Reply** module.&#x20;
:::

:::WorkflowBlockItem
In **Connection**, select the same Telegram Bot connection that you used earlier.&#x20;
:::

:::WorkflowBlockItem
In **Chat ID**, map the `Message: Chat: ID` value from the **Telegram Bot** > **Watch Updates** module.&#x20;
:::

:::WorkflowBlockItem
In **Text**, enter the following function, so when the message is `/start`, the agent replies "Welcome!", and when it's anything else, the agent replies that it only accepts text.

::Image[]{src="https://api.archbee.com/api/optimize/oAyFj2GHlBeBVWF5OAir2/2zJoKco7KQJ97O3znSEXf-20260211-155138.png" size="50" width="470" height="142" position="center" darkWidth="470" darkHeight="142" showCaption="false"}
:::

:::WorkflowBlockItem
Click **Save**.&#x20;
:::

:::WorkflowBlockItem
Click **Save&#x20;**&#x6F;n the Scenario toolbar.&#x20;
:::

:::WorkflowBlockItem
Test the module:

1. Click **Run once** on the Scenario  toolbar.&#x20;
2. In your Telegram Bot chat, click **Start**. This triggers the correct message as a reply.&#x20;
:::
:::::

You've now added a route that replies to `/start` or non-text messages.&#x20;

## Step 3. Add a route to reply to user messages

To add a route to reply to all other user messages:

::::WorkflowBlock
:::WorkflowBlockItem
Click the 2nd route.&#x20;
:::

:::WorkflowBlockItem
In **Label**, enter "`All other user messages`."&#x20;
:::

:::WorkflowBlockItem
Select **Yes&#x20;**&#x74;o **Set the route as a fallback**.&#x20;
:::

:::WorkflowBlockItem
Click **Save**.&#x20;
:::

:::WorkflowBlockItem
Right-click the **Telegram&#x20;**> **Send a Message or a Reply&#x20;**&#x6D;odule and select **Clone**.&#x20;
:::

:::WorkflowBlockItem
Move the cloned module down until it links to the empty giant plus, then unclick.&#x20;
:::

:::WorkflowBlockItem
Right-click the empty giant plus and select **Delete&#x20;**&#x6D;odule.&#x20;
:::

:::WorkflowBlockItem
In the cloned module, in **Text**, delete the function. Enter "Hello" and map the `Message: Text` value from the **Telegram Bot** > **Watch Updates** module.&#x20;
:::

:::WorkflowBlockItem
Click **Save**.&#x20;
:::

:::WorkflowBlockItem
Click **Save&#x20;**&#x6F;n the Scenario toolbar.&#x20;
:::

:::WorkflowBlockItem
Toggl&#x65;**&#x20;Immediately as data arrives** on the Scenario toolbar to activate the scenario.
:::

:::WorkflowBlockItem
To test the scenario, go back to your Telegram Bot chat and send a message to receive an agent reply.&#x20;
:::
::::

You've now added a route to reply to user messages.&#x20;

## Step 4. Add a Run an agent module

To add the **Run an agent&#x20;**&#x6D;odule to the user message route:&#x20;

:::::WorkflowBlock
:::WorkflowBlockItem
Right-click the 2nd route and select **Add a module**.&#x20;
:::

:::WorkflowBlockItem
In the app search, search for and click **Make AI Agent (New)**.&#x20;
:::

:::WorkflowBlockItem
Click th&#x65;**&#x20;Run an agent&#x20;**&#x6D;odule.&#x20;
:::

:::WorkflowBlockItem
In **Connection**, select an existing AI provider connection from the dropdown or click Add to create a new one.&#x20;
:::

:::WorkflowBlockItem
In **Model**, select a small model. Smaller models react quickly to new data, which is ideal for this chat-based AI agent.&#x20;
:::

:::WorkflowBlockItem
In **Instructions**, describe who the agent is and what it does. For now, enter "You are a friendly agent."
:::

:::WorkflowBlockItem
In **Input**, map the `Message: Text` value from the **Telegram Bot&#x20;**> **Watch Updates** module.&#x20;
:::

::::WorkflowBlockItem
In **Conversation ID**, map the `Message: Chat: ID` value from the **Telegram Bot** > **Watch Updates&#x20;**&#x6D;odule.&#x20;

In Telegram, each user has their own `Message: Chat: ID`. The agent uses it to remember the conversation history with the user and answer any follow-up questions.&#x20;

:::hint{type="info"}
As users chat more with your Telegram-triggered agent, storing all past messages can get expensive. To reduce tokens, you can set this field to start fresh conversations periodically (like using a timestamp), so the agent remembers less.&#x20;
:::
::::
:::::

You've now added the **Make AI Agent (New)&#x20;**> **Run an agent&#x20;**&#x6D;odule to the scenario.&#x20;

## Step 5. Add the agent response&#x20;

To finish this scenario, map the agent response in the **Telegram Bot** > **Send a Text Message or a Reply&#x20;**&#x6D;odule to allow the agent to reply to the user message.&#x20;

To add the agent response:

::::WorkflowBlock
:::WorkflowBlockItem
In the **Telegram Bot&#x20;**> **Send a Text message or a Reply** module on the 2nd route, in **Text**, delete the existing text and map the response value from the **Make AI Agent (New)** > **Run an agent** module.&#x20;
:::

:::WorkflowBlockItem
Click **Save**.&#x20;
:::

:::WorkflowBlockItem
Click **Save&#x20;**&#x6F;n the Scenario toolbar.&#x20;
:::
::::

You've now created a Telegram-triggered AI agent scenario.
