Integrating Wbiztool with n8n

Automate your WhatsApp messaging workflows by connecting Wbiztool with n8n's powerful workflow automation platform

Introduction

n8n is a powerful workflow automation platform that allows you to connect different services and automate repetitive tasks. By integrating Wbiztool's WhatsApp API with n8n, you can create sophisticated messaging workflows that respond to events across your entire tech stack.

Powerful Automation Possibilities: Trigger WhatsApp messages from CRM updates, e-commerce events, form submissions, database changes, scheduled tasks, and hundreds of other triggers supported by n8n.

What You Can Automate

CRM & Sales
  • Welcome messages for new leads
  • Follow-up sequences for prospects
  • Deal closure notifications
  • Appointment reminders
E-commerce
  • Order confirmations
  • Shipping notifications
  • Abandoned cart recovery
  • Review requests
Customer Support
  • Ticket status updates
  • Escalation notifications
  • Resolution confirmations
  • Feedback collection
Monitoring & Alerts
  • System health alerts
  • Error notifications
  • Performance threshold alerts
  • Backup completion status

Prerequisites

Before setting up the integration, ensure you have:

  • A Wbiztool account with an active subscription
  • A connected WhatsApp client in your Wbiztool dashboard
  • Your Wbiztool API credentials:
  • An n8n account (cloud or self-hosted)
  • Basic understanding of n8n workflows

Setting Up Your First Workflow

Follow these steps to create your first automated WhatsApp messaging workflow in n8n:

  1. Create a New Workflow
    • Log in to your n8n account
    • Click "New Workflow" to create a new automation
  2. Add a Trigger Node
    • Choose your trigger (e.g., "Webhook", "Schedule Trigger", "Google Sheets")
    • Configure the trigger based on your use case
  3. Add HTTP Request Node
    • Click the "+" button after your trigger
    • Search for and select "HTTP Request"
    • Configure the HTTP Request node with Wbiztool API details

HTTP Request Configuration

Configure your HTTP Request node with the following settings for basic message sending:

Basic Configuration
  • Method: POST
  • URL: https://wbiztool.com/api/v1/send_msg/
  • Authentication: None (credentials in body)
  • Body Content Type: Form-Data

Required Authentication Fields

Add these authentication parameters to your request body:

Parameter Type Description Where to Find
client_id Integer Your unique client identifier API Keys page
api_key String Your API authentication key API Keys page
whatsapp_client Integer Your WhatsApp client ID WhatsApp Settings page

Message Configuration Parameters

Note: You can send messages to either individual phone numbers OR WhatsApp groups. Use either the phone parameter for individual messages or the group_name parameter for group messages, but not both in the same request.

Basic Message Parameters

Parameter Type Required Description
msg_type Integer Yes 0 = Text, 1 = Image with text, 2 = File with text
phone String Yes* Recipient's WhatsApp number with country code (e.g., 919632066772)
group_name String Yes* WhatsApp group name (alternative to phone)
country_code String Yes** Country code (e.g., 91 for India, 1 for USA) - only for phone messages
msg String Yes The message content (supports WhatsApp formatting)
* Either phone OR group_name is required
** Required only when using phone parameter

Optional Media Parameters

Parameter Type When Required Description
img_url String When msg_type = 1 Image URL (must end with .png, .jpg, .jpeg etc)
file_url String When msg_type = 2 File URL for direct download
file_name String When msg_type = 2 Name of the file being sent
expire_after_seconds Integer Optional Message expiration time in seconds
webhook String Optional Webhook URL for status updates

Practical Workflow Examples

Here are real-world examples of how to use Wbiztool with n8n for different business scenarios:

Example 1: CRM Lead Notification

Scenario: Send a WhatsApp welcome message when a new lead is added to your CRM

Workflow Setup:
  1. Trigger: Webhook (triggered by CRM when new lead is created)
  2. HTTP Request Node: Send WhatsApp message to lead
