Skip to main content

Klaus

Klaus (now Zendesk QA) is a conversation quality assurance and coaching platform for customer support teams. It scores agent conversations, runs AutoQA and CSAT analysis, and manages reviews, disputes, quizzes, and calibration sessions across workspaces. Nexla connects to the Klaus public export API as a REST data source, letting you ingest ratings, reviews, CSAT, users, and workspace data on a schedule.

Klaus icon

Power end-to-end data operations for your Klaus API with Nexla. Our bi-directional Klaus connector is purpose-built for Klaus, making it simple to ingest data, sync it across systems, and deliver it anywhere — all with no coding required. Nexla turns API-sourced data into ready-to-use, reusable data products and makes it easy to send data to Klaus or any other destination. With comprehensive monitoring, lineage tracking, and access controls, Nexla keeps your Klaus workflows fast, secure, and fully governed.

Features

Type: API

SourceDestination

  • Seamless API Integration: Connect to any endpoint as source or destination without coding, with automatic data product creation
  • Visual Composition & Chaining: Build complex integrations using visual templates, chain API calls, and compose workflows with data validation and filtering
  • API Proxy: Expose curated slices of your data securely with a secure and customizable API proxy that validates and transforms data on the fly
  • Request optimization with intelligent batching, retry, and caching to minimize API calls and costs

Prerequisites

Before creating a Klaus credential, you need your Zendesk QA (Klaus) account subdomain and an API token. The Klaus export API is served under your Zendesk domain at https://<your-subdomain>.zendesk.com/qa/api/export/..., and each request is authenticated with a token passed in the Authorization header.

To obtain your API token:

  1. Sign in to your Zendesk QA (Klaus) account as an administrator.

  2. Click your profile icon in the top-right corner and select Settings.

  3. In the sidebar, under Account, click Connections.

  4. Click Add custom integration, enter a name for the connection, and select a data retention period.

  5. After the integration is created, hover over or click the copy button next to it to reveal and copy the API token. Store this token securely, as it grants access to your Klaus data.

  6. Note your Zendesk subdomain — the portion before .zendesk.com in your account URL (for example, your-company for your-company.zendesk.com).

Zendesk QA API tokens should be treated as sensitive credentials. If a token is compromised, remove the custom integration in Zendesk QA and create a new one.

For details on the available export endpoints and authentication, see the Zendesk QA developer documentation.

Authenticate

Credentials required

FieldRequiredSecretDescription
Zendesk SubdomainYesNoYour Zendesk QA (Klaus) subdomain, e.g. "your-company" for your-company.zendesk.com
API Key ValueYesYesAn encoded string value used as a secret token to authenticate API requests

Create a credential in Nexla

  1. After selecting the data source type, click the Add Credential tile to open the Add New Credential overlay.

  2. Enter a name for the credential in the Credential Name field and a short, meaningful description in the Credential Description field.

  3. Enter your Zendesk QA (Klaus) subdomain in the Zendesk Subdomain field. This is the portion before .zendesk.com in your account URL and is used to construct the export API base URL.

  4. Enter your API token in the API Key Value field. This is the token you generated in Prerequisites and is sent in the Authorization header on every request.

  5. Click the Save button at the bottom of the overlay. The newly added credential will now appear in a tile on the Authenticate screen during data source creation.

Use as a data source

To create a new data flow, navigate to the Integrate section, and click the New Data Flow button. Select the Klaus connector tile, then select the credential that will be used to connect to Klaus, and click Next; or, create a new Klaus credential for use in this flow.

Endpoint templates

Nexla provides pre-built templates that can be used to rapidly configure data sources to ingest data from common Klaus export endpoints. Select the endpoint from which this source will fetch data from the Endpoint pulldown menu. Available endpoint templates are listed in the expandable boxes below.

[Rest API] AutoQA Ratings

Returns AutoQA rating rows for export. Use this template to ingest automated quality rating data across conversations.

  • Optional query parameters include Fromdate, Todate, Workspaceid, Connectionid, Revieweeexternalid, Latestonly, Autoqacategorytype, Ratingcategoryid, Rootcausecode, Page, Pagesize, and Cursor to filter and page through results.

