Actions11
Overview
This node manages WhatsApp session connections and configurations via the ZuckZapGo service. It allows users to connect or disconnect from WhatsApp servers, pair a phone number, configure proxy settings, manage storage options like S3, set up RabbitMQ messaging, and control various message skipping behaviors (e.g., skip media, groups, newsletters). The "Connect" operation specifically establishes a connection to WhatsApp servers and subscribes to selected event types.
Practical scenarios include:
- Automating WhatsApp session management in workflows.
- Subscribing to specific WhatsApp events such as messages, calls, or presence updates for real-time processing.
- Configuring external services like S3 or RabbitMQ to handle media storage or event messaging.
- Controlling which types of WhatsApp messages or calls should be processed or ignored.
For example, a user can use the "Connect" operation to start a WhatsApp session that listens only for incoming messages and read receipts, enabling automated responses or analytics.
Properties
| Name | Meaning |
|---|---|
| Events to Subscribe | Select one or more WhatsApp event types to subscribe to upon connecting. Options include: All Events, Call, Chat Presence, Connected, Disconnected, Group Info, History Sync, Message, Presence, Push Name, QR Code, Read Receipt. Default is All Events. |
| Immediate Connection | Boolean flag indicating whether the node should return immediately after initiating connection (true), or wait until the connection is fully established (false). |
Output
The node outputs JSON data representing the response from the ZuckZapGo API for the requested operation. For the "Connect" operation, this typically includes details about the connection status and subscribed events.
The output is structured as an array of JSON objects, each corresponding to an input item processed. Each object contains the raw API response data relevant to the operation performed.
No binary data output is indicated for this operation.
Dependencies
- Requires an API key credential for authenticating with the ZuckZapGo service.
- Relies on the ZuckZapGo API endpoints to manage WhatsApp sessions.
- No additional environment variables are explicitly required beyond the API credential.
Troubleshooting
Common issues:
- Failure to connect may occur if the API key is invalid or network connectivity to the ZuckZapGo service is interrupted.
- Selecting incompatible or unsupported event types could result in incomplete event subscriptions.
- Setting "Immediate Connection" to false may cause the node to wait indefinitely if the connection cannot be established.
Error messages:
- API request errors will be caught and handled, typically indicating HTTP error codes or descriptive messages from the ZuckZapGo API.
- Errors related to missing or malformed parameters (e.g., empty phone number when pairing) will prevent successful execution.
Resolutions:
- Verify API credentials and network access.
- Ensure correct event names are selected.
- Use immediate connection mode (
true) to avoid waiting issues during connection attempts.
Links and References
- ZuckZapGo Official Documentation (replace with actual URL)
- WhatsApp Business API concepts for understanding event types and session management.
- n8n documentation on creating and managing custom nodes.