> For the complete documentation index, see [llms.txt](https://help.botpenguin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.botpenguin.com/bots/telegram-bot/telegram-chatbot-settings/telegram-triggers.md).

# Telegram Triggers

## Telegram Bot Settings – Triggers

The **Triggers** section in Telegram Bot Settings allows you to control **when and how your bot responds** to user messages.\
Triggers help route conversations to the correct **chat flows**, **restart conversations**, or **hand over chats to live agents**.

***

### Accessing Trigger Settings

To open Trigger Settings:

1. Log in to your BotPenguin Dashboard
2. Select your Telegram Bot
3. Go to Settings
4. Click on the **Triggers** tab

<figure><img src="/files/ODa01PFdtZ8Xh6TZrW6n" alt=""><figcaption></figcaption></figure>

You will land on the **Customize Your Bot’s Trigger Settings** page.

***

### Triggers Overview

Trigger settings are divided into three main sections:

1. **Bot Triggers**
2. **Chat Flow Triggers**
3. **Chatbot Commands**

Each section serves a specific purpose in managing user interactions.

***

### Bot Triggers

Bot Triggers are **global triggers** that apply across your Telegram bot.

#### Restart Chat Flow Triggers

These triggers restart the bot conversation from the beginning.

**Use case examples:**

* User types `restart`
* User types `start over`
* User wants to reset the conversation

When triggered, the bot restarts the default chat flow.

<figure><img src="/files/OxXfDYVT8PUb0yKuWz7W" alt=""><figcaption></figcaption></figure>

***

#### Live Chat Triggers

These triggers transfer the conversation to a **live agent**.

**Use case examples:**

* User types `agent`
* User types `support`
* User requests human assistance

Once triggered, the conversation is handed over to live chat (if enabled).

> ⚠️ *Both Restart and Live Chat triggers are mandatory fields.*

***

### Chat Flow Triggers

Chat Flow Triggers allow you to assign **specific keywords** to **specific chat flows**.

#### Key Features

* Trigger different chat flows based on user input
* Route users to the correct flow instantly
* Supports keyword-based matching

#### How to Add Chat Flow Triggers

1. Click **Add Trigger Keywords**
   1. Click on Add trigger keyword
   2. Enter flow trigger keyword.
   3. Select matching method.
   4. Select the flow from the dropdown.
   5. Click on Add button to add the trigger.

<figure><img src="/files/2dXHE5i1cNvZmNczeAY6" alt=""><figcaption></figcaption></figure>

If no triggers are added, the system will display:\
\&#xNAN;**“No Flow Triggers Found”**

***

### Chatbot Commands

Chatbot Commands let users trigger actions using **slash commands** (Telegram-style commands).

#### Examples of Commands

* `/start`
* `/help`
* `/menu`
* `/pricing`

#### How to Add a Chatbot Command

1. Click **Add Command**
2. Enter the command keyword
3. Add the Chatbot Command Description.
4. Assign the next action or chat flow
5. Save the command

If no commands are configured, you will see:\
\&#xNAN;**“No Chatbot Commands Found”**

<figure><img src="/files/hvG7JYa793WJjwKcvUyf" alt=""><figcaption></figcaption></figure>

***

### Search & Management

* Use **Search by Keyword** to quickly find triggers or commands
* Edit or remove triggers anytime from this screen
* Changes apply immediately after saving

***

### Best Practices

* Keep trigger keywords **simple and intuitive**
* Avoid overlapping keywords across multiple flows
* Always configure **Restart** and **Live Chat** triggers
* Use Chatbot Commands for power users and quick navigation

***

### Notes & Limitations

* Triggers work based on keyword matching
* Telegram platform behavior applies
* Case sensitivity depends on configuration
* Internet connection is required for trigger execution