Can I automate the CSV export to my AI agent reporting dashboard?

Question

I use the AI agent reporting dashboard and want to automate access to reporting data instead of downloading the Export CSV file manually.

I want to use this data for recurring analysis and reporting, such as sending aggregated AI agent metrics to another tool or service.

What options are available for retrieving this data automatically? For example:

Can I schedule CSV exports on a daily or weekly basis?

Is there an API that provides the same reporting data available through the dashboard export?

Is there another recommended way to access AI agent reporting data programmatically?

Answer

Yes. You can use the Data Export API to export AI agent reporting data including conversation-level detail as JSON files from a secured API endpoint.

Important notes:

The Data Export API updates once per day at midnight UTC (Coordinated Universal Time)

Requests to Data Export API endpoints use the same account-wide Zendesk API rate limit as other API traffic

When calling the Data Export API endpoint https://yoursubdomain.zendesk.com/ai-agents/api/data-export/v3/get-signed-urls you must pass the request headers botId, organizationId, authorization, and date. Use the generated token for the authorization header. You can only pass one date value

The returned signed file URLs from the Data Export API endpoint don't need the API token. The signature in the URL query string is the authentication

The returned file URL is a temporary signed link that expires one day after the request date. You must call the endpoint again to get a fresh link if it expires

Historical data is available back to January 1, 2024. Anything older requires contacting Zendesk Customer Support

Generating the API token and finding the org ID both require admin access

The export for a date only includes conversations that ended on the date specified based on UTC (Coordinated Universal Time)