Migration of data from Zendesk to Deskpro

Deskpro has a built in tool that will allow you to migrate data from a Zendesk ticket . The migration tool will import agents, users, tickets, and created documents. The migration tool will pull everything within the date range that you within the configuration.

The import has to be done via the CLI, the import tool is NOT available via the GUI. To preform the import you will need an email address of a Zendesk user who has admin permissions, the subdomain name that the zendesk helpdesk is using and a Zendesk API key with full permissions.

On your server enter the instance container shell

opc inst shell
 copy

change to the zendesk configuration directory

cd /srv/deskpro/dpv5/app/BUILD/modules/importer-tools/importers/zendesk
 copy

copy the config.dist.php file to create a new import configuration file

cp config.dist.php config.php
 copy

edit the configuration file

vi /srv/deskpro/dpv5/app/BUILD/modules/importer-tools/importers/zendesk/config.php
 copy

Example of a valid config file:

 <?php 
$CONFIG = [];
 $CONFIG['account'] = [ 
'subdomain' => 'deskpro', 
'username' => 'admin@deskpro.com', 
'token' => 'API KEY HERE', 
]; 
$CONFIG['start_time'] = '-30 days'; 
$CONFIG['ticket_brand_field'] = null;
 copy

exit from the instance container shell

exit
 copy

run the import

opc inst php -- dpv5/bin/console dp:import zendesk
 copy

once complete run a verification on the data that was imported

opc inst php -- dpv5/bin/console dp:import:verify
 copy

resolve any issues the verification raises

Once you are ready for the data the be added to your Deskpro database, you can do so with the following:

opc inst php -- dpv5/bin/console dp:import:apply
 copy