HTTP Request Configuration:
{
  "client_id": "your_client_id",
  "api_key": "your_api_key", 
  "whatsapp_client": "your_whatsapp_client_id",
  "msg_type": 0,
  "phone": "{{ $json.lead_phone }}",
  "country_code": "{{ $json.country_code }}",
  "msg": "Hi {{ $json.lead_name }}, thank you for your interest! Our team will contact you shortly. 📞"
}

Example 2: E-commerce Order Confirmation

Scenario: Send order confirmation with details when a customer makes a purchase

Workflow Setup:
  1. Trigger: Webhook (triggered by e-commerce platform on new order)
  2. HTTP Request Node: Send order confirmation
HTTP Request Configuration:
{
  "client_id": "your_client_id",
  "api_key": "your_api_key",
  "whatsapp_client": "your_whatsapp_client_id", 
  "msg_type": 0,
  "phone": "{{ $json.customer_phone }}",
  "country_code": "{{ $json.customer_country_code }}",
  "msg": "🎉 Order Confirmed!\n\nOrder #{{ $json.order_id }}\nTotal: ${{ $json.total_amount }}\n\nEstimated delivery: {{ $json.delivery_date }}\n\nTrack your order: {{ $json.tracking_url }}"
}

Example 3: Scheduled Appointment Reminders

Scenario: Send appointment reminders 24 hours before scheduled meetings

Workflow Setup:
  1. Trigger: Schedule Trigger (runs daily at 9 AM)
  2. Google Sheets Node: Read appointments for tomorrow
  3. Loop Node: Iterate through each appointment
  4. HTTP Request Node: Send reminder for each appointment
Schedule Message API Configuration:
URL: https://wbiztool.com/api/v1/schedule_msg/

{
  "client_id": "your_client_id",
  "api_key": "your_api_key",
  "whatsapp_client": "your_whatsapp_client_id",
  "msg_type": 0,
  "phone": "{{ $json.client_phone }}",
  "country_code": "{{ $json.country_code }}",
  "msg": "⏰ Reminder: You have an appointment tomorrow at {{ $json.appointment_time }}\n\nLocation: {{ $json.location }}\nService: {{ $json.service_type }}\n\nReply CONFIRM to confirm or RESCHEDULE to change.",
  "date": "{{ $json.reminder_date }}",
  "time": "09:00",
  "timezone": "IST"
}

Example 4: Bulk Marketing Campaign

Scenario: Send promotional messages to multiple customers from a Google Sheet

Workflow Setup:
  1. Trigger: Manual trigger or Schedule
  2. Google Sheets Node: Read customer list
  3. HTTP Request Node: Send bulk messages
Multi-Message API Configuration:
URL: https://wbiztool.com/api/v1/send_msg/multi/

{
  "client_id": "your_client_id", 
  "api_key": "your_api_key",
  "whatsapp_client": "your_whatsapp_client_id",
  "msg_type": 1,
  "phone": "{{ $json.phone_numbers.join(',') }}",
  "country_code": "91",
  "msg": "🎉 Special Offer! Get 50% off on all products this weekend. Use code: SAVE50\n\nShop now: {{ $json.shop_url }}",
  "img_url": "https://yoursite.com/promo-banner.jpg"
}

Example 5: System Monitoring Alerts

Scenario: Send WhatsApp alerts to IT team when system errors occur

Workflow Setup:
  1. Trigger: Webhook (triggered by monitoring system)
  2. IF Node: Check error severity level
  3. HTTP Request Node: Send alert to IT WhatsApp group
Group Message Configuration:
{
  "client_id": "your_client_id",
  "api_key": "your_api_key", 
  "whatsapp_client": "your_whatsapp_client_id",
  "msg_type": 0,
  "group_name": "IT Support Team",
  "msg": "🚨 ALERT: {{ $json.alert_type }}\n\nSeverity: {{ $json.severity }}\nServer: {{ $json.server_name }}\nTime: {{ $json.timestamp }}\n\nDetails: {{ $json.error_details }}\n\nDashboard: {{ $json.dashboard_url }}"
}

