Actions37
- Message Actions
- Media Actions
- Contact Actions
- Group Actions
- Instance Actions
- Webhook Actions
Overview
This node integrates with the Uazapi WhatsApp API to manage webhook configurations for a WhatsApp instance. Specifically, the Set Webhook operation allows users to configure a URL where WhatsApp event notifications (such as incoming messages or status updates) will be sent via webhooks.
Typical use cases include:
- Setting up a webhook URL to receive real-time WhatsApp message events and automate responses.
- Integrating WhatsApp messaging events into other systems like CRMs, helpdesk software, or custom workflows.
- Automating business processes triggered by WhatsApp interactions.
For example, a user can set a webhook URL that points to their server or an n8n webhook node to capture incoming WhatsApp messages and trigger further automation such as logging conversations or sending automated replies.
Properties
| Name | Meaning |
|---|---|
| Webhook URL | The URL endpoint where WhatsApp event notifications will be sent. |
| Additional Fields | Optional extra parameters to customize webhook behavior: |
| - Reply to Message ID | ID of a message to reply to (if applicable). |
| - Delay (seconds) | Delay before sending a message (in seconds). |
| - Disable Link Preview | Whether to disable link previews in messages (true/false). |
| - Mention Users | Comma-separated phone numbers to mention in messages. |
Output
The node outputs a JSON object containing the response from the Uazapi API after setting the webhook. This typically includes confirmation details about the webhook configuration.
Example output structure:
{
"status": "success",
"webhook": "https://your-webhook-url.com",
"instance": "instance_id",
"message": "Webhook set successfully"
}
No binary data is produced by this operation.
Dependencies
- Requires an active Uazapi WhatsApp API account.
- Needs an API key credential and authentication token configured in n8n credentials for Uazapi.
- The node sends requests to the Uazapi API endpoint specified in the credentials.
- Proper network access to the webhook URL must be ensured so that WhatsApp servers can reach it.
Troubleshooting
Common issues:
- Invalid or unreachable webhook URL: Ensure the URL is publicly accessible and uses HTTPS if required.
- Missing or incorrect API credentials: Verify that the API key and tokens are correctly configured.
- Network connectivity problems between n8n and Uazapi API or webhook endpoint.
Error messages:
"Unknown resource: webhook": Occurs if the resource parameter is incorrectly set; ensure "webhook" is selected.- API authorization errors: Check that the API token and key are valid and have not expired.
- HTTP errors from the webhook URL (e.g., 404, 500): Confirm the webhook endpoint is correct and operational.
To resolve errors, verify all input parameters, credentials, and network accessibility.
Links and References
- Uazapi Official Documentation (for detailed API usage)
- WhatsApp Business API Webhooks
- n8n Documentation on Credentials