Actions37
- Instance Actions
- Message Actions
- Group Actions
- Contact Actions
- Chat Actions
- Campaign Actions
- Chatbot Actions
Overview
This node integrates with the UazAPI service to send various types of WhatsApp messages, including media files. Specifically, the Send Media operation under the Message resource allows users to send different media types such as images, videos, audio, documents, voice notes (PTT), and stickers to a specified WhatsApp number.
Common scenarios for this node include:
- Sending promotional images or videos to customers.
- Sharing documents or PDFs via WhatsApp automatically.
- Delivering voice notes or audio clips in customer support workflows.
- Sending stickers or other media content in chatbots or automated messaging flows.
For example, a marketing automation workflow could use this node to send an image flyer with a caption to a list of customers.
Properties
| Name | Meaning |
|---|---|
| Number | Recipient's phone number including country code, without the "+" sign (e.g., 5511999999999). |
| Media Type | Type of media to send. Options: Image, Video, Audio, Document, PTT (Voice Note), Sticker. |
| File URL or Base64 | The media file to send, either as a direct URL or a base64-encoded string. |
| Caption | Optional text caption to accompany the media message. |
Output
The node outputs a JSON object representing the response from the UazAPI after attempting to send the media message. This typically includes status information about the sent message, such as success confirmation or error details.
If the media is successfully sent, the output JSON will contain relevant metadata returned by the API, which may include message IDs or delivery status.
The node does not output binary data directly; it only sends media via the API and returns the API's JSON response.
Dependencies
- Requires an active connection to the UazAPI service.
- Requires valid credentials configured in n8n for authenticating with UazAPI (an API key or token).
- The node uses HTTP requests authenticated via these credentials to communicate with the UazAPI endpoints.
- The base URL for the API is taken from the credential configuration.
Troubleshooting
- Invalid Number Format: Ensure the recipient number includes the country code but no "+" sign. For example, use "5511999999999" instead of "+5511999999999".
- File URL or Base64 Errors: The media file must be accessible via the provided URL or correctly formatted as a base64 string. Invalid URLs or corrupted base64 strings will cause failures.
- Unsupported Media Type: Only the listed media types are supported. Using unsupported types may result in errors.
- Authentication Failures: Verify that the API credentials are correctly set up and have not expired.
- API Rate Limits or Quotas: If sending many messages, watch for rate limit errors from the API and adjust usage accordingly.
- Error Messages: The node returns API error messages in the output JSON under an
errorfield if the request fails. Review these messages for specific issues.
Links and References
- UazAPI Documentation (hypothetical link, replace with actual)
- WhatsApp Business API media message guidelines (for understanding media types and limits)