NotificaMe Hub icon

NotificaMe Hub

Integração com NotificaMe Hub API

Actions31

Overview

This n8n node allows you to send various types of message templates via Facebook Messenger using the NotificaMe Hub API. The "Enviar Template" (Send Template) operation for the "Messenger" resource supports sending interactive messages such as buttons, coupons, customer feedback requests, and receipts to Messenger users. This is useful for automating customer engagement, marketing campaigns, order confirmations, and post-purchase surveys directly through Messenger.

Practical examples:

  • Sending a message with quick-reply buttons to guide user choices.
  • Delivering discount coupons to customers.
  • Requesting customer feedback after a purchase.
  • Sending detailed receipts with order information.

Properties

Below are the input properties relevant to the "Messenger" resource and "Enviar Template" operation:

Common Properties

  • ID Do Canal (string, required): ID do canal do Messenger.
    Messenger channel ID.

  • ID Do Destinatário (string, required): ID do destinatário no Messenger.
    Recipient's Messenger ID.

  • Tipo Do Template (options, required): Tipo do template a ser enviado.
    Type of template to send.
    Options:

    • Botões (button): Simple button template.
    • Cupom (coupon): Discount coupon template.
    • Avaliação (customer_feedback): Customer satisfaction survey.
    • Recibo (receipt): Purchase receipt.

If "Botões" (Button) Template Selected

  • Texto (string, required): Texto que será exibido junto com os botões.
    Text displayed with the buttons.

  • Botões (fixedCollection, up to 3): Lista de botões que serão exibidos.
    List of buttons (max 3). Each button includes:

    • Tipo (options): URL or Resposta (postback).
    • Título (string): Button text.
    • Valor (string): URL or postback value.

If "Cupom" (Coupon) Template Selected

  • Título Do Cupom (string, required): Título que será exibido no cupom.
    Coupon title.

  • Código Do Cupom (string, required): Código do cupom de desconto.
    Discount code.

If "Avaliação" (Customer Feedback) Template Selected

  • Título Da Avaliação (string, required): Título principal da avaliação.
    Main title for feedback.

  • Subtítulo Da Avaliação (string, required): Texto explicativo da avaliação.
    Subtitle/explanation.

  • Texto Do Botão (string, required): Texto que será exibido no botão de avaliação.
    Button text (default: "Avaliar").

  • URL Da Política De Privacidade (string, required): URL da política de privacidade do negócio.
    Privacy policy URL.

  • Dias Para Expirar (number, required): Número de dias até a avaliação expirar.
    Days until feedback expires (default: 3).

If "Recibo" (Receipt) Template Selected

  • Número Do Pedido (string, required): Número do pedido.
    Order number.

  • Moeda (string, required): Código da moeda (ex: BRL, USD).
    Currency code (default: BRL).

  • Método De Pagamento (string, required): Método de pagamento utilizado.
    Payment method.

  • URL Do Pedido (string, required): URL para acompanhamento do pedido.
    Order tracking URL.

  • Data Do Pedido (string, required): Data do pedido em timestamp.
    Order date (timestamp).

  • Endereço (fixedCollection): Campos do endereço.
    Address fields: Rua, Complemento, Cidade, CEP, Estado, País.

  • Resumo (fixedCollection): Valores do resumo.
    Summary: Subtotal, Frete, Impostos, Total.

  • Ajustes (fixedCollection, multiple): Ajuste(s) aplicados.
    Adjustments: Nome, Valor.

  • Produtos (fixedCollection, multiple): Produtos incluídos no recibo.
    Products: Título, Subtítulo, Quantidade, Preço, Moeda, URL Da Imagem.

  • Nome Do Cliente (string, required): Nome do cliente que realizou a compra.
    Customer name.

Output

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

{
  "success": true,
  "messageId": "string",
  "details": { ... }
}
  • success: Indicates if the message was sent successfully.
  • messageId: Unique identifier for the sent message.
  • details: Additional information about the request or 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 configure the notificamehubApi credential in n8n with your API key/token.
  • n8n Configuration: Ensure the node is properly authenticated and that the Messenger channel and recipient IDs are valid.

Troubleshooting

Common Issues:

  • Invalid Channel or Recipient ID: Ensure both IDs are correct and correspond to active Messenger accounts.
  • Missing Required Fields: Depending on the template type, some fields are mandatory. Double-check all required fields for the selected template.
  • API Authentication Errors: Make sure your API credentials are correctly set up in n8n.
  • Template Type Mismatch: Some fields only apply to specific template types; ensure you select the correct template and fill in the corresponding fields.

Common Error Messages:

  • "Invalid channelId or recipientId": Check that both IDs are correct and exist.
  • "Missing required property: ...": Fill in all required fields for the chosen template type.
  • "Authentication failed": Verify your NotificaMe Hub API credentials in n8n.

Links and References

Discussion