WhatsApp Integration
The WhatsApp integration connects a WhatsApp Business account to an agent via the Meta (Facebook) Cloud API. Once configured, the agent receives and replies to WhatsApp messages from users.
Prerequisites
You need a Meta App with WhatsApp Business API enabled. From the Meta Developer Console you will need:
| Credential | Where to find it |
|---|---|
| Access Token | WhatsApp → API Setup → Temporary or permanent token (EAA...) |
| Phone Number ID | WhatsApp → API Setup → Phone number ID |
| Business Account ID | WhatsApp → API Setup → WhatsApp Business Account ID |
| Webhook Secret | A token you define when configuring the webhook in Meta |
| App Secret | App Settings → Basic → App Secret |
Setup
1. Link the WhatsApp Business account to an agent
In the agent settings, go to the Integrations tab and select WhatsApp. Fill in the credentials above and save.
2. Configure the webhook URL in Meta
Copy the webhook URL shown after saving. In the Meta Developer Console, go to WhatsApp → Configuration and set it as the webhook URL.
Set the Verify Token to the same value you used as the Webhook Secret. Meta will send a verification request — the integration handles this for you.
3. Subscribe to webhook fields
Subscribe to the messages field to receive inbound messages.
Once done, the agent will receive and respond to WhatsApp messages sent to your business number.
Supported Inbound Message Types
The integration accepts the following message types from users: text, image, document, audio, video, location, contacts, interactive, template, sticker, reaction, system.
Workflow Node
The WhatsApp Send workflow node lets a workflow send a message outbound to a WhatsApp number from within an automation.
| Input | Required | Description |
|---|---|---|
phoneNumber | Yes | Recipient in E.164 format (e.g. +1234567890) |
phoneNumberId | Yes | The WhatsApp Business phone number ID |
messageType | Yes | text, image, video, or document |
message | For text | The text content |
accessToken | Yes | WhatsApp Business API access token |
link | For media | Publicly accessible URL of the media or file |
caption | No | Caption displayed under media |
filename | No | Display name for document files |