Uzapi icon

Uzapi

Interage com a API da Uzapi (WhatsApp)

Actions7

Overview

This node integrates with the Uzapi API, a service for interacting with WhatsApp. It enables sending various types of messages such as text, links, images, audio, video, and files encoded in Base64 format. The specific operation "Enviar Arquivo Base64" allows users to send a file by providing its Base64-encoded content.

Common scenarios include automating WhatsApp communications for customer support, marketing campaigns, or notifications where sending multimedia files is required. For example, a business could automatically send PDF invoices or product brochures directly to customers' WhatsApp numbers.

Properties

Name Meaning
Número (com DDI) Destination phone number including country code (e.g., 5511999998888).
Descrição Description or caption of the image or file being sent.
Arquivo Path or identifier of the file to be sent in Base64 format (used specifically for this operation).

Output

The node outputs JSON data representing the response from the Uzapi API after attempting to send the message. This typically includes status information about the message delivery, such as success confirmation or error details.

If binary data is involved (e.g., when sending files), the node handles the Base64 encoding internally but does not output raw binary data; instead, it returns metadata and API response details.

Dependencies

  • Requires an active Uzapi API account and corresponding API key credential configured in n8n.
  • The node depends on the ApiClient class which manages communication with the Uzapi API endpoint.
  • Proper network access to the Uzapi API base URL is necessary.
  • The user must provide valid phone numbers in international format and ensure the files are accessible for Base64 encoding.

Troubleshooting

  • Operation Not Implemented Error: If an unsupported operation name is provided, the node throws an error indicating the operation is not implemented. Ensure the operation parameter matches one of the supported operations exactly.
  • Invalid Phone Number Format: Sending messages may fail if the phone number is incorrectly formatted or missing the country code.
  • File Access Issues: For the "Enviar Arquivo Base64" operation, if the specified file path is incorrect or inaccessible, the node will fail to read and encode the file.
  • API Authentication Errors: Missing or invalid API credentials will cause authentication failures. Verify that the API key credential is correctly set up in n8n.
  • Network Connectivity Problems: Ensure that the n8n instance can reach the Uzapi API endpoint without firewall or proxy issues.

Links and References

Discussion