Actions50
- Message Actions
- Contact Actions
- Account Actions
- Call Actions
- Chat Actions
- Group Actions
- Instance Actions
- Media Actions
- Session Actions
- User Actions
Overview
This node interacts with the WSAPI WhatsApp API, specifically allowing users to download media files that were received via WhatsApp webhooks. It is useful in scenarios where you want to programmatically retrieve and process media content such as images, videos, or documents sent by WhatsApp users.
For example, when a WhatsApp webhook event notifies your system of an incoming media message, this node can be used to download the actual media file using its unique media ID. This enables workflows like saving media to cloud storage, analyzing images, or forwarding media to other services.
Properties
| Name | Meaning |
|---|---|
| Media ID | Unique identifier of the media file received via WhatsApp webhooks. This ID is obtained from the media.id field in webhook events when media files are received. |
Output
The node outputs the downloaded media data. The output includes a json field containing metadata about the media, and if applicable, binary data representing the actual media file (e.g., image, video, document). This allows subsequent nodes in the workflow to access or manipulate the media content directly.
Dependencies
- Requires an API key credential for authenticating with the WSAPI WhatsApp API.
- Needs the base URL of the WSAPI service configured in the credentials.
- The node depends on receiving a valid media ID from WhatsApp webhook events to function correctly.
Troubleshooting
Common issues:
- Providing an invalid or expired media ID will result in failure to download the media.
- Missing or incorrect API authentication credentials will cause authorization errors.
- Network connectivity problems may prevent successful API calls.
Error messages:
"The resource "media" is not known!"— indicates the resource parameter was set incorrectly; ensure it is set to "Media"."The operation "downloadMedia" is not implemented yet!"— suggests the operation name might be misspelled or unsupported.- API errors related to authentication or media retrieval will typically include descriptive messages from the WSAPI service; verify credentials and media ID validity.
Links and References
- WSAPI WhatsApp API Documentation (replace with actual URL)
- WhatsApp Webhook Media Messages