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 incoming message trigger: the Unibox add-on on your plan. See Trigger requirements.

Connect your account#

1. Add WbizTool to a Zap

   In Zapier, create a Zap and search for WbizTool as the trigger or action app.

2. Sign in

   When Zapier asks you to connect an account, enter your Client ID and API key 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. If the Client ID or API key is wrong, Zapier shows the error when you connect, for example Auth Error: invalid api key.

Incoming WhatsApp message trigger#

This trigger starts your Zap each time someone sends a message to one of your WhatsApp numbers. Use it to add new chats to a CRM, post messages to a team channel, or log conversations in a spreadsheet.

1. Choose the trigger

   Choose WbizTool as the app and Incoming WhatsApp Message as the trigger event.

2. Pick a WhatsApp number

   Under WhatsApp Number, pick the connected number whose incoming messages should start the Zap. The list shows the phone numbers connected in your workspace.

3. Test the trigger

   Click Test trigger. Zapier loads your latest messages received on that number, so you can map real fields in the next steps. If the number has no messages yet, Zapier shows a sample message instead.

4. Turn the Zap on

   Publish the Zap. WbizTool connects to Zapier automatically. You don't need to add a webhook URL anywhere in WbizTool.

Trigger requirements#

• Unibox add-on. The trigger adds your number to the Unibox inbox (an inbox number). Without the add-on, 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 free inbox number. If the number isn't in the inbox yet, it takes one of the inbox numbers your add-on allows. A number that's already in the inbox doesn't use another.
• Owner or Editor role. The API key must belong to a workspace Owner or Editor.
• A connected WhatsApp number. The number must stay connected for new messages to be picked up.

How the trigger works with your inbox numbers#

• Only incoming messages start the Zap. Messages sent from your number don't.
• Only messages received after you turn the Zap on are sent. Older messages aren't replayed.
• If the number is already in the inbox with your own webhook URL, Zapier's webhook takes its place while the Zap is on. When you turn the Zap off, your own webhook URL, secret and event settings are put back.
• If you delete a Zap without turning it off first, WbizTool stops sending to it as soon as Zapier reports that the Zap is gone.
• On Inbox numbers, the number's webhook shows a Zapier badge. If you Stop or Remove the number there, the Zap stays on in Zapier but receives no messages, and the page warns you first. To stop the Zap, turn it off in Zapier instead. To get messages flowing again after deleting the listener, turn the Zap off and on again in Zapier.

See Incoming message webhooks for how inbox numbers and webhooks work.

Trigger data#

Each Zap run receives one message, 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",
    "lid": null,
    "phone_hidden": false,
    "name": "Aman",
    "is_group": false,
    "is_business": false
  },
  "organisation": {
    "id": "5021",
    "name": "Acme Stores"
  }
}

Some messages include extra fields: message.media (file name, type, size and url, a download link that works for 7 days) for media, message.quoted_message_id for replies and group for group messages. To keep a file, copy it within those 7 days (for example with a Google Drive or Dropbox upload step).

Example: log incoming messages in Google Sheets#

1. Trigger: WbizTool, Incoming WhatsApp Message.
2. 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#

Add WbizTool as an action and choose one of these action events:

In every action, pick the sending number under WhatsApp Number. Enter the recipient's phone number with the country code, such as 919876543210, or put the country code in the optional Country Code field, such as 91. Send WhatsApp Message on Group has no phone or country code; it takes the Group Name instead.

When WbizTool can't accept a message, the step fails and Zapier shows the reason, for example WbizTool: Invalid phone number or WbizTool: Not enough credits. A successful step means the message was queued. WbizTool then sends it from your connected number.

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

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

Troubleshooting#