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 customer notifications, alerts, or multimedia messaging campaigns.

For the Audio operation specifically, the node sends an audio message to a specified WhatsApp contact by providing a URL to the audio file. This can be used in scenarios like sending voice notes, promotional audio clips, or recorded messages automatically.

Properties

Name Meaning
Instance ID Identifier of the Chatflow instance to use for sending the message.
JID The WhatsApp JID (phone number with country code) of the recipient.
Audio URL URL pointing to the audio file to be sent as a WhatsApp audio message.
Continue On Fail Whether to continue processing subsequent items if sending fails for one item (true or 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 response data indicating success or failure of the message send request.

No binary data is output by this node; all responses are JSON formatted.

Example output JSON structure:

{
  "success": true,
  "messageId": "some-message-id",
  "status": "sent"
}

or on failure:

{
  "success": false,
  "message": "Error message describing the failure"
}

Dependencies

  • Requires an API key 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-audio.
  • Network access to the Chatflow API service must be available.
  • Proper configuration of the API token credential within n8n is necessary.

Troubleshooting

  • Common issues:

    • Invalid or missing Instance ID or JID will cause the API request to fail.
    • Incorrect or inaccessible Audio URL may result in message not being delivered.
    • Network connectivity problems or incorrect API token will cause authentication errors.

  • Error messages:

    • "Request failed": Generic failure, check network, credentials, and parameters.
    • API error messages returned in the response's message field should be reviewed for specific causes.

  • Resolution tips:

    • Verify that the Instance ID and JID are correct and active.
    • Ensure the Audio URL is publicly accessible and points to a valid audio file.
    • Confirm the API token credential is correctly set up and has required permissions.
    • Enable "Continue On Fail" cautiously to handle partial failures gracefully.

Links and References

  • Chatflow API Documentation (official site, refer to API docs for detailed usage)
  • WhatsApp Business API concepts for understanding JIDs and message types

Discussion