Overview
This node, named "Uzapi Business," interacts with the Uzapi Business API to facilitate WhatsApp-related operations. Specifically, for the "Pairing Code" operation, it generates a pairing code linked to a given phone number and associates it with a specified webhook URL. This is useful when integrating WhatsApp messaging capabilities into workflows, allowing users to link their WhatsApp business account via a pairing process.
Practical examples include:
- Automating the setup of WhatsApp business accounts by generating pairing codes programmatically.
- Linking incoming WhatsApp messages or events to an n8n webhook for further processing or automation.
- Managing multiple WhatsApp numbers by generating pairing codes dynamically within workflow executions.
Properties
| Name | Meaning |
|---|---|
| Número de Telefone | The phone number (including country code, e.g., 5511999998888) for which to generate the pairing code. |
| Webhook URL | The public HTTPS URL of your n8n webhook that will receive events related to this pairing. Example: https://.../webhook/uzapi-events |
Output
The node outputs JSON data representing the result of the pairing code generation operation. This typically includes information such as the generated pairing code and any relevant metadata returned by the Uzapi Business API.
No binary data output is indicated in the source code.
Dependencies
- Requires an API client configured with credentials to access the Uzapi Business API. The node expects an API key or authentication token to be set up in n8n credentials (referred generically).
- The node depends on the external Uzapi Business API service.
- The user must provide a valid public HTTPS webhook URL to receive callbacks or events from the Uzapi service.
Troubleshooting
Common issues:
- Invalid or missing phone number format may cause the API to reject the request. Ensure the phone number includes the country code without spaces or special characters.
- Incorrect or unreachable webhook URL can prevent event delivery. Verify the webhook URL is publicly accessible over HTTPS.
- Missing or invalid API credentials will cause authentication failures.
Error messages:
"Operation "pairingCode" não implementada"indicates the requested operation is not recognized; ensure the operation name is correctly set to "pairingCode".- API errors returned from Uzapi Business may include HTTP status codes indicating authorization failure or bad requests; check credentials and input parameters accordingly.
Links and References
- Uzapi Business API Documentation (example placeholder, replace with actual URL)
- n8n Webhook Documentation: https://docs.n8n.io/integrations/builtin/core-nodes/n8n-nodes-base.webhook/