NotificaMe Hub icon

NotificaMe Hub

Integração com NotificaMe Hub API

Actions31

Overview

The "Messenger - Enviar Template" operation in this node allows sending various types of rich message templates through the Messenger platform. These templates include buttons, discount coupons, customer feedback surveys, and purchase receipts. This functionality is useful for businesses aiming to engage customers interactively via Messenger by providing actionable buttons, promotional offers, collecting feedback, or confirming orders.

Practical examples:

  • Sending a message with up to 3 interactive buttons (e.g., URL links or quick replies) to guide users.
  • Delivering a coupon template with a discount code to encourage purchases.
  • Requesting customer satisfaction feedback with a survey template.
  • Sending a detailed receipt template after a purchase, including order details, payment method, and shipping address.

Properties

Name Meaning
ID Do Canal The Messenger channel ID from which the message will be sent.
ID Do Destinatário The recipient's Messenger user ID who will receive the template message.
Tipo Do Template 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 template
Texto Text displayed alongside buttons (only for "Botões" template type).
Botões List of up to 3 buttons to display (only for "Botões" template type). Each button has:
• Tipo (type): URL or postback response
• Título (title): Button text
• Valor (value): URL or response text
Título Do Cupom Title shown on the coupon (only for "Cupom" template type).
Código Do Cupom Discount coupon code (only for "Cupom" template type).
Título Da Avaliação Main title of the feedback survey (only for "Avaliação" template type).
Subtítulo Da Avaliação Explanatory subtitle text for the feedback survey (only for "Avaliação" template type).
Texto Do Botão Text displayed on the feedback button (default "Avaliar") (only for "Avaliação" template type).
URL Da Política De Privacidade URL linking to the business's privacy policy (only for "Avaliação" template type).
Dias Para Expirar Number of days until the feedback survey expires (only for "Avaliação" template type).
Título Da Compra Title for the purchase confirmation (only for "Recibo" template type).
Subtítulo Da Compra Explanatory text about the purchase (only for "Recibo" template type).
Número Do Pedido Order number identifier (only for "Recibo" template type).
Moeda Currency code (e.g., BRL, USD) used in the receipt (only for "Recibo" template type).
Método De Pagamento Payment method used for the order (only for "Recibo" template type).
URL Do Pedido URL for tracking the order status (only for "Recibo" template type).
Data Do Pedido Timestamp date of the order (only for "Recibo" template type).
Endereço Address fields including street, complement, city, postal code, state, and country (default "BR") (only for "Recibo" template type).
Resumo Summary values including subtotal, shipping cost, taxes, and total cost (only for "Recibo" template type).
Ajustes Multiple adjustment entries with name and amount (only for "Recibo" template type).
Produtos List of products included in the receipt, each with title, subtitle, quantity, price, currency, and image URL (only for "Recibo" template type).
Nome Do Cliente Name of the customer who made the purchase (only for "Recibo" template type).

Output

The node outputs JSON data representing the result of the template message sending operation. This typically includes confirmation of the message dispatch, any message IDs returned by the Messenger API, and status information.

If the node supports binary data output (not indicated here), it would represent media content or attachments related to the message, but this operation focuses on structured template messages and thus primarily outputs JSON.

Dependencies

  • Requires an active connection to the Messenger platform via an API key or authentication token configured in n8n credentials.
  • The node uses the NotificaMe Hub API endpoint (https://hub.notificame.com.br/v1) as its backend service to send messages.
  • Proper configuration of the Messenger channel ID and recipient ID is necessary.
  • For some template types (e.g., customer feedback), external URLs such as privacy policy links must be valid and accessible.

Troubleshooting

  • Invalid Recipient ID: If the recipient ID is incorrect or not linked to the Messenger channel, the message will fail to send. Verify the recipient ID is accurate.
  • Missing Required Fields: Each template type requires specific fields (e.g., coupon code for coupon templates). Omitting these will cause errors. Ensure all required properties are filled.
  • Button Limits: The "Botões" template supports a maximum of 3 buttons. Adding more may cause rejection by the API.
  • Expired Feedback Survey: Setting the expiration days too low might cause the feedback link to expire before the user responds.
  • API Authentication Errors: Invalid or missing API credentials will prevent message sending. Confirm that the API key/token is correctly set in n8n.
  • Invalid URLs: URLs provided in buttons, privacy policy, or order tracking must be valid HTTPS links; otherwise, the message may be rejected or links broken.
  • Currency Codes: Use standard ISO currency codes (e.g., BRL, USD) to avoid formatting issues in receipts.

Links and References

Discussion