Setting Up Webhook Integration

Configure webhooks to receive message status updates back in your n8n workflows:

1. Create a Webhook in n8n

  1. Add a "Webhook" node to your workflow
  2. Set HTTP Method to "POST"
  3. Copy the generated webhook URL

2. Add Webhook URL to Your Message Request

Include the webhook URL in your message request:

{
  "client_id": "your_client_id",
  "api_key": "your_api_key",
  "whatsapp_client": "your_whatsapp_client_id",
  "msg_type": 0,
  "phone": "919632066772",
  "country_code": "91", 
  "msg": "Hello from n8n!",
  "webhook": "https://your-n8n-instance.app.n8n.cloud/webhook/your-webhook-id"
}

3. Process Webhook Data

Your webhook will receive status updates in this format:

{% verbatim %}
{
  "msg_id": 12345,
  "status": "sent", // sent, delivered, read, failed
  "timestamp": "2024-01-15T10:30:00Z",
  "phone": "919632066772",
  "error_message": null // only present if status is "failed"
}

Best Practices & Tips

Performance Optimization

  • Rate Limiting: Add delays between bulk messages (1-2 seconds)
  • Error Handling: Use IF nodes to handle API errors gracefully
  • Message Validation: Validate phone numbers before sending
  • Conditional Logic: Send messages only when necessary

Workflow Organization

  • Use Notes: Document your workflow steps
  • Environment Variables: Store API credentials securely
  • Modular Design: Create reusable sub-workflows
  • Testing: Test with small data sets first

Common Issues & Solutions

Issue: "Invalid phone number" error
Solution: Ensure phone numbers include country code and contain only digits
Issue: "WhatsApp client not connected" error
Solution: Check your WhatsApp client status on the WhatsApp Settings page
Issue: Messages not being delivered
Solution: Verify recipient phone numbers are WhatsApp users and not blocked
Tip: Use the Message Status API to track delivery status programmatically

Advanced Features

Dynamic Message Content

Use n8n expressions to create dynamic, personalized messages:

// Dynamic greeting based on time
"msg": "{{ new Date().getHours() < 12 ? 'Good morning' : new Date().getHours() < 17 ? 'Good afternoon' : 'Good evening' }} {{ $json.customer_name }}! Your order #{{ $json.order_id }} is ready."

// Conditional content based on data
"msg": "{{ $json.order_value > 100 ? '🎉 Congratulations on your premium order!' : '😊 Thank you for your order!' }} Order #{{ $json.order_id }} will be delivered by {{ $json.delivery_date }}."

File and Image Handling

Send dynamic files and images from your workflows:

{
  "msg_type": 1,
  "img_url": "{{ $json.generated_chart_url }}",
  "msg": "Here's your monthly report for {{ $json.month }}"
}

// For PDFs and documents
{
  "msg_type": 2, 
  "file_url": "{{ $json.invoice_pdf_url }}",
  "file_name": "Invoice-{{ $json.invoice_number }}.pdf",
  "msg": "Your invoice is ready for download"
}

Integration with Popular n8n Nodes

Trigger Combinations
  • Google Sheets: New row → WhatsApp notification
  • Airtable: Record updated → Status message
  • HubSpot: Deal closed → Celebration message
  • Shopify: Order placed → Confirmation message
Data Processing Nodes
  • Function: Process data before sending
  • IF: Conditional message sending
  • Set: Format message content
  • Merge: Combine data from multiple sources

Getting Help & Support

Documentation Resources

Support Channels

  • Email Support: [email protected]
  • Live Chat: Available in your dashboard
  • Knowledge Base: Check our FAQ section
  • Community Forum: Connect with other users
Ready to Get Started? Create your first n8n workflow with Wbiztool today and automate your WhatsApp messaging like never before!