NotificaMe Hub icon

NotificaMe Hub

Integração com NotificaMe Hub API

Actions31

Overview

The NotificaMe Hub node for n8n, when configured with the "WhatsApp" resource and the "Enviar Botões" (Send Buttons) operation, allows you to send interactive WhatsApp messages containing up to three custom buttons to a specified recipient. This is particularly useful for automating customer engagement, support workflows, or marketing campaigns where you want recipients to quickly respond by tapping on predefined options.

Practical examples:

  • Sending a message to a customer with quick-reply buttons like "Confirm", "Reschedule", or "Cancel".
  • Automating surveys or feedback collection via WhatsApp.
  • Providing users with easy navigation options in conversational bots.

Properties

Below are the input properties required for this operation:

Display Name Type Description
Token Do Canal String (Secret) Token do canal do WhatsApp. Required for authenticating API requests to NotificaMe Hub.
Número Do Destinatário String Número do destinatário no formato internacional (ex: 5511999999999). The recipient's number.
Texto Da Mensagem String (Multi) Texto principal da mensagem. The main body text of the WhatsApp message.
Botões Collection Botões que serão exibidos na mensagem (máximo 3). Define up to 3 buttons for the message.

Each button within "Botões" requires:

  • ID: Unique identifier for the button.
  • Título: Text displayed on the button.

Output

The node outputs a json object containing the response from the NotificaMe Hub API after attempting to send the WhatsApp message with buttons. The structure typically includes:

{
  "success": true,
  "messageId": "string",
  "status": "sent",
  "details": { /* ... */ }
}
  • success: Indicates if the message was sent successfully.
  • messageId: Unique ID of the sent message.
  • status: Status of the message (e.g., "sent", "queued").
  • details: Additional information or metadata returned by the API.

Note: The exact output fields may vary depending on the API response.

Dependencies

  • External Service: Requires access to the NotificaMe Hub API.
  • API Key: You must provide a valid "Token Do Canal" (channel token) for authentication.
  • n8n Credentials: The node expects a credential named notificamehubApi to be configured in n8n.

Troubleshooting

Common Issues:

  • Invalid Token Do Canal: If the channel token is incorrect or expired, the API will reject the request. Ensure your credentials are up-to-date.
  • Número Do Destinatário Format: The recipient number must be in international format (e.g., 5511999999999). Omitting country code or using an invalid format will cause errors.
  • Botões Limit: You can only add up to 3 buttons. Exceeding this limit will result in validation errors.
  • Missing Required Fields: All fields are required. Leaving any blank will prevent the node from executing.

Error Messages & Resolutions:

  • "Limite máximo de 3 botões atingido": Reduce the number of buttons to 3 or fewer.
  • "Unauthorized" or similar: Check your "Token Do Canal" and ensure it is correct.
  • "Invalid recipient number": Verify the phone number format.

Links and References

Discussion