> ## Documentation Index
> Fetch the complete documentation index at: https://help.messagesync.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# WhatsApp Inbound

> The  trigger is a custom Whatsapp provider workflow trigger that fires automatically whenever an  on your connected number. Use it to send instant auto-replies, route conversations to the right team, or notify staff the moment a customer reaches out.

***

## Key Benefits[​](#key-benefits "Direct link to Key Benefits")

**Instant Response** - React the moment a customer's message lands

**Smart Routing** - Direct conversations to the right rep or team

**Never Miss a Lead** - Automate follow-up so no inbound message goes cold

**Filtered Automation** - Trigger only on messages that match your criteria

**Zero Manual Monitoring** - No need to watch the inbox around the clock

***

## Who Should Use It[​](#who-should-use-it "Direct link to Who Should Use It")

**Sales teams** - Auto-respond and assign new conversations instantly

**Support teams** - Acknowledge inbound messages and create tickets automatically

**Agencies** - Standardize inbound message handling across client sub-accounts

**High-volume operations** - Keep response times fast even at scale

***

## Requirements[​](#requirements "Direct link to Requirements")

Before using this trigger, update your Whatsapp provider app to the latest version:

<Steps>
  <Step>
    Go to **App Marketplace → Installed Apps**
  </Step>

  <Step>
    Find **Whatsapp provider**
  </Step>

  <Step>
    Click **Update** if available
  </Step>
</Steps>

***

## How to Set Up[​](#how-to-set-up "Direct link to How to Set Up")

### Step 1: Create a New Workflow[​](#step-1-create-a-new-workflow "Direct link to Step 1: Create a New Workflow")

<Steps>
  <Step>
    Go to **Automation → Workflows**
  </Step>

  <Step>
    Click **Create Workflow** or **+ Add**
  </Step>

  <Step>
    Select **Start from Scratch**
  </Step>
</Steps>

### Step 2: Add the Trigger[​](#step-2-add-the-trigger "Direct link to Step 2: Add the Trigger")

<Steps>
  <Step>
    Click **Add New Trigger**
  </Step>

  <Step>
    Switch to the **Apps** tab (not the default triggers)
  </Step>

  <Step>
    Find and click the **Whatsapp provider** app icon
  </Step>

  <Step>
    Select **WhatsApp Inbound** from the dropdown
  </Step>

  <Step>
    (Optional) Add **Filters** to narrow when the trigger fires
  </Step>

  <Step>
    Click **Save trigger**
  </Step>
</Steps>

<Frame>
  <img src="https://mintcdn.com/goghl-whitelable/d0UJrCwlyc8wzaxE/images/automation/triggers/assets/images/whatsapp-inbound-trigger-66aff58a089ff2dd9d05eeb85bf3f43d.png?fit=max&auto=format&n=d0UJrCwlyc8wzaxE&q=85&s=95443ec894060d94b2a92f160363c14c" alt="WhatsApp Inbound Trigger" width="2860" height="1522" data-path="images/automation/triggers/assets/images/whatsapp-inbound-trigger-66aff58a089ff2dd9d05eeb85bf3f43d.png" />
</Frame>

### Step 3: Add Your Actions[​](#step-3-add-your-actions "Direct link to Step 3: Add Your Actions")

Add any actions you want to execute when an inbound WhatsApp message is received:

* **Send Email** → Notify the assigned rep
* **Send Internal Notification** → Alert your team inside the CRM
* **Create Task** → Queue a follow-up
* **Add to Workflow / Pipeline** → Move the contact through your funnel

### Step 4: Save and Publish[​](#step-4-save-and-publish "Direct link to Step 4: Save and Publish")

<Steps>
  <Step>
    Review your workflow
  </Step>

  <Step>
    Click **Save**
  </Step>

  <Step>
    Toggle workflow from **Draft** to **Published**
  </Step>
</Steps>

***

## Available Filters[​](#available-filters "Direct link to Available Filters")

Use filters to control exactly which inbound WhatsApp messages start the workflow. Each filter can be paired with an operator (equals, contains, etc.).

| Filter                | Description                                                   |
| --------------------- | ------------------------------------------------------------- |
| Contact ID            | The unique ID of the contact who sent the message             |
| Location ID           | The CRM location (sub-account) where the message was received |
| Message               | The text content of the inbound message                       |
| Receiver Name         | The name of the account that received the message             |
| Receiver Phone Number | The number that received the message (your WhatsApp number)   |
| Sender Name           | The name of the contact who sent the message                  |
| Sender Phone Number   | The phone number of the contact who sent the message          |

***

## Example Use Cases[​](#example-use-cases "Direct link to Example Use Cases")

### Use Case 1: Instant Auto-Reply[​](#use-case-1-instant-auto-reply "Direct link to Use Case 1: Instant Auto-Reply")

Acknowledge every inbound message immediately.

**Trigger:** WhatsApp Inbound

**Action:** Send a reply confirming you received the message and will respond shortly.

***

### Use Case 2: Route by Keyword[​](#use-case-2-route-by-keyword "Direct link to Use Case 2: Route by Keyword")

Send leads to the right team based on what they say.

**Trigger:** WhatsApp Inbound **Filter:** Message **contains** "pricing"

**Action:** Notify the sales team and create a high-priority follow-up task.

***

## Important Notes[​](#important-notes "Direct link to Important Notes")

### Technical Details[​](#technical-details "Direct link to Technical Details")

* The trigger fires **once per inbound message**
* Filters are optional - leave them blank to fire on every inbound WhatsApp message
* Executes immediately when the message is received

### Best Practices[​](#best-practices "Direct link to Best Practices")

* Use the **Message** filter to build keyword-based routing flows
* Use the **Location ID** filter when managing multiple sub-accounts
* Test your workflow by sending a message to your connected number

***

## FAQs[​](#faqs "Direct link to FAQs")

<AccordionGroup>
  <Accordion title="Do I have to add filters?">
    No. Filters are optional. Without them, the trigger fires on every inbound WhatsApp message.
  </Accordion>

  <Accordion title="Can I trigger different workflows for different messages?">
    Yes. Use the **Message** or **Sender** filters to build separate workflows for different conditions.
  </Accordion>
</AccordionGroup>

***

## Support[​](#support "Direct link to Support")

If you need help with the setup or onboarding:

* Email: [**support@messagesync.ai**](mailto:support@messagesync.ai)