Chatflow icon

Chatflow

Send WhatsApp messages via Chatflow API
Join our community

Actions5

Overview

This node allows sending WhatsApp messages through the Chatflow API. It supports multiple message types including text, audio, video, document, and image. The node is useful for automating WhatsApp communications such as notifications, alerts, marketing messages, or customer support interactions.

For the Image operation specifically, the node sends an image message to a specified WhatsApp contact (identified by JID) on a given Chatflow instance. Optionally, a caption can be added to the image.

Practical example:
You want to automatically send product images with descriptions to customers via WhatsApp after they place an order. Using this node, you provide the image URL and caption, and it delivers the image message directly to the customer's WhatsApp number.

Properties

Name Meaning
Instance ID Identifier of the Chatflow instance from which the message will be sent.
JID WhatsApp identifier of the recipient (usually phone number in a specific format).
Image URL URL of the image to be sent via WhatsApp.
Caption Optional text caption to accompany the image message.
Continue On Fail Boolean flag indicating whether to continue processing subsequent items if one fails.

Output

The node outputs an array of JSON objects, each representing the response from the Chatflow API for each input item processed. Each JSON object contains the API's response data, typically indicating success or failure and any relevant message details.

No binary data output is produced by this node.

Dependencies

  • Requires an API authentication token credential for the Chatflow API.
  • The node makes HTTP GET requests to the Chatflow API endpoint at https://app.chatflow.kz/ with specific paths depending on the message type.
  • Network connectivity to the Chatflow API service is necessary.
  • Timeout for API requests is set to 10 seconds with one retry attempt.

Troubleshooting

  • Common issues:

    • Invalid or missing Instance ID or JID will cause the API request to fail.
    • Incorrect or expired API token will result in authentication errors.
    • Malformed or inaccessible Image URL may cause the message not to be delivered.
    • Network timeouts or connectivity problems can interrupt message sending.

  • Error handling:

    • If "Continue On Fail" is enabled, the node will capture errors per item and include them in the output without stopping execution.
    • Without "Continue On Fail," the node throws an error immediately upon failure.
    • Error messages returned from the API are included in the output JSON under a message field.

Links and References

Discussion