Overview
This node registers a new WhatsApp Business account with the Valeia platform. It sends key business and WhatsApp account details to a Valeia onboarding API endpoint, enabling integration between Meta's WhatsApp Business services and Valeia.
Common scenarios include:
- Automating the onboarding process for WhatsApp Business accounts in Valeia.
- Streamlining setup workflows where multiple WhatsApp Business accounts need to be registered programmatically.
- Integrating WhatsApp Business data into broader automation pipelines that use Valeia services.
For example, a user can input their Meta Business ID, WhatsApp Business Account ID, phone number details, and an access token to automatically register their WhatsApp Business account with Valeia without manual intervention.
Properties
| Name | Meaning |
|---|---|
| Business ID | The Meta Business ID associated with your WhatsApp Business account. |
| WhatsApp Business Account ID | The unique identifier of your WhatsApp Business Account, found in Meta Business Suite under WhatsApp Accounts. |
| Phone Number ID | The WhatsApp Phone Number ID linked to your business account. |
| Display Phone Number | The WhatsApp phone number in international format (e.g., 573228854498). |
| Access Token | The Meta System User access token used for authenticating API requests. |
| Business Name | Optional name of your business to be registered with Valeia. |
Output
The node outputs an array of JSON objects, each representing the response from the Valeia onboarding API for each input item processed. The JSON structure corresponds directly to the API response and typically contains confirmation or status information about the onboarding request.
If an error occurs during processing and the node is set to continue on failure, the output JSON will contain an error field with the error message.
No binary data is produced by this node.
Dependencies
- Requires an active connection to the Valeia API service at
https://valeian8n.whitelabel.lat/api/onboarding/callback. - Needs a valid API authentication token (access token) for Meta System User to authorize requests.
- The node uses a credential named generically as "an API key credential" for authenticating with the Valeia API.
- Proper configuration of these credentials within n8n is necessary for successful execution.
Troubleshooting
Common issues:
- Invalid or expired access tokens may cause authentication failures.
- Incorrect or missing IDs (Business ID, WhatsApp Business Account ID, Phone Number ID) will result in API errors.
- Network connectivity problems can prevent reaching the Valeia API endpoint.
Error messages:
- Errors returned from the Valeia API are passed through; typical messages might indicate invalid parameters or authentication failures.
- If the node throws a generic operation error, verify all required properties are correctly set and credentials are valid.
- To handle intermittent failures gracefully, enable "Continue On Fail" in the node settings.
Links and References
- Meta Business Suite – For locating WhatsApp Business Account ID.
- Valeia API documentation (not publicly provided here) – Consult your Valeia platform resources for detailed API usage.