WAHA API icon

WAHA API

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

Actions55

Overview

The node integrates with the WAHA API to automate WhatsApp messaging and session management. Specifically, the Reply Message operation under the Message resource allows users to send a text reply to an existing WhatsApp message within a chat.

This node is useful in scenarios such as:

  • Automatically responding to customer inquiries by replying directly to their messages.
  • Building chatbots that maintain conversational context by replying to specific messages.
  • Managing WhatsApp communications programmatically in workflows for support, marketing, or notifications.

For example, you can use this node to reply to a customer's question in a group or individual chat by specifying the chat ID, the original message ID, and the reply text.

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 reply will be sent. Format: phone@c.us or group ID.
Text The text content of the reply message to send.
Message ID The ID of the original message to which this reply is directed.
Additional Fields Optional extra parameters; not typically used for reply but available for other operations.

Output

The node outputs a JSON object representing the response from the WAHA API after sending the reply message. This typically includes details about the sent message such as message ID, status, timestamps, and any metadata returned by the API.

No binary data output is involved in this operation.

Example output structure (simplified):

{
  "id": "message-id",
  "status": "sent",
  "chatId": "5511999999999@c.us",
  "text": "Your reply text here",
  "timestamp": 1680000000
}

Dependencies

  • Requires a valid WAHA API credential with an API key and base URL configured in n8n.
  • Optionally uses an additional API key credential for N8N Tools API validation.
  • The node sends HTTP requests to the WAHA API endpoints.
  • The WhatsApp session must be active and connected for message sending.

Troubleshooting

  • Invalid subscription or API key error: If the node throws errors related to invalid API keys or subscription issues, verify that the WAHA API credentials and N8N Tools API credentials are correctly set up and active.
  • Unknown message operation: Ensure the operation parameter is set exactly to "replyMessage" when using this functionality.
  • Chat ID format errors: The chat ID must be in the correct format (phone number with @c.us suffix or a valid group ID).
  • Message ID missing or incorrect: The message ID must correspond to an existing message in the chat to reply properly.
  • Session not found or inactive: Verify that the specified WhatsApp session is running and connected.
  • Network or API errors: Check network connectivity and WAHA API service status if requests fail.

Links and References

Discussion