# Triggers Settings

### What are WhatsApp Triggers:

WhatsApp Triggers on BotPenguin are predefined words or phrases that initiate specific actions within a bot conversation. They serve as powerful entry points for restarting conversations, initiating live chats, managing subscriptions and unsubscriptions, and launching specific bot flows. These triggers are also used to define **Ice Breakers** (starter messages users can tap) and **Command Prompts** (typed phrases that trigger specific workflows or bot behaviors). By simply messaging the bot with a trigger word, users can seamlessly navigate to desired actions, making the chatbot more interactive, intuitive, and automation-friendly.

***

### Section A: How to use WhatsApp Triggers:

1. Sign into you BotPenguin account and select the WhatsApp chatbot.

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

2. Click on "Settings", and go over to the "Triggers" tab.

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

2. You will be presented with 4 cards, each designed for different purposes:
   1. Bot Triggers
   2. Chat Flow Triggers
   3. Chatbot Ice Breaker
   4. Chatbot Commands

***

### Section B: Using Bot Triggers:

You can define the specific words or phrases that act as commands to control key chat actions. These include:

* **Restart Chatflow Triggers**: Set keywords (e.g., “restart”, “begin again”) that reset the conversation and take the user back to the bot’s starting point.
* **Live Chat Triggers**: Assign words (e.g., “agent”, “help”) that instantly connect the user to a human agent for real-time support.
* **Subscribe/Unsubscribe Triggers**: Configure terms (e.g., “start”, “stop”) to automate user opt-ins and opt-outs from marketing flows or broadcasts.

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

***

### Section C: Using Chat Flow Triggers:

Configure keywords to automatically initiate specific chatflows based on user messages. Two flexible matching options are available:

* **Exact Match**: The chatflow is triggered only when the user's message exactly matches the configured keyword (e.g., user types just “pricing”).
* **Contains Match**: The chatflow is triggered if the keyword appears anywhere in the user’s message (e.g., “Can you share pricing details?” triggers the “pricing” flow).

<figure><img src="/files/1Goruv7MLPEFmOVhwxU0" alt=""><figcaption></figcaption></figure>

***

### Section D: Using Chatbot Ice Breaker:

Ice Breakers are ready-made message options that show up when someone opens your WhatsApp chatbot for the first time. When a user taps on one, it can start a specific chatbot flow in BotPenguin.

* Enter the prompt of the Ice Breaker.
* Select the chatflow to be started when the above Ice Breaker is chosen.

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

***

### Section E: Using Chatbot Commands:

Commands let users type a `/` followed by a keyword in the WhatsApp chat to trigger specific bot actions. These commands help users quickly restart a chat, start a live chat, subscribe or unsubscribe, or even trigger a chatflow. They make the chatbot experience faster, smarter, and more interactive—especially for repeat users.

**How to set up Commands:**

* **Enter a Command Name:** This is the word the user will type after `/` (e.g., `/help`).
* **Add a Description:** Give a short explanation of what the command does.
* **Select the Trigger Action:** Choose what action the command should perform—restart chat, start live chat, subscribe/unsubscribe, or run a chatflow.

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

***

### FAQ's

<details>

<summary>Can I assign the same command to multiple actions?</summary>

No, each command can trigger only one action. You’ll need to create separate commands for different functions.

</details>

<details>

<summary>Will users see a list of available Ice Breakers in the chat?</summary>

Yes the users will see a list of all available ice breakers as soon as they open the chat.

</details>

<details>

<summary>Can commands be used in groups or only individual chats?</summary>

Commands are designed for 1:1 user-to-bot interactions and work best in individual WhatsApp sessions for automation and engagement.

</details>

<details>

<summary>What happens if a user types a wrong command?</summary>

If the typed command doesn’t match any configured action, the bot will treat it as a normal message. It won’t trigger anything unless handled in a fallback or default flow.

</details>

***

If everything is correct and you are still unable to move forward, write to us at <support@botpenguin.com>. We will respond back within 48 business hours.


---

# 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/whatsapp-bot/whatapp-chatbot-settings/triggers-settings.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.