Actions28
- Messages Actions
- Media Actions
- Templates Actions
- Contacts Actions
- Analytics Actions
- Webhooks Actions
Overview
This node integrates with the WhatsApp Business API via an external service to perform various WhatsApp-related operations. Specifically, for the Media - Upload Media operation, it allows users to upload media files (images, audio, video, or documents) to WhatsApp by providing a file URL and specifying the media type.
This is useful in scenarios where you want to programmatically upload media content to WhatsApp to later send it in messages or manage your media library. For example, you might automate uploading product images or promotional videos from a remote server to WhatsApp for customer engagement.
Properties
| Name | Meaning |
|---|---|
| File URL | The URL of the file to be uploaded to WhatsApp. |
| Media Type | The type of media being uploaded. Options: Image, Audio, Video, Document. |
Output
The node outputs JSON data representing the response from the WhatsApp API after uploading the media. This typically includes metadata about the uploaded media such as its unique media ID, which can be used in subsequent message sending operations.
No binary data output is produced by this operation; the output is purely JSON describing the uploaded media resource.
Dependencies
- Requires an active subscription and valid API key credential for the external WhatsApp integration service.
- The node uses this external service's API endpoint to validate credentials and perform the media upload.
- Proper configuration of the API URL and API key in the node credentials is necessary.
- Internet access is required to fetch the file from the provided URL and to communicate with the WhatsApp API service.
Troubleshooting
- Invalid Subscription or API Key: If the node throws an error indicating invalid subscription or API key, verify that the API key credential is correctly configured and active.
- File URL Issues: Ensure the provided file URL is accessible and points directly to a valid media file supported by WhatsApp.
- Unsupported Media Type: Confirm that the media type matches one of the allowed options (image, audio, video, document).
- Network Errors: Check network connectivity if the node cannot reach the external API or download the file.
- API Rate Limits or Quotas: If uploads fail intermittently, check if the external service imposes rate limits or quotas on API usage.
Links and References
- WhatsApp Business API Documentation
- n8n Documentation on Creating Custom Nodes
- External service documentation (not publicly linked here) for the WhatsApp API integration used by this node.