Overview
This node allows users to interact with WhatsApp voice messages via the Green API. It supports two main operations: obtaining the download URL for a voice message and downloading the voice message file itself. This is useful for automating workflows that involve processing or storing WhatsApp voice messages, such as archiving messages, analyzing audio content, or integrating voice messages into other systems.
Use Case Examples
- Automatically download voice messages from a specific WhatsApp chat and save them as binary data for further processing.
- Retrieve the download URL of a voice message to share or use in external applications without downloading the file immediately.
Properties
| Name | Meaning |
|---|---|
| Chat ID | The WhatsApp chat identifier where the voice message was sent. |
| Message ID | The unique identifier of the voice message to download. |
| Save as Binary | Determines whether the downloaded voice message file should be saved as binary data within the node output. |
| Binary Property Name | The name of the binary property where the voice file will be stored if saving as binary is enabled. |
Output
Binary
Contains the voice message file data encoded in base64 under the specified binary property name if 'Save as Binary' is true.
JSON
downloadUrl- The URL from which the voice message can be downloaded.mimeType- The MIME type of the voice message file, typically 'audio/ogg'.fileName- The name of the voice message file.fileSize- The size of the downloaded voice message file in bytes (only present when the file is downloaded).chatId- The chat ID associated with the voice message.messageId- The unique ID of the voice message.downloaded- Boolean indicating whether the voice message file was successfully downloaded.
Dependencies
- Green API credentials including instance ID and API token for authentication.
Troubleshooting
- If no download URL is received, the node throws an error indicating the voice message could not be retrieved. Verify the chat ID and message ID are correct and that the Green API credentials are valid.
- Network issues or invalid API tokens can cause request failures. Ensure the API token and instance ID are correctly configured and the Green API service is reachable.
- If 'Save as Binary' is enabled but the binary property name is missing or invalid, the node may fail to store the file correctly. Ensure the binary property name is set properly.
Links
- Green API Voice Messages Documentation - Official documentation for handling WhatsApp voice messages via Green API.