In this section (13)

Run the Zendesk import

Connect your Zendesk account, run a dry run, import and read the report.

1 min read

Before you start

Create an admin API token in Zendesk. Lower roles can’t read every view and macro, SLA policies, schedules or the incremental export.

Import

  1. Open Admin Center, Integrations, Import and pick Zendesk.
  2. Enter the Zendesk subdomain (the part before .zendesk.com), the Admin email and the API token (or an OAuth access token instead), and choose Test connection. Optionally set Requests per minute to leave headroom for your team.
  3. Start a Dry run. It shows what would be imported without changing anything.
  4. Start the Full import. The Runs table shows progress per entity: created, updated, skipped and failed. A long import can be resumed.

You can limit a run to some entities, or to some Zendesk groups for one migration wave. Bot logs from Sunshine Conversations can be imported as closed history, or skipped.

The report

  • Failed records and Warnings list what did not import and why.
  • Rules that use something ChaosDesk can’t map are imported inactive and listed under Untranslated rule items. Fix them in ChaosDesk, then run again.
  • Reconcile counts compares the number of records in Zendesk and in ChaosDesk.

See What the Zendesk import brings over.

Was this article helpful?