Actions11
Overview
The "Pair Phone" operation of the ZuckZapGo Session node allows users to pair a WhatsApp device using a phone number. This operation is part of a broader set of session management capabilities for WhatsApp connections, including connecting, disconnecting, logging out, and configuring various settings like proxies, S3 storage, RabbitMQ, and message skipping options.
This node is beneficial in scenarios where automated WhatsApp session management is required, such as integrating WhatsApp messaging into business workflows, automating customer support, or managing multiple WhatsApp sessions programmatically.
Practical example:
You want to programmatically pair a new phone number with your WhatsApp session to start sending and receiving messages through an automated system. Using this node's "Pair Phone" operation, you provide the phone number (without country code prefixes) and initiate pairing without manual intervention.
Properties
| Name | Meaning |
|---|---|
| Phone Number | The phone number to pair with the WhatsApp session. It should be provided without any country code prefixes like "+". Example: 5521987654321. |
Output
The node outputs JSON data representing the response from the WhatsApp session API after attempting to pair the phone number. The exact structure depends on the API response but generally includes status information about the pairing attempt.
No binary data output is indicated for this operation.
Dependencies
- Requires an API key credential for authenticating requests to the WhatsApp session management service.
- The node communicates with a REST API endpoint
/session/pairphonevia POST method. - Proper configuration of the API credentials within n8n is necessary for successful execution.
Troubleshooting
Common issues:
- Providing the phone number with country code prefixes (e.g., "+") may cause pairing failure. Ensure the phone number is entered without any "+" or country code prefix.
- Network or authentication errors if the API key credential is missing or invalid.
- API endpoint errors if the WhatsApp session service is unreachable or misconfigured.
Error messages:
- Authentication errors typically indicate invalid or missing API credentials; verify and update the API key.
- Validation errors may occur if the phone number format is incorrect; ensure it matches the expected format.
- Connection timeouts or network errors suggest connectivity issues; check network access and proxy settings if applicable.