NotificaMe Hub icon

NotificaMe Hub

Integração com NotificaMe Hub API

Actions31

Overview

The NotificaMe Hub node for n8n enables integration with the NotificaMe Hub API, specifically allowing you to send files (documents, images, or videos) via WhatsApp. The "Enviar Arquivo" (Send File) operation is useful for automating the delivery of various file types to WhatsApp users, such as sending invoices, product images, promotional videos, or any other relevant documents directly to a recipient's WhatsApp number.

Practical examples:

  • Sending a PDF invoice to a customer after a purchase.
  • Delivering an image or video as part of a marketing campaign.
  • Sharing important documents with clients or team members via WhatsApp.

Properties

Below are the input properties required for the "WhatsApp > Enviar Arquivo" operation:

Display Name Type Description
Token Do Canal String Token do canal do WhatsApp. Required for authenticating requests to the WhatsApp channel.
Número Do Destinatário String Número do destinatário no formato internacional (ex: 5511999999999). The recipient's phone number in international format.
Tipo De Arquivo Options Tipo de arquivo a ser enviado. Select the type of file: Documento (document), Imagem (image), or Vídeo (video).
URL Do Arquivo String URL pública do arquivo a ser enviado. The public URL where the file to be sent is hosted.
Legenda String Legenda opcional para o arquivo. An optional caption to accompany the file.

Output

The node outputs a json object containing the response from the NotificaMe Hub API after attempting to send the file via WhatsApp. While the exact structure may depend on the API's response, it typically includes fields such as:

{
  "success": true,
  "messageId": "string",
  "status": "sent",
  "recipient": "5511999999999",
  "fileType": "document",
  "fileUrl": "https://example.com/file.pdf",
  "caption": "Optional caption"
}
  • success: Indicates if the operation was successful.
  • messageId: Unique identifier for the sent message.
  • status: Status of the message (e.g., "sent").
  • recipient: The recipient's WhatsApp number.
  • fileType: The type of file sent.
  • fileUrl: The URL of the file that was sent.
  • caption: The caption sent with the file (if provided).

Note: If the API returns additional fields, they will also be included in the output.

Dependencies

  • External Service: Requires access to the NotificaMe Hub API.
  • API Key: You must provide a valid "Token Do Canal" for authentication.
  • n8n Credentials: The node expects a credential named notificamehubApi to be configured in n8n.
  • File Hosting: The file to be sent must be accessible via a public URL.

Troubleshooting

Common Issues:

  • Invalid Token Do Canal:
    Error Message: "Unauthorized" or "Invalid token."
    Resolution: Ensure the channel token is correct and has permission to send messages.

  • Incorrect Número Do Destinatário Format:
    Error Message: "Invalid recipient number format."
    Resolution: Use the full international format without spaces or special characters (e.g., 5511999999999).

  • Inaccessible URL Do Arquivo:
    Error Message: "File not found" or "Unable to fetch file."
    Resolution: Make sure the file URL is publicly accessible and does not require authentication.

  • Unsupported File Type:
    Error Message: "Unsupported file type."
    Resolution: Only use supported file types: document, image, or video.

  • Missing Required Fields:
    Error Message: "Missing required parameter: ..."
    Resolution: Ensure all required fields are filled in.

Links and References

Discussion