Actions18
- Administração Actions
- Instancia Actions
- Perfil Actions
- Webhooks e SSE Actions
- Enviar Mensagem Actions
Overview
This node integrates with the unofficial uazapiGO API to manage WhatsApp instances and send messages, including media files. It is useful for automating WhatsApp communications such as sending text messages or various types of media (images, videos, documents, audio, voice notes, stickers) to contacts in international format.
A practical example is using this node to send promotional images or documents to customers automatically, or to send quick audio messages without manual intervention. It also supports managing WhatsApp instances, profiles, and webhooks, making it a versatile tool for WhatsApp automation workflows.
Specifically, the "Enviar mídia" operation under the "Enviar Mensagem" resource allows sending different media types by specifying the media type, file URL or Base64 content, and optional document name.
Properties
| Name | Meaning |
|---|---|
| Url | Base URL of the uazapiGO API (default: https://api.uazapigo.com). |
| Token da Instância | Authentication token for the specific WhatsApp instance (not a credential). |
| Número do Destinatário | Recipient's phone number in international format. |
| Texto da Mensagem | Message content; used as caption for media messages. |
| Tipo de Mídia | Type of media to send. Options: Imagem (image), Vídeo (video), Documento (document), Áudio (audio), Mensagem de Áudio (PTT - voice note), Figurinha (sticker). |
| Arquivo (URL ou Base64) | URL or Base64 string of the media file to be sent. |
| Nome do Arquivo | Filename shown to the user (only applicable when media type is Documento/document). |
Output
The node outputs an array of JSON objects corresponding to each input item processed. Each output JSON contains the response from the uazapiGO API call, which includes details about the message sending status or other requested operations.
If the operation involves sending media, the output JSON reflects the API's confirmation or error messages related to that media transmission.
No binary data output is produced by this node.
Dependencies
- Requires access to the uazapiGO API endpoint specified by the "Url" property.
- Requires a valid authentication token for the WhatsApp instance ("Token da Instância").
- No internal n8n credentials are mandatory, but an API key credential can optionally be configured for admin operations.
- The node uses HTTP requests to communicate with the API.
Troubleshooting
- Missing or invalid token: If the token parameter is missing or incorrect, the API will reject requests. Ensure the token is correctly set for the instance.
- Invalid recipient number format: The recipient number must be in international format; otherwise, the API may return errors.
- Incorrect media file URL/Base64: If the media file link is broken or Base64 content is malformed, the media sending will fail.
- API endpoint unreachable: Verify the base URL is correct and accessible from your environment.
- Error responses from API: The node returns API error messages in the output JSON under
errorfields if continueOnFail is enabled; otherwise, execution stops on error.
To resolve issues, verify all required parameters, check network connectivity, and consult the API documentation for error codes.
Links and References
- uazapiGO API Documentation (Unofficial) (Assumed official site based on default URL)
- WhatsApp international phone number formatting guidelines
- n8n HTTP Request node documentation for understanding request/response handling