NotificaMe Hub icon

NotificaMe Hub

Integração com NotificaMe Hub API

Actions31

Overview

The NotificaMe Hub node for n8n allows you to send interactive button messages via Instagram Direct using the "Enviar Botões" (Send Buttons) operation. This is particularly useful for automating customer engagement, support, or marketing workflows where you want to present users with up to three actionable buttons in a single message. For example, you could use this node to offer quick replies, direct users to external links, or collect responses efficiently within an Instagram chat.

Practical scenarios:

  • Sending a menu of options to a user after they contact your business on Instagram.
  • Providing quick access to FAQs, product pages, or support resources via buttons.
  • Automating follow-up actions based on which button the recipient clicks.

Properties

Below are the input properties supported by the "Instagram > Enviar Botões" operation:

Display Name Type Description
ID Do Canal String The channel ID for the Instagram account from which the message will be sent.
ID Do Destinatário String The recipient's Instagram user ID who will receive the message.
Texto String The text that appears above the buttons in the message.
Botões Fixed Collection (1–3 items) A list of up to 3 buttons to include in the message. Each button can have:
- Tipo Do Botão: Option (Link or Resposta Rápida).
- Título: String. The label shown on the button.
- URL: String. The URL to open when the button is of type Link.
- Resposta: String. The payload/message sent back when the button is of type Resposta Rápida.

Output

The output of this operation is a JSON object containing the result of the API call to NotificaMe Hub for sending the button message. While the exact structure may depend on the API response, it typically includes:

{
  "success": true,
  "messageId": "string",    // Unique identifier for the sent message
  "recipientId": "string",  // The Instagram user ID of the recipient
  "channelId": "string",    // The channel ID used to send the message
  "buttons": [              // Array of button objects as sent
    {
      "type": "web_url" | "postback",
      "title": "string",
      "url": "string",      // Present if type is 'web_url'
      "payload": "string"   // Present if type is 'postback'
    }
  ],
  "text": "string"          // The message text displayed above the buttons
}

Note: This node does not output binary data.

Dependencies

  • External Service: Requires access to the NotificaMe Hub API.
  • API Credentials: You must configure the notificamehubApi credential in n8n with valid API keys or tokens.
  • Environment: No special environment variables are required beyond standard n8n configuration.

Troubleshooting

Common Issues:

  • Invalid Channel or Recipient ID: If the provided IDs are incorrect, the API may return an error indicating the user or channel was not found.
  • Button Limit Exceeded: Attempting to add more than 3 buttons will result in a validation error ("Limite máximo de 3 botões atingido").
  • Missing Required Fields: Omitting required fields such as "Texto" or button details will cause the node to fail validation before making the API request.
  • Authentication Errors: If the API credentials are missing or invalid, you may see errors related to authentication or authorization.

Error Messages and Resolutions:

  • "Limite máximo de 3 botões atingido": Reduce the number of buttons to 3 or fewer.
  • "Invalid channelId or recipientId": Double-check the IDs provided.
  • "Missing required property": Ensure all required fields are filled in the node configuration.
  • "401 Unauthorized": Check your NotificaMe Hub API credentials in n8n.

Links and References

Discussion