Actions50
- Message Actions
- Contact Actions
- Account Actions
- Call Actions
- Chat Actions
- Group Actions
- Instance Actions
- Media Actions
- Session Actions
- User Actions
Overview
The node integrates with the WSAPI WhatsApp API to send various types of WhatsApp messages. Specifically, for the Message resource and Send Voice operation, it allows sending voice note messages to individual contacts or groups on WhatsApp by specifying the recipient and a publicly accessible media URL containing the voice file.
This node is useful in scenarios such as:
- Automating customer support by sending voice responses.
- Broadcasting voice announcements or alerts to groups.
- Sending personalized voice messages in marketing campaigns.
Example: Automatically send a voice greeting to new customers after signup by providing their WhatsApp contact ID and a hosted voice message URL.
Properties
| Name | Meaning |
|---|---|
| To | The WhatsApp contact ID or group ID to send the voice message to. For contacts, use the phone number with country code (no plus sign) followed by @s.whatsapp.net (e.g., 1234567890@s.whatsapp.net). For groups, use the group ID followed by @g.us. |
| Media URL | The publicly accessible HTTP or HTTPS URL of the voice media file to send. This must be a direct link to the audio file (e.g., MP3). |
| Mentions | (Advanced Option) Comma-separated list of phone numbers (without @) to mention in the message. |
| Reply To Message ID | (Advanced Option) The ID of an existing message to which this voice message will reply. |
| Is Forwarded | (Advanced Option) Boolean flag indicating whether the message should be marked as forwarded. |
| View Once | (Advanced Option) Boolean flag indicating if the media message should disappear after being viewed once. Applicable only for image and video messages, so not relevant for voice messages here. |
Output
The node outputs JSON data representing the result of the send voice message operation. This typically includes metadata about the sent message such as message ID, status, timestamps, and any server response confirming delivery or errors.
If the node supports binary data output (not explicitly shown for this operation), it would represent media content or attachments, but for sending voice messages, the output mainly confirms the action's success and details.
Dependencies
- Requires an active connection to the WSAPI WhatsApp API service.
- Needs an API key credential configured in n8n to authenticate requests.
- The media URL must be publicly accessible over HTTP or HTTPS without authentication.
- Proper formatting of WhatsApp IDs (contacts and groups) is necessary.
Troubleshooting
- Invalid "To" format: Ensure the phone number includes the country code without a plus sign and uses the correct suffix (
@s.whatsapp.netfor contacts,@g.usfor groups). - Media URL inaccessible: Verify that the media URL is publicly reachable and points directly to a supported audio file format.
- Authentication errors: Confirm that the API key credential is correctly set up and has permissions to send messages.
- Operation not implemented error: If the node throws an error about the operation not implemented, verify that the selected resource and operation match exactly ("Message" resource and "Send Voice" operation).
- Forwarded or reply options ignored: Some advanced options may not apply depending on the message type; check documentation or test accordingly.
Links and References
- WSAPI WhatsApp API Documentation (example placeholder, replace with actual WSAPI docs)
- WhatsApp official guidelines on message formats and media requirements
- n8n documentation on creating and using custom nodes and credentials