Actions10
- Message Actions
- Webhook Actions
- Control Actions
Overview
The Webhook - Setup operation in the Quepasa (Whatsapp) n8n node is designed to register or configure a webhook endpoint with the Quepasa WhatsApp API. This allows you to receive real-time event notifications (such as incoming messages, status updates, etc.) from your WhatsApp bot by specifying a URL that Quepasa will call when events occur.
Common scenarios:
- Automating workflows triggered by WhatsApp events (e.g., new message received).
- Integrating WhatsApp bot activity into other systems via webhooks.
- Setting up custom event forwarding and tracking for advanced automation.
Practical example:
You want to trigger an n8n workflow every time your WhatsApp bot receives a message. You use this node to register your n8n webhook URL with Quepasa, so all relevant events are forwarded automatically.
Properties
| Name | Type | Meaning |
|---|---|---|
| Authentication | options | Select how to authenticate: either by providing parameters directly or using stored credentials. |
| BaseUrl | string | The base URL of your Quepasa API instance. Required if using parameter-based authentication. |
| Token | string | The token for your WhatsApp bot. Required if using parameter-based authentication. |
| Url | string | The endpoint URL to which Quepasa should send webhook events. |
| Forward Internal | boolean | Whether to forward internal events (optional). |
| Track ID | string | Optional system identifier to avoid duplicated messages. |
| Extra Attributes | fixedCollection | Additional key-value attributes to include in the webhook setup request. |
Output
The output is a JSON object containing the response from the Quepasa API after attempting to set up the webhook. The structure typically includes:
- success (boolean): Indicates if the webhook was registered successfully.
- message (string): A human-readable message about the result.
- data (object): Any additional data returned by the API (may include webhook ID, configuration details, etc.).
Note: The exact fields depend on the Quepasa API's response format.
Dependencies
- Quepasa WhatsApp API: You must have access to a running Quepasa API instance.
- API Token: Required for authentication (either provided directly or via n8n credentials).
- n8n Configuration: If using "Predefined Quepasa Credentials", ensure the credential is configured in n8n under the name
quepasaTokenAuthApi.
Troubleshooting
Common issues:
- Invalid URL: Ensure the "Url" property is a publicly accessible endpoint; otherwise, Quepasa cannot deliver events.
- Authentication errors: Double-check your token and base URL, or verify that your n8n credentials are correct.
- Duplicate webhooks: Using the same "Track ID" can help prevent duplicate registrations.
- Network/firewall issues: Make sure your n8n instance is reachable from the Quepasa server.
Error messages:
"Authentication failed": Check your token and base URL or credential configuration."Webhook registration failed": Review the "Url" and any extra attributes for correctness."Network error": Ensure both n8n and Quepasa servers can communicate over the network.