WhatsApp Web API: Send Outbound Messages

We're excited to announce the ability to send outbound messages through the WhatsApp Web API integration. You can now initiate conversations with your customers programmatically, enabling proactive customer engagement at scale.

What's New

Send WhatsApp messages to your customers directly through our API, and when they reply, the conversation continues seamlessly in the same thread.

Key Features:

🚀 Initiate Conversations - Start WhatsApp conversations with customers programmatically

💬 Automatic Threading - Customer replies automatically attach to the same conversation

👥 Lead Management - New contacts are automatically created as leads in your system

🔗 Conversation Tracking - Each conversation gets a unique ID for easy reference and follow-up

📎 File Attachments - Send documents, images, PDFs and other files with your messages

🔊 Audio Messages - Convert text to natural-sounding audio for voice-based engagement

Key Use Cases

Customer Notifications

Order confirmations and shipping updates
Appointment reminders and scheduling confirmations
Account alerts and security notifications

Proactive Support

Follow-up messages after purchases
Check-ins with customers about their experience
Proactive troubleshooting and assistance

Marketing & Engagement

Personalized promotional campaigns
Re-engagement messages for inactive customers
Event invitations and announcements

Message Formats & Attachments

Text Messages (Default) Send standard text messages to your customers.

File Attachments Include documents, images, PDFs and other files with your messages:

Up to 3 files per message
Supports images, PDFs, documents, and more
Perfect for sending receipts, tickets, invoices, product images

Audio Messages Enable audio format to convert your text into natural-sounding voice messages:

Requires chatbot audio settings to be enabled
Automatic text-to-speech conversion
Ideal for voice-first customer experiences

How It Works

When you send an outbound message through the API, the system:

Creates or updates the customer's lead profile automatically
Generates a unique conversation ID for threading
Delivers the message via your connected WhatsApp Web integration
Routes any replies from the customer back to the same conversation

This means you get complete conversation history and context, even when you initiate the conversation.

Quick Examples

Basic Text Message

POST /api/v2/send-whatsapp-web-message-outbound
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{
  "chatbotId": "your_chatbot_id",
  "phone": "1234567890",
  "message": "Hi! Your order #12345 has been shipped and will arrive tomorrow."
}

Message with File Attachment

POST /api/v2/send-whatsapp-web-message-outbound
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{
  "chatbotId": "your_chatbot_id",
  "phone": "1234567890",
  "message": "Here's your invoice for order #12345",
  "files": [
    {
      "name": "invoice-12345.pdf",
      "type": "application/pdf",
      "url": "https://example.com/invoices/12345.pdf"
    }
  ]
}

Audio Message

POST /api/v2/send-whatsapp-web-message-outbound
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{
  "chatbotId": "your_chatbot_id",
  "phone": "1234567890",
  "message": "Hi! Your order #12345 has been shipped and will arrive tomorrow.",
  "format": "audio"
}

Response (same for all formats):

{
  "status": "success",
  "conversationId": "1234567890:0987654321",
  "leadUUID": "1234567890"
}

When the customer replies to your message, their response will automatically appear in your Chat Data inbox under the same conversation ID.

Getting Started

Step 1: Connect your WhatsApp Web account in Chatbot Settings → Third-Party Integrations

Step 2: Get your API key from Account Settings → API Keys

Step 3: Send your first outbound message using the endpoint above

Step 4: Monitor replies in your Chat Data inbox or via the conversation API

Important Notes

Phone numbers should be in E.164 format without the '+' prefix (e.g., "1234567890")
Your WhatsApp Web integration must be connected and authenticated
Files: Maximum 3 files per message, each file must have name, type (MIME type), and url properties
Audio: Requires chatbot audio settings to be enabled in your chatbot configuration
All replies from customers will appear in your Chat Data inbox
Conversation history is preserved for both outbound and inbound messages

Documentation

For complete API specifications, authentication details, and error handling, see:

API Reference - /send-whatsapp-web-message-outbound

Available now for all plans with WhatsApp Web integration and API access.