NotificaMe Hub icon

NotificaMe Hub

Integração com NotificaMe Hub API

Overview

The NotificaMe Hub node for n8n, when configured with the "WhatsApp" resource and the "Enviar Template" operation, allows you to send pre-approved WhatsApp message templates to recipients. This is particularly useful for businesses that need to automate sending notifications, alerts, confirmations, or marketing messages via WhatsApp using template messages.

Common scenarios:

  • Sending appointment reminders to customers.
  • Notifying users about order status updates.
  • Delivering promotional messages or important alerts in a standardized format.

Practical example:
A business can use this node to automatically send a payment confirmation template to a customer after a successful transaction, personalizing the message with dynamic parameters such as the customer's name and payment amount.


Properties

Below are the input properties supported by this operation:

Display Name Type Description
Token Do Canal String (Password) Token do canal do WhatsApp. Required for authenticating API requests.
Número Do Destinatário String Número do destinatário no formato internacional (ex: 5511999999999). The recipient's phone number in international format.
Nome Do Template String Nome do template a ser enviado. The name of the WhatsApp template to be sent.
Idioma Options Idioma do template. Language of the template. Options: Português (Brasil), Inglês (EUA), Espanhol. Default: Português (Brasil).
Componentes Fixed Collection Componentes do template com seus parâmetros. Allows specifying template components (header, body, footer, buttons) and their parameters. Each component can have multiple parameters, which can be referenced by name or position.

Output

The output will contain a json field with the response from the NotificaMe Hub API regarding the template message sent. While the exact structure depends on the API's response, it typically includes:

  • status: Indicates if the message was sent successfully.
  • messageId: Unique identifier for the sent message.
  • recipientNumber: The phone number to which the message was sent.
  • templateName: The name of the template used.
  • details: Any additional information or error details provided by the API.

Note: If the API returns binary data (e.g., media files), the node may also output binary fields, but for this operation (sending templates), the output is expected to be JSON only.


Dependencies

  • External Service: Requires access to the NotificaMe Hub API.
  • API Key: You must provide a valid "Token Do Canal" for authentication.
  • n8n Credentials: The node uses a credential named notificamehubApi, which should be configured in your n8n instance.
  • Environment: Ensure your n8n instance can reach https://hub.notificame.com.br/v1.

Troubleshooting

Common Issues:

  • Invalid Token Do Canal:
    Error Message: "Unauthorized" or "Invalid token"
    Resolution: Double-check the channel token provided. Make sure it is active and correctly entered.

  • Número Do Destinatário Format Error:
    Error Message: "Invalid recipient number format"
    Resolution: Ensure the phone number is in the correct international format (e.g., 5511999999999).

  • Template Not Found:
    Error Message: "Template not found" or similar
    Resolution: Verify that the template name matches exactly with one of your approved WhatsApp templates.

  • Missing or Incorrect Parameters in Componentes:
    Error Message: "Missing parameter" or "Parameter type mismatch"
    Resolution: Check that all required parameters for the selected template are provided and correctly formatted.

  • Language Not Supported:
    Error Message: "Unsupported language code"
    Resolution: Use one of the supported language codes: pt_BR, en_US, es.


Links and References

Discussion