# 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="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2FlABxSCtOoOKjan6zBDZ9%2Fimage.png?alt=media&#x26;token=ded63c11-09e0-419e-a930-fecad40acf9c" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2FVZjg43tBWkmodwadF4Ww%2Fimage.png?alt=media&#x26;token=3d70bf60-af0b-4631-b15b-e76bf2c1c564" 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="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2FRZwaI1SC9qJSOTiUl6pe%2Fimage.png?alt=media&#x26;token=859f51f2-03f2-4cf0-81e5-0db1b9b66731" 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="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2FY1ffaSz6StfkDUBEvMWL%2Fimage.png?alt=media&#x26;token=fba6c645-3313-423c-84be-12ad3884d9cf" 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="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2F9kTVdDJr91FvhHkOYp3j%2Fimage.png?alt=media&#x26;token=f0bf7868-b587-4179-b43c-6faaf4cb5eda" 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="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2FLjwcEP8RObkl66ABnx6t%2Fimage.png?alt=media&#x26;token=211f0ecc-c2e5-43ba-8f0f-75917fd0e3f2" 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.