Actions148
- Send messages Actions
- Outbound Messages Actions
- WhatsApp Numbers Actions
- Groups Actions
- Channels Actions
- Chats Actions
- Chat Contacts Actions
- Chat Messages Actions
- Chat Files Actions
- Team Actions
- Labels Actions
- Departments Actions
- Files Actions
- Quick replies Actions
- Queue Actions
- WhatsApp session Actions
- WhatsApp profile Actions
- Business catalog Actions
- Campaigns Actions
- Meeting Links Actions
- User Status Actions
- Webhooks Actions
- Other Actions
Send messages → Send multimedia message
AI-generatedOverview
This node enables sending multimedia messages via the WaliChat WhatsApp API. It supports sending various types of media (images, documents, videos, audio) to individual phone numbers, groups, or channels on WhatsApp. The node is useful for automating communication workflows such as customer support, marketing campaigns, notifications, and interactive chatbots that require rich media content.
Practical examples include:
- Sending promotional videos or brochures to customers.
- Delivering event invitations with images to WhatsApp groups.
- Sharing audio messages or documents in a channel for team collaboration.
- Automating multimedia responses in chatbot conversations.
Properties
| Name | Meaning |
|---|---|
| WhatsApp number | The target WaliChat Number ID used for message delivery. This identifies the WhatsApp account/device sending the message. |
| Target | Type of target chat: Phone (individual), Group, or Channel. |
| Phone Number | Target phone number in international E.164 format (e.g., +1234567890). Required if Target is Phone. |
| Group ID | ID of the target WhatsApp group chat (e.g., 12345678902401234@g.us). Required if Target is Group. |
| Channel ID | ID of the target WhatsApp channel (e.g., 12345678902402200@newsletter). Required if Target is Channel. |
| File URL | URL of the media file to send (image, document, video, audio). Required for sending multimedia messages. |
| Options | Collection of optional settings including: - Priority: Normal, High, Low - Label: Custom label to categorize the message - Reference ID: Custom reference for tracking - Team Agent: Send on behalf of an agent - Live mode: Real-time sending without queue - Delivery Queue Mode: Controls queuing behavior (default, always queue, never queue, opportunistic) - Maximum Retries: Number of delivery retries - Chat Actions: Post-delivery actions like assigning chat, resolving, adding labels, setting metadata, etc. |
| Message Expiration | Defines message time-to-live (TTL) with options: - Seconds: expire after N seconds - Duration: expire after duration string (e.g., 1h) - Date: expire at specific date/time |
| Mark Chat as Read | Boolean to notify WhatsApp that previous unread messages are read after delivery (blue double-check). Requires WhatsApp read confirmation enabled. |
| Typing simulation | Number of seconds (2-30) to simulate typing or recording status before sending the message. Set 0 to disable. |
| Quote Message | Message ID to quote when sending this message (18-32 hex characters). Can only quote messages in the same conversation. |
| Strict Message Order | Boolean to ensure messages are sent in strict order to the target chat. Useful for chatbots and sequences. Not compatible with live mode or "never queue" delivery options. |
Output
The node outputs JSON data representing the result of the message sending operation. This typically includes details such as message IDs, status, timestamps, and any metadata returned by the WaliChat API confirming successful delivery or errors.
If binary data is involved (not typical for sending media via URL), it would represent the media content sent or received, but this node primarily handles media via URLs.
Dependencies
- Requires an API key credential for authenticating with the WaliChat WhatsApp API.
- Needs network access to the media URLs provided.
- The node depends on WaliChat's backend services for message delivery.
- Some properties load dynamic options from WaliChat API endpoints (e.g., devices, groups, channels, agents, labels).
Troubleshooting
- Invalid phone number format: Ensure phone numbers follow the E.164 format (e.g., +1234567890). The node validates this with regex.
- Missing required fields: For example, selecting Target = Group requires a valid Group ID; missing these will cause errors.
- Media URL issues: The media URL must be accessible and valid. Invalid URLs or unsupported media types will cause failures.
- Delivery queue misconfiguration: Using real-time delivery ("never queue") for high-volume messaging can lead to WhatsApp bans or message loss.
- Agent or department IDs invalid: When assigning chats post-delivery, agent and department IDs must be valid 24-character hexadecimal strings.
- Message quoting errors: Quoting a message outside the current conversation or with invalid ID length will fail.
- Typing simulation limits: Values outside 0-30 seconds may be rejected.
- Read receipt not working: If WhatsApp privacy settings disable read confirmations, marking chat as read will have no effect.
To resolve errors, verify all inputs against their validation rules, check API credentials, and consult WaliChat API documentation for rate limits and usage policies.