WAHA API icon

WAHA API

Complete WhatsApp automation with WAHA API - Multi-engine support
Join our community

Actions55

Overview

This node integrates with the WAHA API to automate WhatsApp messaging and session management. Specifically, the "React Message" operation allows users to send emoji reactions to existing WhatsApp messages within a specified chat. This is useful for quickly acknowledging or responding to messages without sending a full text reply.

Practical scenarios include:

  • Automatically reacting to customer messages in support chats.
  • Adding emoji reactions as part of workflow automation to indicate message status.
  • Enhancing chatbot interactions by providing quick feedback via reactions.

Properties

Name Meaning
Session Name The name of the WhatsApp session to use (defaults to a configured default session).
Chat ID The WhatsApp chat identifier where the message exists (e.g., phone number with @c.us or group ID).
Message ID The unique identifier of the message to which the reaction will be sent.
Additional Fields Collection of optional fields including:
- Reaction: Emoji character to send (default 👍).

Output

The node outputs a JSON object representing the response from the WAHA API after attempting to react to the message. This typically includes confirmation of the reaction being sent or error details if the operation failed.

No binary data output is involved in this operation.

Example output JSON structure:

{
  "success": true,
  "messageId": "some-message-id",
  "reaction": "👍"
}

Dependencies

  • Requires an active WAHA API credential with a valid base URL and API key.
  • Requires a secondary API key credential for the n8n Tools API used for subscription validation.
  • The WhatsApp session referenced by "Session Name" must be active and connected.
  • Proper configuration of the WhatsApp session and permissions to react to messages.

Troubleshooting

  • Invalid Credentials: If the node throws errors related to API key validation, verify that both the WAHA API and n8n Tools API credentials are correctly set and active.
  • Unknown Operation or Resource: Errors indicating unknown operations or resources suggest misconfiguration of the "Resource" or "Operation" parameters.
  • Message Not Found: If the message ID does not exist or is invalid, the API may return an error. Ensure the correct message ID is provided.
  • Session Issues: If the session is inactive or disconnected, reactions cannot be sent. Verify session status before running the node.
  • Emoji Reaction Format: The reaction must be a valid emoji string; otherwise, the API might reject it.

Links and References

Discussion