Uzapi icon

Uzapi

Interage com a API da Uzapi (WhatsApp)

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, files, audio, and video to specified phone numbers via WhatsApp.

The "Enviar Imagem" (Send Image) operation specifically allows users to send an image message to a WhatsApp number by providing the recipient's phone number, a link to the image, and an optional caption describing the image.

Common scenarios:

  • Sending promotional images or product photos to customers.
  • Sharing event flyers or invitations via WhatsApp.
  • Automating image-based notifications or alerts.

Example:
A marketing automation workflow sends a product catalog image to a list of customers by specifying their phone numbers and the image URL, optionally including a caption describing the product.

Properties

Name Meaning
Número (com DDI) Destination phone number including country code, e.g., 5511999998888
Descrição Caption or description of the image or file to be sent
Link URL link to the image file to be sent

Output

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

No binary data output is indicated for this operation.

Dependencies

  • Requires an active Uzapi API account and corresponding API key credential configured in n8n.
  • The node depends on the external Uzapi API endpoint specified by the base URL in credentials.
  • Network access to the provided image URL must be available for the API to fetch the image.

Troubleshooting

  • Common issues:

    • Invalid or missing phone number format may cause message sending failure.
    • Incorrect or inaccessible image URL will prevent the image from being sent.
    • Missing or invalid API credentials will result in authentication errors.
  • Error messages:

    • "Operation 'sendImage' não implementada" indicates the operation is not recognized; ensure the correct operation name is used.
    • Authentication errors suggest checking the API key credential configuration.
    • Network or timeout errors may require verifying internet connectivity and URL accessibility.

Links and References

  • Uzapi Official Website (for API documentation and account setup)
  • WhatsApp Business API documentation (general reference for message types and formats)

Discussion