WSAPI Message

Send and manage WhatsApp messages via WSAPI

Actions16

Overview

This node enables sending and managing WhatsApp messages through a WSAPI (WhatsApp Service API). Specifically, the Send Reaction operation allows users to react to an existing WhatsApp message with an emoji. This is useful for automating quick feedback or acknowledgments on messages in WhatsApp chats without sending a separate text message.

Practical examples include:

  • Automatically reacting with a thumbs-up emoji to confirm receipt of important messages.
  • Sending custom emoji reactions based on message content or workflow logic.
  • Integrating WhatsApp reactions into customer support workflows to acknowledge customer queries.

Properties

Name Meaning
Reaction Recipient WhatsApp ID (phone number with @s.whatsapp.net) where the message to react to is located.
Message ID ID of the specific message to which the reaction will be sent.
Sender ID WhatsApp ID of the original sender of the message being reacted to.
Reaction Emoji The emoji character used as the reaction (e.g., 👍).

Output

The node outputs a JSON object representing the response from the WSAPI after sending the reaction. This typically includes confirmation details about the reaction sent, such as status or metadata returned by the API.

No binary data output is involved in this operation.

Dependencies

  • Requires connection to a WSAPI service that manages WhatsApp messaging.
  • Needs an API key credential and instance identifier configured in n8n credentials for authentication.
  • The WSAPI base URL and authentication headers are used to send HTTP POST requests to the endpoint /messages/{messageId}/reaction.

Troubleshooting

  • Common issues:

    • Invalid or missing WhatsApp IDs (reactionTo or senderId) can cause errors.
    • Incorrect or expired API keys or instance IDs will result in authentication failures.
    • Using an invalid or non-existent messageId will cause the API to reject the reaction request.
    • Unsupported or malformed emoji characters may not be accepted by the API.

  • Error messages:

    • Authentication errors usually indicate problems with API key or instance ID configuration.
    • "Message not found" or similar errors suggest the messageId does not exist or is inaccessible.
    • Validation errors may occur if required fields are missing or incorrectly formatted.

  • Resolutions:

    • Verify all WhatsApp IDs follow the correct format (e.g., phone number + @s.whatsapp.net).
    • Ensure API credentials are correctly set up and valid.
    • Confirm the target message exists and the messageId is accurate.
    • Use standard Unicode emojis for reactions.

Links and References

Discussion