WaAPI icon

WaAPI

Interact with WaAPI API
Join our community

Actions85

Overview

This node allows sending a plain text message to a WhatsApp chat using the WaAPI service. It is useful for automating communication workflows where you want to programmatically send messages to individual contacts or groups on WhatsApp. Typical use cases include customer support notifications, alerts, reminders, or marketing messages.

For example, you can send a greeting message to a specific user or mention multiple users in a group chat by including their IDs in the message and mentions array.

Properties

Name Meaning
Id Instance ID (a numeric identifier for the WaAPI instance to use)
Chat Id The target chat's ID in the format <countrycode><usernumber>@c.us for individuals or @g.us for groups
Message The text content of the message to send. Can include mentions like @123456789 for group chats
Mentions Optional JSON array of contact IDs to mention in the message. Only works in group chats
Reply To Message Id Optional message ID to reply to, formatted as {fromMe}_{chatId}_{messageId}
Preview Link Boolean flag to enable or disable link previews in the message (default: true)

Output

The node outputs JSON data representing the response from the WaAPI after sending the 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.

Dependencies

  • Requires an active WaAPI API key credential configured in n8n.
  • Depends on the external WaAPI service endpoint at https://waapi.app/api/v1.
  • The node sends HTTP requests with JSON payloads to interact with the WaAPI.

Troubleshooting

  • Invalid Chat Id: If the chat ID format is incorrect or the chat does not exist, the API may return an error. Ensure the chat ID follows the correct pattern (<number>@c.us for individuals, <number>@g.us for groups).
  • Message Not Sent: Check that the API key credential is valid and has sufficient permissions.
  • Mentions Not Working: Mentions only work in group chats. Also, ensure the mentioned IDs are included both in the message text (with @) and in the mentions array.
  • Reply To Message Id Format: Must follow the exact format {fromMe}_{chatId}_{messageId}; otherwise, the reply feature will fail.
  • Link Preview Disabled: If links do not show previews, verify the Preview Link property is set to true.

Links and References

Discussion