Actions37
- Message Actions
- Media Actions
- Contact Actions
- Group Actions
- Instance Actions
- Webhook Actions
Overview
The node provides integration with the Uazapi WhatsApp API, enabling advanced messaging and media management capabilities. Specifically, for the Media resource and Upload Media operation, it allows users to upload media files (images, documents, audio, video, stickers) to the Uazapi server. This is useful when you want to store media on the server before sending it in messages or retrieving a download URL later.
Common scenarios include:
- Uploading a media file once and reusing its ID to send multiple messages.
- Preparing media content in advance for campaigns or automated workflows.
- Managing media assets centrally via the WhatsApp API.
Example: Upload an image or document file URL/base64 data to the server, then use the returned media ID to send that media in WhatsApp messages.
Properties
| Name | Meaning |
|---|---|
| Additional Fields | Optional extra parameters to customize the upload behavior: |
| - Reply to Message ID: ID of message to reply to | |
| - Delay (seconds): Delay before sending message | |
| - Disable Link Preview: Disable link previews in messages | |
| - Mention Users: Comma-separated phone numbers to mention |
Note: The main required property for this operation is:
| Name | Meaning |
|---|---|
| Media URL | URL or base64 string of the media file to upload |
Output
The output JSON contains the response from the Uazapi server after uploading the media. It typically includes metadata about the uploaded media such as its unique media ID, type, size, and possibly URLs for accessing the media.
If the node supports binary data output (not explicitly shown here), it would represent the uploaded media content or related binary information.
Dependencies
Requires an active Uazapi API credential with:
- API key
- API token
- Instance ID
- API base URL
The node sends requests through a proxy endpoint at
https://n8ntools.io/api/v1/proxy/uazapiwhich requires an additional API key credential for authentication.Proper configuration of these credentials in n8n is necessary for successful operation.
Troubleshooting
Common issues:
- Invalid or missing media URL/base64 data will cause upload failure.
- Incorrect or expired API tokens or instance IDs will result in authorization errors.
- Network connectivity problems to the proxy or Uazapi endpoints can cause request timeouts.
Error messages:
- Authorization errors: Check API token and instance ID validity.
- Validation errors: Ensure media URL or base64 data is correctly formatted and accessible.
- Proxy errors: Verify the proxy API key credential and network access.
To resolve errors, verify all credentials, input parameters, and network settings.
Links and References
- Uazapi Official Documentation (for detailed API usage)
- n8n Documentation (for general node and credential setup)
- WhatsApp Business API Guidelines (for media message best practices)