NotificaMe Hub icon

NotificaMe Hub

Integração com NotificaMe Hub API

Overview

The "Enviar Template" operation for the WhatsApp resource allows sending pre-approved WhatsApp message templates to recipients. This is useful in scenarios where businesses want to send standardized notifications, alerts, or messages that comply with WhatsApp's template messaging policies. For example, a company can use this node to send appointment reminders, shipping updates, or promotional messages using predefined templates.

Practical examples:

  • Sending a delivery status update using a shipping notification template.
  • Sending an appointment confirmation template to customers.
  • Sending a payment reminder template with dynamic parameters.

Properties

Name Meaning
Token Do Canal The authentication token for the WhatsApp channel used to authorize sending messages.
Número Do Destinatário The recipient's phone number in international format (e.g., 5511999999999).
Nome Do Template The name of the WhatsApp message template to be sent.
Idioma The language code of the template. Options: Português (Brasil) (pt_BR), Inglês (EUA) (en_US), Espanhol (es).
Componentes Components of the template with their parameters. Multiple components can be specified, each with a type and parameters.

Details on "Componentes" property:

  • Tipo (Type): The component type within the template. Options include:

    • Cabeçalho (HEADER)
    • Corpo (BODY)
    • Rodapé (FOOTER)
    • Botões (BUTTONS)
  • Parâmetros (Parameters): Parameters for the component, which can be multiple. Each parameter has:

    • Tipo De Parâmetro (Parameter Type): The type of parameter value. Options:
      • Documento (document)
      • Imagem (image)
      • Localização (location)
      • Texto (text)
      • Vídeo (video)
    • Usar Nome Do Parâmetro (Use Parameter Name): Boolean indicating whether to use the parameter name instead of position (only for text type).
    • Nome Do Parâmetro (Parameter Name): Name of the parameter (e.g., name, value, date) if using named parameters.
    • Texto (Text): Text value for text parameters; supports expressions like {{ $json.field }}.
    • Link Da Mídia (Media URL): URL for media files (image, video, document).
    • Latitude, Longitude, Nome Do Local, Endereço: Location details for location parameters.

Output

The node outputs JSON data representing the response from the WhatsApp API after attempting to send the template message. This typically includes message IDs, status, and any error information returned by the API.

If the node supports binary data output (not explicitly indicated here), it would represent media content or attachments related to the message.

Dependencies

  • Requires a valid WhatsApp channel token for authentication.
  • The node communicates with the NotificaMe Hub API endpoint at https://hub.notificame.com.br/v1.
  • Proper configuration of the API token credential in n8n is necessary.
  • Internet access to reach the external API service.

Troubleshooting

  • Invalid Token or Authentication Errors: Ensure the provided channel token is correct and active.
  • Incorrect Recipient Number Format: The recipient number must be in international format without spaces or special characters.
  • Template Name Not Found or Not Approved: Verify that the template name exists and is approved in the WhatsApp Business account.
  • Parameter Mismatch: Ensure the components and parameters match the template definition exactly, including types and order.
  • API Rate Limits or Quotas: If too many requests are sent, the API may reject further messages temporarily.
  • Network Issues: Confirm network connectivity to the API endpoint.

Common error messages usually come from the API response and should be inspected in the node output for troubleshooting.

Links and References

Discussion