WhatsApp Block
The WhatsApp block enables sending messages through the WhatsApp Business API. Reach users directly on WhatsApp with text messages, templates, and media.
Key Features
- Send Messages - Send text messages to WhatsApp users
- Template Messages - Use pre-approved message templates
- Media Support - Send images, documents, and other media
- Direct Communication - Reach users on their preferred messaging platform
WhatsApp Business API requires approval for message templates. Set up your templates in Meta Business Manager before using this block.
Configuration
| Parameter | Type | Required | Description |
|---|---|---|---|
| Credentials | Select | Yes | WhatsApp Business API credentials |
| Phone Number | Text | Yes | Recipient's phone number (with country code) |
| Message Type | Select | Yes | Text, Template, or Media |
| Message | Text | Yes* | The message content (for text type) |
| Template Name | Text | Yes* | Template identifier (for template type) |
| Media URL | Text | Yes* | URL of media to send (for media type) |
Setup Guide
- Set up WhatsApp Business API credentials in your workspace
- Add the WhatsApp block to your workflow
- Select your WhatsApp credentials
- Enter the recipient's phone number (include country code, e.g., +1234567890)
- Choose message type and configure content
Example Usage
Send Order Confirmation
Phone: {{customer.phone}}
Message Type: Template
Template: order_confirmation
Variables:
- {{order.id}}
- {{order.total}}
- {{order.delivery_date}}Send Text Notification
Phone: {{user.whatsapp}}
Message Type: Text
Message: Your appointment is confirmed for {{appointment.date}} at {{appointment.time}}.Message Types
Text Messages
Simple text messages for direct communication. Best for transactional updates.
Template Messages
Pre-approved templates required for initiating conversations. Must be approved by Meta.
Media Messages
Send images, PDFs, or documents along with captions.
Output
The block outputs:
- messageId (string) - WhatsApp message ID for tracking
- status (string) - Delivery status (sent, delivered, read)
- timestamp (string) - When the message was sent
Best Practices
- Use Templates - For initiating conversations, use approved templates
- Include Country Code - Always prefix phone numbers with country code
- Handle Opt-outs - Respect user preferences and unsubscribe requests
- Monitor Delivery - Check message statuses for failed deliveries
Error Handling
| Error | Cause | Solution |
|---|---|---|
| Invalid phone number | Incorrect format | Include country code (+XX) |
| Template not found | Template doesn't exist | Verify template name in Meta Business Manager |
| Rate limit exceeded | Too many messages | Implement message queuing |
| Account not verified | WhatsApp not set up | Complete WhatsApp Business verification |