WhatsApp Trigger

The WhatsApp Trigger starts an orchestration when an incoming WhatsApp message is received on a connected number.

Use Cases

Build AI-powered WhatsApp bots using AgentVerse
Automate customer support workflows triggered by WhatsApp messages
Route incoming messages based on content or sender
Integrate WhatsApp as an input channel for AI agents

Credentials

This node requires a WhatsApp credential configured with your WhatsApp Business API access token and phone number ID. To create a credential:

Go to Settings → Credentials → New Credential
Select WhatsApp
Enter your WhatsApp Business API access token and phone number ID

Node Reference

Parameters

Parameter	Type	Description
Credential	Credential	Select or create a WhatsApp credential
Trigger On	Multi-select	Event types to listen for (e.g. `Messages`, `Template Category Update`)

Trigger On Options

Option	Description
`Messages`	Fires when a text or media message is received
`Template Category Update`	Fires when a message template’s category changes

Options

Option	Description
Receive Message Status Updates	Filter which delivery status updates trigger the orchestration: `All`, `Sent`, `Delivered`, `Read`. WhatsApp sends a notification when a message status changes (e.g. from Sent → Delivered). Set this to avoid multiple executions per message.

Webhook URL

The WhatsApp Trigger displays a unique Webhook URL in the node panel. Configure this URL in your WhatsApp Business API app settings under Webhooks.

Output Data

The trigger outputs the incoming message payload:

{
  "from": "919876543210",
  "to": "911234567890",
  "messageId": "wamid.XXXXXXXXXXXX",
  "type": "text",
  "text": {
    "body": "Hello, I need help with my order."
  },
  "timestamp": "1678901234"
}

For media messages:

{
  "from": "919876543210",
  "type": "image",
  "image": {
    "id": "media-id",
    "mimeType": "image/jpeg",
    "caption": "Here's my receipt"
  },
  "timestamp": "1678901234"
}

Reference fields in downstream nodes:

{{ whatsappTrigger.text.body }}
{{ whatsappTrigger.from }}
{{ whatsappTrigger.messageId }}

WhatsApp — Send WhatsApp messages within an orchestration
SubVerse Agents — Route the message to a SubVerse AI agent
AI Agent — Process the incoming message with an LLM

Getting Started

Trigger Nodes

Action Nodes

Logic Nodes

AI Nodes

Operations

Whatsapp trigger

WhatsApp Trigger

Use Cases

Credentials

Node Reference

Parameters

Trigger On Options

Options

Webhook URL

Output Data

​WhatsApp Trigger

​Use Cases

​Credentials

​Node Reference

​Parameters

​Trigger On Options

​Options

​Webhook URL

​Output Data

​Related Nodes

WhatsApp Trigger

Use Cases

Credentials

Node Reference

Parameters

Trigger On Options

Options

Webhook URL

Output Data

Related Nodes