[Rest API] AutoQA Reviews

Returns AutoQA review rows for export. Use this template to ingest automated review records for support conversations.

  • Optional query parameters include Fromdate, Todate, Workspaceid, Connectionid, Revieweeexternalid, Latestonly, Page, Pagesize, and Cursor to filter and page through results.

[Rest API] Conversation Search

Returns conversation data for the given request. This endpoint uses a POST request with a JSON body to search exported conversations.

  • Supply the Account and Enduseremail body parameters to scope the search to a specific account and end user.

[Rest API] CSAT By Account

Returns CSAT for tickets across the account. Use this template to ingest customer satisfaction scores.

  • Optional query parameters include Workspace, Fromdate, Todate, Page, and Pagesize to filter and page through results.

[Rest API] Quizzes

Returns all quizzes. Use this template to ingest the list of quizzes configured in your Klaus account.

[Rest API] Quizzes Leaderboard

Returns the leaderboard of quizzes. Use this template to ingest quiz leaderboard standings.

[Rest API] Quiz Overview

Returns the overview for a specific quiz. Use this template to ingest summary data for a single quiz.

  • Supply the Id path parameter to identify the quiz to retrieve.

[Rest API] Quiz Responses

Returns responses for a specific quiz. Use this template to ingest all responses submitted for a single quiz.

  • Supply the Id path parameter to identify the quiz whose responses will be retrieved.

[Rest API] Quiz Response

Returns a single response for a specific quiz. Use this template to ingest one quiz response.

  • Supply the Id and Response path parameters to identify the quiz and the specific response.

[Rest API] Account Reviews

Returns reviews and associated comments across the account. Use this template to ingest review records with their comments.

  • Optional query parameters include Fromdate, Todate, Page, and Pagesize to filter and page through results.

[Rest API] Users

Returns users belonging to the specified account. Use this template to ingest the account's user directory.

[Rest API] Calibration Sessions

Returns calibration sessions for a workspace. Use this template to ingest calibration session data.

  • Supply the Workspace path parameter, and optionally the Fromdate, Todate, Page, and Pagesize query parameters to filter and page through results.

[Rest API] CSAT By Account And Workspace

Returns CSAT for tickets scoped to a specific workspace. Use this template to ingest workspace-level customer satisfaction scores.

  • Supply the Workspace path parameter, and optionally the Fromdate, Todate, Page, and Pagesize query parameters to filter and page through results.

[Rest API] Disputes

Returns disputes for a workspace. Use this template to ingest review dispute records.

  • Supply the Workspace path parameter, and optionally the Fromdate, Todate, Page, and Pagesize query parameters to filter and page through results.

[Rest API] Reviews

Returns reviews and associated comments for a workspace. Use this template to ingest workspace-level review records with their comments.

  • Supply the Workspace path parameter, and optionally the Fromdate, Todate, Page, and Pagesize query parameters to filter and page through results.

[Rest API] Workspace Scorecards

Returns scorecards for a workspace. Use this template to ingest the scorecard configuration for a workspace.

  • Supply the Workspace path parameter to identify the workspace.

[Rest API] Workspace Users

Returns users belonging to the specified account and workspace. Use this template to ingest a workspace's user list.

  • Supply the Workspace path parameter to identify the workspace.

[Rest API] Workspaces

Returns all workspaces. Use this template to ingest the list of workspaces in your Klaus account.

Once the selected endpoint template has been configured, click the Test button to the right of the endpoint selection menu to retrieve a sample of the data that will be fetched. Sample data will be displayed in the Endpoint Test Result panel on the right, allowing you to verify that the source is configured correctly before saving.

Manual configuration

Klaus data sources can also be manually configured to ingest data from any valid Klaus export API endpoint, including endpoints not covered by the pre-built templates, chained API calls, or custom request parameters. Select the Advanced tab at the top of the configuration screen, and follow the instructions in Connect to Any API to configure the API method, endpoint URL, date/time and lookup macros, path to data, metadata, and request headers.

Once all of the relevant settings have been configured, click the Create button in the upper right corner of the screen to save and create the new Klaus data source. Nexla will now begin ingesting data from the configured endpoint and will organize any data that it finds into one or more Nexsets.