UAZAPI icon

UAZAPI

Integração com a API UAZAPI para WhatsApp Business

Actions3

Overview

This node integrates with the UAZAPI service to send WhatsApp messages via the WhatsApp Business API. Specifically, for the Mensagem (Message) resource and the Enviar Mídia (Send Media) operation, it allows users to send media files such as images, videos, audio, or documents to a specified phone number.

Common scenarios where this node is beneficial include:

  • Sending promotional images or videos to customers.
  • Sharing audio clips or voice notes automatically.
  • Delivering important documents or PDFs directly through WhatsApp.
  • Adding captions to media messages for better context.

For example, a business could automate sending product brochures (PDFs) or promotional videos to clients who opt-in via WhatsApp.

Properties

Name Meaning
Número Do Telefone The recipient's phone number including country code (e.g., 5511999999999).
URL Da Mídia The URL of the media file to be sent (image, video, audio, or document).
Tipo De Mídia The type of media file. Options: Imagem (image), Vídeo (video), Áudio (audio), Documento (document).
Legenda Optional caption text to accompany the media file.
Token Da Instância Name or ID Select or specify the instance token that authenticates the WhatsApp instance used to send the message.

Output

The node outputs JSON data representing the response from the UAZAPI after attempting to send the media message. The structure typically includes:

  • success: Boolean indicating if the request was successful.
  • message: A string message returned by the API.
  • Other raw response fields depending on the API reply.

If an error occurs, the output JSON will contain an error field with the error message.

The node does not output binary data; it only returns JSON responses from the API.

Dependencies

  • Requires an administrative API credential configured in n8n with access to the UAZAPI service.
  • The node uses the subdomain and admin token from these credentials to build the base URL for API requests.
  • The user must select or provide a valid instance token representing the WhatsApp instance authorized to send messages.
  • Internet connectivity to reach the UAZAPI endpoints.

Troubleshooting

  • Missing Credentials: If the administrative API credentials are not set or incomplete (missing subdomain or token), the node will throw an error indicating credentials are missing. Ensure credentials are properly configured in n8n.
  • Invalid Instance Token: Selecting an invalid or disconnected instance token will cause the API call to fail. Verify the instance token is active and connected.
  • Incorrect Phone Number Format: The phone number must include the country code without symbols or spaces (e.g., 5511999999999). Invalid formats may result in message delivery failure.
  • Media URL Accessibility: The media URL must be publicly accessible by the UAZAPI servers. Private or protected URLs will cause the media sending to fail.
  • API Errors: Any errors returned by the UAZAPI will be included in the output JSON under the error field. Review the error message for details.

Links and References

This summary is based solely on static analysis of the provided source code and property definitions.

Discussion