# 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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.botpenguin.com/bots/telegram-bot/telegram-chatbot-settings/telegram-triggers.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.