Send WhatsApp messages
WhatsApp is a globally popular messaging platform that enables secure, reliable communication between individuals and businesses.
WhatsApp Business API provides organizations with powerful capabilities to:
- Engage customers: Send personalized messages, notifications, and updates directly to customers' preferred messaging app
- Automate conversations: Create interactive chatbots and automated response systems for common inquiries
- Enhance support: Provide real-time customer service through a familiar interface with rich media support
- Drive conversions: Facilitate transactions and follow-ups with customers in a secure, compliant environment
In Mandala, the WhatsApp integration enables your agents to leverage these messaging capabilities as part of their workflows. This creates opportunities for sophisticated customer engagement scenarios like appointment reminders, verification codes, alerts, and interactive conversations. The integration bridges the gap between your AI workflows and customer communication channels, allowing your agents to deliver timely, relevant information directly to users' mobile devices. By connecting Mandala with WhatsApp, you can build intelligent agents that engage customers through their preferred messaging platform, enhancing user experience while automating routine messaging tasks.
Usage Instructions
Integrate WhatsApp into the workflow. Can send messages.
Tools
whatsapp_send_message
Send WhatsApp messages
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
phoneNumber | string | Yes | Recipient phone number with country code |
phoneNumberId | string | Yes | WhatsApp Business Phone Number ID |
accessToken | string | Yes | WhatsApp Business API access token (supports env vars like {{WHATSAPP_ACCESS_TOKEN}}) |
mode | string | No | Mode: text, interactive, image, video, audio, document, sticker, location, contacts, reaction, raw (legacy: media with media.type) |
message | string | No | Message body (required only for mode=text) |
media | object | No | Media payload for image/video/audio/document/sticker (expects link; optional caption/filename) |
interactive | object | No | Interactive payload (list/buttons) |
location | object | No | Location payload (latitude, longitude, optional name, address) |
contacts | object | No | Contacts payload (Cloud API contacts array) |
reaction | object | No | Reaction payload (message_id, emoji) |
rawPayload | object | No | Send a raw WhatsApp Cloud API payload (advanced) |
Output
| Parameter | Type | Description |
|---|---|---|
success | boolean | Send success status |
messageId | string | Unique WhatsApp message identifier (when available) |
httpStatus | number | HTTP status code from the WhatsApp/Graph API request |
error | string | Error message (when the API returns an error) |
rawResponse | json | Full API response body (useful for debugging) |
Media notes
- For media modes (
image/video/audio/document/sticker),media.linkmust be a direct, publicly downloadable file URL (e.g. anhttps://.../file.mp4that returns the actual bytes). - YouTube links are not direct media files; send them as text instead.
- Stickers must be WebP (
image/webp). - If you see “File too large” during upload, reduce the file size/bitrate or send a link as text.
Notes
- Category:
tools - Type:
whatsapp