N8N Tools - Tidio APIInstall

Overview

This node integrates with the Tidio API to manage operators (agents) within a live chat and customer engagement platform. Specifically, the "List Operators" operation retrieves a list of all operators or agents configured in the Tidio system.

Use cases include:

• Fetching all available operators to display or process their information.
• Automating workflows that depend on operator data, such as assigning conversations or monitoring agent availability.
• Integrating operator lists into dashboards or reporting tools.

Example: Automatically retrieving all operators to assign incoming chats based on availability or department.

Properties

Note: The provided properties JSON includes many fields, but for the "List Operators" operation, only the "Additional Fields" collection is relevant, which does not specify any mandatory or optional filters for this operation.

Output

The output is a JSON object containing the response from the Tidio API endpoint /v1/operators. This typically includes an array of operator objects with details such as operator IDs, names, statuses, departments, and other metadata managed by Tidio.

The output structure is:

{
  "json": {
    // Response from Tidio API listing operators
    "operators": [
      {
        "id": "string",
        "name": "string",
        "status": "online" | "offline" | "away",
        "department": "string",
        // ... other operator details
      },
      ...
    ]
  }
}

No binary data is returned by this operation.

Dependencies

• Requires an API key credential for authenticating with the Tidio API.
• Needs configuration of the Tidio API URL and client credentials (client ID and client secret).
• The node uses an external proxy service (https://n8ntools.io/api/v1/proxy/tidio) to forward requests to the Tidio API.
• Proper permissions on the Tidio account to access operator data.

Troubleshooting

• Common issues:

  • Invalid or missing API credentials will cause authentication failures.
  • Network connectivity problems may prevent reaching the proxy or Tidio API.
  • Insufficient permissions in the Tidio account can result in authorization errors.

• Error messages:

  • "Unknown operator operation: <operation>" indicates an unsupported operation was requested.
  • "Unknown resource: <resource>" means the resource parameter is invalid.
  • HTTP errors from the API (e.g., 401 Unauthorized, 403 Forbidden) suggest credential or permission issues.

• Resolutions:

  • Verify API keys and client credentials are correctly set up in n8n.
  • Ensure the Tidio account has rights to list operators.
  • Check network access and proxy availability.
  • Use the "Continue On Fail" option in the node settings to handle errors gracefully during batch processing.

Links and References

• Tidio API Documentation (general reference for endpoints)
• n8n Documentation for configuring credentials and using HTTP Request nodes
• Proxy service documentation if applicable (not publicly detailed here)