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. Users provide necessary identifiers such as an instance ID and a JID (WhatsApp identifier), along with the content to send. The node is useful for automating WhatsApp communications in workflows, such as sending notifications, alerts, or media files to users.

For example, you can use this node to:

  • Send a plain text message to a customer.
  • Share an audio clip or video as part of a marketing campaign.
  • Deliver documents or images automatically based on workflow triggers.

Properties

Name Meaning
Instance ID Identifier of the Chatflow instance to send the message from.
JID WhatsApp identifier of the recipient (Jabber ID format).
Message Text content of the message to send (used only when operation is "Text").
Continue On Fail Whether to continue processing subsequent items if sending a message fails (true/false).

Output

The node outputs an array of JSON objects, each representing the response from the Chatflow API for each input item processed. Each output JSON contains the API's response data indicating success or failure of the message sending operation.

No binary data is output by this node.

Dependencies

  • Requires an API token credential for authenticating with the Chatflow API.
  • The node makes HTTP GET requests to the Chatflow API endpoint at https://app.chatflow.kz/api/v1/send-text (or corresponding endpoints for other message types).
  • Network access to the Chatflow API service is required.

Troubleshooting

  • Common issues:
    • Invalid or missing API token will cause authentication failures.
    • Incorrect Instance ID or JID may result in message delivery errors.
    • Network timeouts or connectivity issues can cause request failures.
  • Error handling:
    • If "Continue On Fail" is enabled, the node will return a JSON object with success: false and an error message instead of stopping execution.
    • Without "Continue On Fail", the node throws an error immediately on failure.
  • Resolution tips:
    • Verify that the API token credential is correctly configured.
    • Double-check Instance ID and JID values for correctness.
    • Ensure URLs provided for media (audio, video, document, image) are accessible and valid.

Links and References

Discussion