NotificaMe Hub icon

NotificaMe Hub

Integração com NotificaMe Hub API

Actions31

Overview

This node operation allows you to send interactive list messages via WhatsApp using the NotificaMe Hub API. List messages are a type of WhatsApp message that present recipients with organized options grouped into sections, making it easier for them to select from multiple choices. This is particularly useful for customer support, surveys, menu selections, or any scenario where structured responses are needed.

Practical examples:

  • Sending a restaurant menu where each section represents a meal course and items represent dishes.
  • Providing a list of available services or appointment slots for users to choose from.
  • Offering troubleshooting steps or FAQs in an organized, selectable format.

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 requests to the NotificaMe Hub API.
Número Do Destinatário String Número do destinatário no formato internacional (ex: 5511999999999). The recipient's phone number in international format.
Texto Do Cabeçalho String Texto que aparecerá no cabeçalho da mensagem (máximo 60 caracteres). Header text for the message.
Texto Da Mensagem String (Multi-line) Texto principal da mensagem (máximo 1024 caracteres). Main body text of the message.
Texto Do Botão String Texto que será exibido no botão que abre a lista (máximo 20 caracteres). Button label shown to the user.
Seções Collection Seções de itens que serão exibidas na lista. Each section contains:
- Título Da Seção: Title of the section (required).
- Itens Da Lista: Items within the section, each with:
- ID: Unique identifier for the item (required).
- Título: Item title (max 24 characters, required).
- Descrição: Item description (max 72 characters, optional).

Output

The output will be a JSON object containing the response from the NotificaMe Hub API after attempting to send the WhatsApp list message. The structure typically includes:

{
  "success": true,
  "messageId": "string",
  "status": "sent",
  "details": { ... }
}
  • success: Indicates if the message was sent successfully.
  • messageId: Unique identifier for the sent message.
  • status: Status of the message (e.g., "sent", "queued").
  • details: Additional information returned by the API (may include error details if unsuccessful).

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

Dependencies

  • External Service: Requires access to the NotificaMe Hub API.
  • API Key: You must provide a valid WhatsApp channel token (Token Do Canal).
  • n8n Credentials: The node requires a credential named notificamehubApi to be configured in n8n.
  • Environment: Internet access to https://hub.notificame.com.br/v1.

Troubleshooting

Common Issues:

  • Invalid Token: If the Token Do Canal is incorrect or expired, the API will reject the request. Ensure your token is up-to-date.
  • Incorrect Phone Number Format: The recipient number must be in international format (e.g., 5511999999999). Double-check for typos or missing country codes.
  • Section/Item Limits: Exceeding the maximum allowed sections (10) or items per section (10) will result in validation errors.
  • Text Length Violations: Exceeding character limits for header, button, item titles, or descriptions will cause the API to return an error.

Error Messages & Resolutions:

  • "Invalid token": Check and update your WhatsApp channel token.
  • "Recipient not found": Verify the recipient's phone number format.
  • "Section/item limit exceeded": Reduce the number of sections/items.
  • "Text too long": Shorten the header, button, or item texts as per the specified limits.

Links and References

Discussion