WbizTool Check Credentials

Check WbizTool API credentials and account status

Overview

This node, "WbizTool Check Credentials," is designed to validate API credentials and check the account status for the WbizTool service. It verifies whether the provided API key and client ID are valid by making a request to the WbizTool API and returns detailed information about the account status.

Common scenarios where this node is useful include:

  • Ensuring that API credentials configured in n8n are correct before running workflows that depend on WbizTool.
  • Validating specific WhatsApp client IDs associated with the account to confirm their active status.
  • Monitoring account health or access permissions programmatically.

For example, a user might run this node at the start of a workflow to verify that the WbizTool API credentials are still valid and that a particular WhatsApp client ID is authorized, preventing downstream errors.

Properties

Name Meaning
WhatsApp Client ID to Validate (Optional) A specific WhatsApp Client ID number to validate. If left empty or zero, the node skips validating a specific WhatsApp client and only validates the main API credentials.

Output

The node outputs an array of JSON objects, each corresponding to an input item processed. Each output object contains:

  • success: Boolean indicating if the validation succeeded.
  • status: Numeric status code returned by the WbizTool API (1 indicates success).
  • message: A message string from the API response.
  • accountName: The name of the account as returned by the API, or null if not available.
  • response: The full raw response object from the WbizTool API.
  • validation: An object containing:
    • credentialsValid: Boolean indicating if credentials are valid (true if status is 1).
    • clientId: The main client ID used for authentication.
    • whatsappClientId: The WhatsApp client ID validated, or null if none was specified.
    • accountName: Account name again for convenience.
    • validatedAt: ISO timestamp of when the validation occurred.

If the node encounters an error and is set to continue on failure, it outputs an object with:

  • success: false
  • error: Error message string
  • validation: Object with credentialsValid set to false and validatedAt timestamp.

The node does not output binary data.

Dependencies

  • Requires an API key credential for WbizTool API authentication.
  • Makes HTTP POST requests to the /me/ endpoint of the WbizTool API.
  • Uses internal helper function wbizToolApiRequest to perform authenticated API calls.
  • No additional environment variables or external services beyond the WbizTool API are required.

Troubleshooting

  • Common issues:

    • Invalid or expired API key or client ID will cause the API to return an error status.
    • Providing an invalid WhatsApp Client ID (e.g., negative or non-existent) may cause validation failure.
    • Network connectivity issues can prevent successful API calls.

  • Error messages:

    • "WbizTool API Error: <message>" indicates the API responded with a failure status and includes the reason.
    • Errors thrown during execution will either stop the workflow or be captured in the output if "Continue On Fail" is enabled.

  • Resolutions:

    • Verify that the API key and client ID are correctly configured in the node credentials.
    • Ensure the WhatsApp Client ID, if specified, is valid and belongs to the account.
    • Check network connectivity and API endpoint availability.
    • Enable "Continue On Fail" to handle errors gracefully within workflows.

Links and References

Discussion