Green API Get Image

Download and process WhatsApp images via Green API

Actions3

Overview

This node interacts with the Green API to handle WhatsApp image messages. It supports three main operations: retrieving the image download URL, downloading the image file, and fetching image metadata without downloading. This node is useful for automating workflows that involve processing WhatsApp images, such as archiving images, analyzing image metadata, or integrating WhatsApp images into other systems.

Use Case Examples

  1. Automatically download images sent to a WhatsApp chat and save them as binary data for further processing.
  2. Retrieve metadata of an image message to display information without downloading the file.
  3. Get the direct download URL of an image to share or use in other applications.

Properties

Name Meaning
Chat ID The WhatsApp chat ID where the image was sent, required to identify the source chat.
Message ID The ID of the specific image message to process, required to identify the image message.
Include Caption Boolean flag to include the image caption in the response if available.

Output

Binary

Binary data of the downloaded image file, stored under a configurable property name if the image is downloaded and saved as binary.

JSON

  • downloadUrl - The URL to download the image file.
  • mimeType - The MIME type of the image, e.g., image/jpeg.
  • fileName - The name of the image file.
  • fileSize - The size of the downloaded image file in bytes (only for downloaded images).
  • chatId - The WhatsApp chat ID where the image was sent.
  • messageId - The ID of the image message.
  • isImage - Boolean indicating the data represents an image (true for image info and downloaded image).
  • downloaded - Boolean indicating if the image was downloaded (true for downloaded images).
  • caption - The caption text of the image if included and available.

Dependencies

  • Green API credentials including instance ID and API token for authentication.

Troubleshooting

  • Common issues include missing or incorrect chat ID or message ID, resulting in failed API requests.
  • If the download URL is not received, the node throws an error indicating no download URL was found; verify the message ID and chat ID are correct and the image exists.
  • Network or authentication errors may occur if the Green API credentials are invalid or expired; ensure valid credentials are configured.

Links

Discussion