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 configure webhooks globally or per instance. Specifically, the "Administração" resource with the "Configurar Webhook Global" operation allows users to set a global webhook URL that will receive events from all WhatsApp instances managed by the system.
Common scenarios for this node include:
- Centralizing event handling by configuring a single webhook endpoint to receive updates from multiple WhatsApp instances.
- Automating the setup of webhook URLs and selecting which event types to monitor globally.
- Managing WhatsApp instances programmatically, including creating instances, updating administrative fields, and managing privacy settings.
Practical example:
- A user wants to receive real-time notifications about messages, calls, and contact changes across all WhatsApp instances in their system. They use this node to set a global webhook URL and select relevant event types such as "messages", "call", and "contacts". The configured webhook then receives these events for further processing or automation.
Properties
| Name | Meaning |
|---|---|
| Url | Base URL of the uazapiGO API (e.g., https://api.uazapigo.com). |
| URL do Webhook | The URL endpoint where webhook events will be sent. |
| Eventos | List of event types to monitor on the webhook. Options include: Connection, History, Messages, Messages Update, Call, Contacts, Presence, Groups, Labels, Chats, Chat Labels, Blocks, Leads, Sender. |
Output
The node outputs an array of JSON objects representing the response from the uazapiGO API after performing the requested operation.
For the "Configurar Webhook Global" operation, the output JSON typically contains confirmation details of the webhook configuration, such as the URL set and the list of events registered.
No binary data is output by this node.
Example output snippet (conceptual):
{
"url": "https://meusite.com/webhook",
"events": ["messages", "call", "contacts"],
"status": "success"
}
Dependencies
- Requires access to the uazapiGO API.
- For "admin" resource operations, an admin API token credential must be configured in n8n and available to the node.
- The base API URL can be customized but defaults to
https://api.uazapigo.com. - No other external dependencies are required.
Troubleshooting
- Missing Admin Credentials: If the node throws an error indicating admin credentials are not found, ensure that the admin API token credential is properly set up in n8n and linked to the node.
- Invalid Webhook URL: The webhook URL must be a valid HTTPS URL. Ensure it starts with
https://and is reachable from the internet. - Empty Events Array: If no events are selected, the webhook may not receive any notifications. Select at least one event type to monitor.
- API Errors: Any HTTP errors returned by the uazapiGO API will be surfaced. Check the API documentation and verify the parameters sent.
- Continue On Fail: If enabled, the node will continue processing subsequent items even if one fails, returning error details in the output.
Links and References
- uazapiGO Official API Documentation (hypothetical link, replace with actual if available)
- n8n HTTP Request Node Documentation
- Webhook Concepts in WhatsApp Automation (for general understanding)