NotificaMe Hub icon

NotificaMe Hub

Integração com NotificaMe Hub API

Actions31

Overview

This node integrates with the NotificaMe Hub API to send WhatsApp list messages. It allows users to send interactive WhatsApp messages containing a header, body text, a button, and multiple sections of selectable list items. This is useful for scenarios such as customer support menus, product catalogs, or any situation where you want to present a structured list of options to a recipient on WhatsApp.

For example, a business can use this node to send a menu of services or products where the recipient can select an option from categorized lists directly within WhatsApp, improving engagement and user experience.

Properties

Name Meaning
Token Do Canal The WhatsApp channel token used for authentication with the NotificaMe Hub API. This is a required secret string.
Número Do Destinatário The recipient's phone number in international format (e.g., 5511999999999). This specifies who will receive the message.
Texto Do Cabeçalho The header text displayed at the top of the WhatsApp message. Maximum length is 60 characters.
Texto Da Mensagem The main body text of the message. Maximum length is 1024 characters.
Texto Do Botão The label text for the button that opens the list of options. Maximum length is 20 characters. Default is "Ver opções" ("See options").
Seções One or more sections containing list items. Each section has:
- Título Da Seção: Title of the section.
- Itens Da Lista: List of items in the section, each with:
  • ID (unique identifier)
  • Título (title, max 24 chars)
  • Descrição (optional description, max 72 chars)

The "Seções" property supports multiple sections (1 to 10), each with multiple items (1 to 10).

Output

The node outputs JSON data representing the response from the NotificaMe Hub API after sending the WhatsApp list message. This typically includes confirmation details such as message IDs, status, or error information if the request failed.

No binary data output is indicated for this operation.

Dependencies

  • Requires a valid WhatsApp channel token for authentication with the NotificaMe Hub API.
  • The node uses the NotificaMe Hub API endpoint https://hub.notificame.com.br/v1.
  • Proper configuration of the API key credential in n8n is necessary to authenticate requests.

Troubleshooting

  • Invalid Token or Authentication Errors: Ensure the provided WhatsApp channel token is correct and active.
  • Incorrect Recipient Number Format: The recipient number must be in international format without spaces or symbols (e.g., 5511999999999).
  • Message Length Limits Exceeded: Header text must not exceed 60 characters, body text 1024 characters, button text 20 characters, item titles 24 characters, and descriptions 72 characters. Violating these limits may cause API errors.
  • Empty Sections or Items: At least one section with one item is required. Omitting these will likely result in validation errors.
  • API Rate Limits or Network Issues: Temporary failures might occur due to network problems or API rate limiting; retrying later may help.

Links and References

Discussion