Overview
This node integrates with the Uzapi Business API to send WhatsApp messages. It supports sending different types of messages such as text, images, audio, video, and documents to specified recipients. This node is useful for automating communication workflows where businesses need to send notifications, alerts, or multimedia content directly via WhatsApp.
Practical examples include:
- Sending order confirmations or shipping updates as text messages.
- Sharing promotional images or videos with customers.
- Delivering audio instructions or documents like invoices or contracts.
Properties
| Name | Meaning |
|---|---|
| Destinatário | Recipient's phone number including country code (e.g., 5511999998888). |
| Tipo de Mensagem | Type of message to send: Text, Image, Audio, Video, Document. |
| Texto | Text content of the message (required if message type is Text). |
| Preview de URL | Enable or disable URL preview in text messages (boolean). |
| Link da Imagem | URL of the image to be sent (required if message type is Image). |
| Legenda da Imagem | Optional caption for the image. |
| Link do Áudio | URL of the audio file to be sent (required if message type is Audio). |
| Legenda do Áudio | Optional caption for the audio. |
| Link do Vídeo | URL of the video to be sent (required if message type is Video). |
| Legenda do Vídeo | Optional caption for the video. |
| Link do Documento | URL of the document to be sent (required if message type is Document). |
Output
The node outputs an array of JSON objects representing the response from the Uzapi Business API for each message sent. Each output item typically contains details about the message delivery status, message ID, recipient, and any error information if applicable.
If binary data were involved (e.g., media files), it would be handled via URLs rather than direct binary output, so no binary output is expected here.
Dependencies
- Requires an API key credential for authenticating with the Uzapi Business API.
- The node depends on the external Uzapi Business API service to send WhatsApp messages.
- Proper configuration of credentials within n8n is necessary to authenticate requests.
- Network access to the URLs provided for media (images, audio, video, documents) must be available.
Troubleshooting
Common issues:
- Invalid or missing recipient phone number format may cause message sending failures.
- Incorrect or expired API credentials will result in authentication errors.
- Providing invalid or inaccessible URLs for media files will cause media message sending to fail.
- Unsupported message types or missing required fields for a given message type will trigger validation errors.
Error messages:
"Operation "sendMessage" não implementada"indicates the operation requested is not supported by the node; ensure the correct operation name is used.- Authentication errors usually indicate problems with the API key or credential setup.
- Media upload or sending errors often relate to invalid URLs or unsupported media formats.
To resolve these issues:
- Verify the phone number format includes the country code without spaces or special characters.
- Check that the API key credential is correctly configured and active.
- Ensure media URLs are publicly accessible and point to valid files.
- Confirm all required properties for the selected message type are provided.
Links and References
- Uzapi Business API Documentation (for detailed API usage and message formats)
- WhatsApp Business API Overview (general background on WhatsApp messaging APIs)