Green API icon

Green API

Send WhatsApp messages via Green API

Actions29

Message → Send File By URL

AI-generated

Overview

This node operation sends a file to a specified WhatsApp chat using a direct URL of the file. It is useful for automating the sending of media files such as images, documents, or videos hosted online without needing to upload the file data directly. For example, you can send an image from a public URL to a contact or group chat with an optional caption.

Use Case Examples

  1. Send an image from a URL to a private chat with a caption.
  2. Send a PDF document from a URL to a group chat without a caption.

Properties

Name Meaning
Chat ID The identifier of the chat where the file will be sent. Use phone@c.us format for private chats or chatId@g.us for group chats.
File URL The direct URL of the file to be sent.
File Name The name of the file to send, including the extension.
Caption An optional caption text to accompany the file.
Quoted Message ID Optional ID of a message to quote in the chat when sending the file.

Output

JSON

  • chatId - The chat ID where the file was sent.
  • urlFile - The URL of the file sent.
  • fileName - The name of the file sent.
  • caption - The caption text sent with the file, if any.
  • quotedMessageId - The ID of the quoted message, if provided.
  • response - The response from the Green API after sending the file.

Dependencies

  • Green API service
  • API credentials including instance ID and API token

Troubleshooting

  • Ensure the file URL is accessible and a direct link to the file, not a download page.
  • Verify that the chat ID is correctly formatted for private or group chats.
  • Check that the API credentials (instance ID and token) are valid and have permissions.
  • Common error messages include failures to send the file due to network issues or invalid parameters; review the error message and the data sent for debugging.

Links

Discussion