> ## 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 Disconnected

> The  trigger is a custom Whatsapp provider workflow trigger that fires automatically whenever a WhatsApp number disconnects from your CRM. Use it to build automated alerts, create reconnection tasks, or notify your team instantly when a connection is lost.

***

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

**Instant Alerts** - Know immediately when a WhatsApp number goes offline

**Prevent Missed Messages** - Take action before leads go unanswered

**Multi-Account Monitoring** - Track disconnections across all your sub-accounts

**Automated Recovery** - Trigger notifications to reconnect quickly

**Zero Manual Monitoring** - No need to constantly check connection status

***

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

**Agencies** - Monitor client WhatsApp numbers and alert account managers instantly

**Teams with multiple numbers** - Track which numbers need attention across locations

**High-volume operations** - Ensure 24/7 WhatsApp availability for lead response

**Remote teams** - Get notified when field devices lose connection

***

## 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 Disconnected** from the dropdown
  </Step>

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

<Frame>
  <img src="https://mintcdn.com/goghl-whitelable/d0UJrCwlyc8wzaxE/images/automation/triggers/assets/images/Whatsapp-Disconnect-triggers-5e3a77fbe9cb94011aa870ae7fc24527.png?fit=max&auto=format&n=d0UJrCwlyc8wzaxE&q=85&s=d4d65bff4361561a1317e490c9cfd828" alt="WhatsApp Disconnect Triggers" width="2879" height="1618" data-path="images/automation/triggers/assets/images/Whatsapp-Disconnect-triggers-5e3a77fbe9cb94011aa870ae7fc24527.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 disconnection occurs:

* **Send Email** → Alert admin team
* **Send SMS** → Notify account owner
* **Create Task** → Assign reconnection task
* **Send Slack Message** → Alert your team channel
* **Internal Notification** → Notify CRM users

### 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 Trigger Variables[​](#available-trigger-variables "Direct link to Available Trigger Variables")

When the trigger fires, these variables become available for use in your workflow actions. Insert them by clicking the **tag icon** in any field or typing with double curly braces.

| Variable                                                        | Description                   | Example Value |
| --------------------------------------------------------------- | ----------------------------- | ------------- |
| `{{whatsapp_disconnected_prod.payload.instance.phoneNumber}}`   | The disconnected phone number | `+1234567890` |
| `{{whatsapp_disconnected_prod.payload.instance.instanceIndex}}` | Instance identifier index     | `1`           |
| `{{whatsapp_disconnected_prod.payload.channelType}}`            | The channel type              | `whatsapp`    |
| `{{whatsapp_disconnected_prod.locationId}}`                     | The CRM location ID           | `abc123xyz`   |

***

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

### Use Case 1: Email Alert to Admin[​](#use-case-1-email-alert-to-admin "Direct link to Use Case 1: Email Alert to Admin")

Send an immediate email when any WhatsApp number disconnects.

**Trigger:** WhatsApp Disconnected

**Action:** Send Email

* **To:** [admin@yourcompany.com](mailto:admin@yourcompany.com)
* \*\*Subject:\*\*WhatsApp Disconnected - Action Required
* **Body:**

```text theme={null}
Alert: WhatsApp Number DisconnectedPhone Number: {{whatsapp_disconnected_prod.payload.instance.phoneNumber}}Location ID: {{whatsapp_disconnected_prod.locationId}}This number is now offline. Please reconnect immediately.
```

***

### Use Case 2: Create Reconnection Task[​](#use-case-2-create-reconnection-task "Direct link to Use Case 2: Create Reconnection Task")

Automatically create a high-priority task for your operations team.

**Trigger:** WhatsApp Disconnected

**Action:** Create Task

* \*\*Title:\*\*Reconnect WhatsApp: `{{whatsapp_disconnected_prod.payload.instance.phoneNumber}}`
* **Description:** This WhatsApp number has disconnected. Please reconnect immediately.
* **Assign to:** Operations Manager
* **Priority:** High

***

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

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

* The trigger fires **once per disconnection event**
* Works for both manual disconnections and unexpected disconnections
* Executes immediately when disconnection is detected
* Works across all WhatsApp instances in the location

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

* Set up **multiple notification channels** for critical numbers
* Include the **phone number variable** in all notifications for quick identification
* Create **high-priority tasks** with immediate due dates
* Test your workflow by manually disconnecting a test number

***

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

<AccordionGroup>
  <Accordion title="Will the trigger fire if I manually disconnect WhatsApp?">
    Yes. The trigger fires for all disconnection events-whether manual, network-related, or unexpected.
  </Accordion>

  <Accordion title="Can I use this trigger with multiple actions?">
    Yes. You can add as many actions as needed to a single workflow. They will execute in sequence when the trigger fires.
  </Accordion>

  <Accordion title="Why can't I send a WhatsApp message when this trigger fires?">
    When the trigger fires, your WhatsApp number is already offline and cannot send messages. Use alternative notification methods like email, SMS, or Slack.
  </Accordion>

  <Accordion title="How quickly does the trigger fire after disconnection?">
    The trigger fires immediately when the disconnection is detected-typically within seconds of the actual event.
  </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)