Waha icon

Waha

Integration with Waha

Overview

This node integrates with the Waha messaging service to send text messages. It is designed to send a custom message to a specified recipient identified by their phone ID. This node is useful in scenarios where automated or programmatic sending of WhatsApp-like messages is needed, such as customer notifications, alerts, or marketing campaigns.

For example, you can use this node to:

  • Send order confirmation messages to customers.
  • Notify users about system alerts or updates.
  • Automate personalized greetings or reminders.

Properties

Name Meaning
Message The text content of the message to send.
To The recipient's phone ID to which the message will be sent.

Output

The node outputs an array of JSON objects, each corresponding to one input item processed. Each output object contains:

  • success: A boolean indicating whether the message was sent successfully.
  • response: The full response from the Waha API when the message is sent successfully.
  • In case of an error, the output JSON contains the error details returned by the request helper.

No binary data is produced by this node.

Dependencies

  • Requires an API key credential and session token for authenticating with the Waha API.
  • The base URL for the Waha API is also required from credentials.
  • The node uses HTTP POST requests to the /sendText endpoint of the Waha API.
  • Proper configuration of these credentials and network access to the Waha API endpoint is necessary.

Troubleshooting

  • Common issues:
    • Invalid or missing API key or session token will cause authentication failures.
    • Incorrect phone ID format may result in message delivery errors.
    • Network connectivity problems can prevent successful API calls.
  • Error messages:
    • Errors returned by the Waha API are passed through in the output JSON. Review these messages for specific causes.
    • If the node returns an error JSON instead of success, verify credentials and input parameters.
  • Resolution tips:
    • Double-check that the API key and session token are correctly set up in the node credentials.
    • Ensure the "To" field contains a valid recipient identifier recognized by the Waha service.
    • Test network connectivity to the Waha API endpoint.

Links and References

Discussion