Integrations

Zapier integration

The Wbiztool app on Zapier connects your WhatsApp number to the other apps you use. Start a Zap when a WhatsApp message arrives, or send a WhatsApp message when something happens in another app.

Before you start#

A Wbiztool account with a connected WhatsApp number on WhatsApp settings.
Your Client ID and API key from Settings → API keys.
For the new-message trigger: the Unibox add-on on your plan. See Trigger requirements.

Connect your account#

Add Wbiztool to a Zap
In Zapier, create a Zap and search for Wbiztool as the trigger or action app.
Sign in
When Zapier asks you to connect an account, enter the credentials it asks for, your API key and Client ID, from Settings → API keys.

The API key decides which workspace Zapier uses. If you belong to more than one workspace, use a key created in the workspace you want to connect.

New WhatsApp message trigger#

This trigger starts your Zap each time a message is received on your WhatsApp number. Use it to add new chats to a CRM, post messages to a team channel, or log conversations in a spreadsheet.

Trigger requirements#

Unibox add-on. Without it, turning on the Zap fails with Unibox add-on subscription required. Buy it on Billing & Plans: $20/month or $200/year per WhatsApp number used in Unibox.
A connected WhatsApp number. The trigger is attached to one of your connected numbers.

Trigger data#

Real messages look like this:

{
  "event": "message_received",
  "timestamp": "2026-09-16T10:31:12.482913+00:00",
  "webhook_id": 42,
  "whatsapp_client_id": "678",
  "whatsapp_phone": "919812345678",
  "message": {
    "id": "[email protected]_3EB0C1A2B3D4E5F60718",
    "type": "chat",
    "content": "Hi, is my order #4821 out for delivery?",
    "from": "919876543210",
    "from_name": "Aman",
    "to": "919812345678",
    "timestamp": "2026-09-16T10:29:58+00:00",
    "whatsapp_timestamp": 1789554598,
    "direction": "incoming",
    "status": "pending",
    "is_forwarded": false,
    "forwarding_score": 0
  },
  "contact": {
    "whatsapp_id": "[email protected]",
    "phone": "919876543210",
    "name": "Aman",
    "is_group": false,
    "is_business": false
  },
  "organisation": {
    "id": "5021",
    "name": "Acme Stores"
  }
}

The sample Zapier loads while you set up the trigger has the same message and contact fields (except message.forwarding_score), but no webhook_id, whatsapp_client_id, whatsapp_phone or organisation. Those fields only appear for mapping after a real message arrives. The sample also uses placeholder values: phone numbers with +, whatsapp_timestamp in milliseconds and status set to delivered.

Field	Description
`event`	`message_received` for incoming messages, `message_sent` for messages sent from your number.
`message.type`	`chat` for text. Media messages use types such as `image`, `video`, `audio`, `ptt` (voice note), `document` and `sticker`.
`message.content`	The text. For media, a short label such as "📸 Image".
`message.direction`	`incoming` or `outgoing`.
`message.from` / `message.to`	`from` is always the contact and `to` your number, even for outgoing messages. Use `message.direction` to tell them apart.
`contact.is_group`	`true` when the message came from a group. Group messages also include `group.name`.

In real messages, phone numbers have no +, message.whatsapp_timestamp is in seconds, and message.status is usually pending. Some messages include extra fields: message.media (file name, type and size) for media, message.quoted_message_id for replies and group for group messages. See Webhook listeners for more examples.

Example: log incoming messages in Google Sheets#

Trigger: Wbiztool, New WhatsApp Message.
Filter by Zapier: continue only if message.direction exactly matches incoming.
Action: Google Sheets, Create Spreadsheet Row. Map contact.phone to a Phone column, contact.name to a Name column and message.content to a Message column.

Send WhatsApp messages from a Zap#

To send a message, add Wbiztool as an action and choose one of the actions listed on the Wbiztool Zapier page. Map the recipient's phone number and the message text from earlier steps.

You can also call the API directly with Webhooks by Zapier:

Setting	Value
Action event	POST
URL	`https://wbiztool.com/api/v1/send_msg/`
Payload type	`json` or `form`
Data	`client_id`, `api_key`, `whatsapp_client`, `country_code`, `phone`, `msg`

See Send WhatsApp messages from any automation tool for what each field means, and Send message for every option.

Troubleshooting#

Problem	What to check
`Invalid API key`	The key was deleted or mistyped. Create a new one on Settings → API keys and reconnect.
`Unibox add-on subscription required`	Buy the Unibox add-on on Billing & Plans, then turn the Zap on again.
`No available WhatsApp clients`	No number was set on the trigger, and every connected number already has a Unibox listener, or no number is connected. This includes the listener Wbiztool created the first time you turned this Zap on: turning a Zap off doesn't delete it, so turning it on again (for example after editing the Zap) can fail. Delete a listener you no longer need, such as that one, on Unibox listeners, or connect another number on WhatsApp settings.
`Invalid WhatsApp client`	The number set on the trigger isn't connected right now. Reconnect it on WhatsApp settings.
Zap is on but doesn't trigger	Your WhatsApp number must stay connected for new messages to be picked up. Check the listener on Unibox listeners.
Zapier shows an error when you turn the Zap off, such as `Listener not found` or a server error	This is a known issue. Check the listener on Unibox listeners to see whether its webhook URL was removed.