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 supports administrative tasks like creating and listing instances, managing webhooks, updating profiles, and sending both text and various types of media messages (images, videos, documents, audio, voice notes, stickers).
A common use case is automating WhatsApp communications in workflows, such as sending notifications, alerts, or multimedia content to contacts or groups programmatically. For example, a business could automatically send promotional images or documents to customers or update instance settings without manual intervention.
Specifically, the "Enviar mídia" operation under the "Enviar Mensagem" resource allows sending different media types to a recipient by specifying the media type, file URL or Base64 content, and optional captions or document names.
Properties
| Name | Meaning |
|---|---|
| Url | Base URL of the uazapiGO API endpoint. |
| 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 or caption for media messages. |
| Tipo de Mídia | Type of media to send. Options: Image, Video, Document, Audio, Voice Message (PTT), 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 for Document media type). |
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 typically includes status information about the message sent or the action performed.
If the operation involves sending media, the output JSON confirms the successful dispatch or details any errors returned by the API.
No binary data output is produced by this node; all responses are JSON-formatted.
Dependencies
- Requires access to the uazapiGO API via its base URL.
- Needs a valid authentication token for the target WhatsApp instance (provided as a parameter, not as a secured credential).
- The node optionally uses an admin token credential for administrative operations.
- HTTP requests are made with JSON payloads and expect JSON responses.
Troubleshooting
- Missing or invalid token: If the instance token is missing or incorrect, API calls will fail authentication. Ensure the token parameter is correctly set.
- Invalid URL format: The base URL must be a valid HTTPS URL. The node sanitizes the URL but ensure it is correct and reachable.
- Unsupported media type or missing file: When sending media, ensure the media type matches the file content and that the file URL or Base64 string is valid and accessible.
- API errors: The node throws errors if the API returns failure responses. Check the error message for details and verify parameters.
- Credential errors for admin operations: Admin operations require an admin token credential; absence leads to errors.
- Network issues: Connectivity problems to the API endpoint will cause request failures.
To resolve errors, verify all required parameters, tokens, and URLs, and consult the API documentation for valid values.
Links and References
- uazapiGO API Documentation (Unofficial) (Assumed official API site based on default URL)
- n8n HTTP Request Node documentation for understanding request/response handling: https://docs.n8n.io/nodes/n8n-nodes-base.httpRequest/