Back to Help

Webhooks & API — Connect WA Web Plus to Your Systems

Published on

Webhooks & API — Connect WA Web Plus to Your Systems

WA Web Plus supports two-way integration with external systems through webhooks. You can receive incoming API requests to trigger actions inside WhatsApp, or send outgoing requests to your own server whenever an event occurs.

Incoming Webhooks (REST API)

Incoming webhooks let you send authorized HTTP requests to WA Web Plus to perform actions — like sending messages, running broadcasts, or labeling chats — directly from your own system, CRM, or automation tool.

Each request must include your authorization token in the headers. The body is a JSON object with an action field that defines what to do.

Send a text message

json
{
  "action": "send-message",
  "type": "text",
  "content": "Welcome to WA Web Plus",
  "phone": "905366365288"
}

Send a media message

json
{
  "action": "send-message",
  "type": "media",
  "content": "Welcome to WA Web Plus",
  "phone": "905366365288",
  "attachments": ["https://example.com/image.jpg"]
}

Send a saved template

json
{
  "action": "send-template",
  "template": "Welcome Message",
  "phone": "120363020166629872@g.us"
}

Use the @g.us suffix for group targets.

Label a chat

json
{
  "action": "label-chat",
  "label": "Interested Customer",
  "phone": "905366365288"
}

Remove a label

json
{
  "action": "unlabel-chat",
  "label": "Unsubscribed",
  "phone": "905366365288"
}

Block a contact

json
{
  "action": "block-chat",
  "phone": "905366365288"
}

Archive a chat

json
{
  "action": "archive-chat",
  "phone": "905366365288"
}

Run a broadcast campaign

json
{
  "action": "run-broadcast",
  "broadcast": "Sunday Scheduled Campaign"
}

Trigger a Smart Reply workflow

json
{
  "action": "run-workflow",
  "workflow": "Refund Workflow",
  "phone": "905366365288"
}

Outgoing Webhooks

Outgoing webhooks let WA Web Plus send event data to your server in real time — for example, when a message is received, a user joins a group, or a Smart Reply is triggered.

You can configure the HTTP method (POST, GET, UPDATE, DELETE), custom headers (as JSON), and fully customize the payload sent to your endpoint. Use the @ button in the payload editor to insert any of the available event variables.

Available event variables:

  • •m_id — message unique ID
  • •m_type — message type
  • •m_datetime — formatted date and time
  • •m_timestamp — unix timestamp
  • •m_user — sender's phone number
  • •m_phone — sender's phone number
  • •m_content — message content
  • •m_text — message text or caption
  • •m_cname — contact name
  • •m_uname — sender's WhatsApp display name
  • •m_gname — group name where the message was received
  • •m_gid — group unique ID
  • •m_platform — sender's platform
  • •w_id — workflow unique ID that triggered the webhook
  • •c_labels — chat labels
  • •c_image — chat image
  • •m_location — location coordinates
  • •m_order — order items

For help setting up your integration, reach out at support@wawplus.com.

Want Webhooks to Run Without the Browser?

Webhooks in WA Web Plus require WhatsApp Web to be open in your browser. If you need your webhooks and automations to run on the cloud 24/7 — without keeping your computer on — check out Botassium, our cloud-based solution that keeps everything running without a browser.

Webhooks & API — Connect WA Web Plus to Your Systems - WA Web Plus