# SMS / WhatsApp Triggers

### What is an SMS / WhatsApp Trigger Flow?

An **SMS** / **WhatsApp Trigger Flow** is an automated workflow that starts when a customer sends a message to your business.

Instead of manually responding to every message, you can set up predefined actions that run automatically based on incoming SMS/ WhatsApp message.

This helps you:

* respond instantly
* guide customer conversations
* reduce manual effort

***

### Available SMS / WhatsApp Triggers

From the dashboard, you can create flows using:

#### 1. First Incoming Message

Triggers when a customer sends an SMS/ WhatsApp for the first time.

**Use cases:**

* welcome message
* onboarding response
* asking for basic details

***

#### 2. Incoming Message (Keyword-Based)

Triggers when a message contains a specific keyword.

**Use cases:**

* “BOOK” → send booking link
* “PRICE” → send pricing details
* “HELP” → send support options

***

{% tabs %}
{% tab title="First Incoming Message" %}
Automatically sends a response when a customer messages your business for the first time.

<figure><img src="https://392978341-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZtOBCP9JV8XEWJpUU4t%2Fuploads%2F5TB6x5EZSqnTq03p67j3%2Fimage.png?alt=media&#x26;token=0c912a8d-b83f-4604-a721-e5798b2b33cd" alt="" width="446"><figcaption></figcaption></figure>

1. Select **SMS Triggers** from the dashboard.
2. Then, choose **SMS: First Incoming Message.** This activates the flow when a user sends their first SMS.
3. Click **+ (Add Step)**
4. Select **Action (SMS)**
5. Choose the **SMS template** you created earlier (e.g., welcome message / acknowledgement message)

`Hi {{name}}, thanks for reaching out!`\
`We’ve received your message and will get back to you shortly.`&#x20;

6. Now, click on **Create Workflow**

**Note:** The setup for WhatsApp triggers is similar to SMS triggers, including selecting a trigger, adding an action, and choosing a template.
{% endtab %}

{% tab title=" Incoming Message (Keyword-Based)" %}
Triggers a workflow when a customer sends **“STOP”**, allowing you to automatically unsubscribe them from SMS communication.

<figure><img src="https://392978341-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZtOBCP9JV8XEWJpUU4t%2Fuploads%2Fn0Xma9XNGLzhY6x9ceIv%2Fimage.png?alt=media&#x26;token=fd3fd6d6-f3c3-402b-8c06-1909fa3f6a04" alt="" width="319"><figcaption></figcaption></figure>

1. Select **SMS Triggers** from the dashboard.
2. Choose **SMS: Incoming Message (Keyword)**

<figure><img src="https://392978341-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZtOBCP9JV8XEWJpUU4t%2Fuploads%2FXrzGXy3Tez253DTfZ8jo%2Fimage.png?alt=media&#x26;token=b5fcff47-9a8b-4e51-bac9-9c21ba00e9fc" alt="" width="324"><figcaption></figcaption></figure>

* Select your **SMS number**
* Enter keyword: **STOP** (For example)
* Click **Add Trigger**

3. Click **+ (Add Step)**
4. Select **Action (Subscription).** Set status to **UNSUBSCRIBED**

<figure><img src="https://392978341-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZtOBCP9JV8XEWJpUU4t%2Fuploads%2FqV3GJAkClXgj74wQ3qnZ%2Fimage.png?alt=media&#x26;token=d639757e-67c3-4b14-8c3b-d2c8c4951532" alt="" width="328"><figcaption></figcaption></figure>

5. Now, click on **Create Workflow**

**Note:** The setup for WhatsApp triggers is similar to SMS triggers, including selecting a trigger, adding an action, and choosing a template.
{% endtab %}
{% endtabs %}


---

# 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://docs.mercuri.cx/features/flows/sms-whatsapp-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.