Integrating WbizTool with Activepieces

Introduction

WbizTool provides a powerful REST API that can be integrated with Activepieces to automate your WhatsApp business messaging workflows. This guide will show you how to set up the integration and configure the Send Message API action in Activepieces.

Prerequisites

Before setting up the integration, you need to have:

  • A WbizTool account with an active subscription
  • A connected WhatsApp client in your WbizTool dashboard
  • Your WbizTool API credentials (Client ID, API Key, and WhatsApp Client ID)
  • An Activepieces account

Setting Up the Connection in Activepieces

Follow these steps to create a new connection to the WbizTool API in Activepieces:

  1. Log in to your Activepieces account
  2. Create a new flow or edit an existing one
  3. Add a trigger (such as Google Sheets "New Row Added")
  4. Click the "+" button to add an action
  5. Search for and select "HTTP Request/Send HTTP request"
  6. Configure the HTTP request with the following settings:
    • Method: POST
    • URL: https://wbiztool.com/api/v1/send_msg/
    • Body Type: Form Data

Required Authentication Fields

For every request to the WbizTool API, you need to include the following authentication parameters:

  • client_id (Integer) - Your Client Id (Found on API Keys page)
  • api_key (String) - Your Api Key (Found on API Keys page)
  • whatsapp_client (Integer) - Your WhatsApp Client Id (Found on Whatsapp Setting page)
Client Id & Api Key can be found on the API Keys Page
WhatsApp Client Id can be found on the Whatsapp Setting Page

Configuring the Send Message API Action

To send a WhatsApp message using Activepieces, configure the following parameters in your HTTP POST request:

Basic Parameters

  • msg_type (Integer) - 0 for Text message, 1 for Image with message, 2 for File with message
  • phone (String) - Recipient's WhatsApp number with country code (e.g., 919632066772)
  • country_code (String) - Recipient's country code (e.g., 91 for India, 1 for USA)
  • msg (String) - The message text content

Optional Parameters for Media Messages

  • img_url (String) - Required when msg_type is 1. URL should end with a valid image extension (.png, .jpg, .jpeg)
  • file_url (String) - Required when msg_type is 2. URL from which the file can be directly downloaded
  • file_name (String) - Required when msg_type is 2. Name of the file

Additional Optional Parameters

  • expire_after_seconds (Integer) - Message will expire if not sent within this time
  • webhook (String) - Webhook URL where message status updates will be posted

Example: Setting up an Activepieces Workflow

Here's an example of how to configure a flow in Activepieces to send a WhatsApp message:

Step 1: Set Up a Trigger

You can use Google Sheets as a trigger to send messages when a new row is added.

Step 2: Configure HTTP Request

Add an HTTP Request action and configure it with the WbizTool API endpoint.

Step 3: Set Form Data Parameters

For a simple text message, add the following form data parameters:

Parameter Value
client_id YOUR_CLIENT_ID (e.g., 1)
api_key YOUR_API_KEY
whatsapp_client YOUR_WHATSAPP_CLIENT_ID (e.g., 20)
msg_type 0
phone RECIPIENT_PHONE_WITH_COUNTRY_CODE (e.g., 919833371069)
message Your message text here

Step 4: Handle the Response

The API will return a JSON response with the following fields:

  • status (Integer) - 1 for success, 0 for error
  • message (String) - Description of the request result
  • msg_id (Integer) - Unique message ID for tracking (when successful)

Common Use Cases

Here are some common scenarios for integrating WbizTool with Activepieces:

  • Form Submissions - Send WhatsApp notifications when someone fills out a form on your website
  • New Customer Welcome - Automatically send welcome messages to new customers
  • Order Updates - Send order confirmations and shipping updates
  • Appointment Reminders - Send automated reminders before appointments
  • Lead Notifications - Alert your sales team about new leads via WhatsApp

Troubleshooting

If you encounter issues with your Activepieces integration, check these common problems:

  • Authentication Errors - Verify your Client ID, API Key, and WhatsApp Client ID are correct
  • Invalid Parameters - Ensure all required parameters are included and formatted correctly
  • WhatsApp Client Status - Confirm your WhatsApp client is connected in the WbizTool dashboard
  • Media URLs - For image or file messages, ensure the URLs are publicly accessible

Testing Your Integration

You can use the "Test Step" feature in Activepieces to verify your integration is working properly before publishing your flow.

For additional support, contact the WbizTool support team or visit our complete API documentation.