<style>p { margin: 0; }span.fr-emoticon.fr-emoticon-img { background-repeat: no-repeat !important; font-size: inherit; height: 1em; width: 1em; min-height: 20px; min-width: 20px; display: inline-block; margin: -0.1em 0.1em 0.1em; line-height: 1; vertical-align: middle; } span.fr-emoticon { font-weight: normal; font-family: "Apple Color Emoji", "Segoe UI Emoji", "NotoColorEmoji", "Segoe UI Symbol", "Android Emoji", "EmojiSymbols"; display: inline; line-height: 0; } blockquote { border-left: solid 2px #5e35b1; color: #5e35b1; margin-left:0; padding-left:5px;}blockquote blockquote{ border-color: #00bcd4; color: #00bcd4;}blockquote blockquote blockquote{ border-color: #43a047; color: #43a047;} table.grid{ border-collapse: collapse;} table.grid td, table.grid th { border: 1px solid #ddd;} .fr-fic.fr-dib{ display: block; margin: 5px auto;}.fr-fic.fr-dib.fr-fir{ text-align: right; margin: 5px 0 5px auto;}.fr-fic.fr-dib.fr-fil{ text-align: left; margin: 5px auto 5px 0;}.fr-fic.fr-dii{ float: none; margin: 5px auto;}.fr-fic.fr-dii.fr-fil{ float: left; margin: 5px auto;}.fr-fic.fr-dii.fr-fir{ float: right; margin: 5px auto;}img.fr-dib.fr-fir { margin-right: 0; text-align: right;}img.fr-dib.fr-fil { margin-left: 0; text-align: left;}img.fr-dib { margin: 5px auto; display: block; float: none;}img.fr-bordered { box-sizing: content-box; border: solid 5px #CCC;}img.fr-shadow { box-shadow: 10px 10px 5px 0px #cccccc;}img.fr-rounded { border-radius: 10px; -moz-border-radius: 10px; -webkit-border-radius: 10px; -moz-background-clip: padding; -webkit-background-clip: padding-box; background-clip: padding-box;}</style><p><strong>In this guide we will cover:</strong></p><p><strong>- What is the Zendesk Migration Tool?</strong></p><p><strong>- Getting Zendesk Credentials</strong></p><p><strong>- Connecting to Zendesk</strong></p><p><strong>- Importing Data</strong></p><p><br></p><p><br></p><p><strong><span style="font-size: 14pt;">What is the Zendesk Migration Tool?<br></span></strong></p><p>The Zendesk migration tool can be used to import data from your Zendesk instance into Halo. It can import organisations (customers), users, articles, and incidents by connecting via an API token from Zendesk.</p><p><br></p><p><strong><span style="font-size: 14pt;">Getting Zendesk Credentials</span></strong></p><p>Logging into your Zendesk instance, navigate to the "Admin" tab and click "Go to Admin Center".</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImI3ZGZlMGU3LWI5NWItNDk2Zi04YmFlLTgwZjc0NDJjZmMwMSJ9.NZfL46B6lREiNClWG6LaIgmsg4c0Ducm2cobxbOmNMQ" class="fr-fic fr-fil fr-dib" width="1219" style="width: 1221px; height: 566.57px;" height="567"></p><p><strong><span style="font-size: 10pt;">Fig 1. Admin configuration in Zendesk.</span></strong></p><p><br></p><p>In the Admin Center, navigate to Apps and integrations > APIs > Zendesk API. Click "Add API token", name the token, and then make note of the value that appears. After you exit this screen it will not show again.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjY1YjJmZTY0LWVlZmMtNGJhOC05ZDgzLTI1YjhlMGNhZWVhMCJ9.cJbR7y5Czk4tqnagpsYE8Y-7FBdB-oowP_8JPHVzfrI" class="fr-fic fr-fil fr-dib" width="1216" style="width: 1218px; height: 572.651px;" height="573"></p><p><strong><span style="font-size: 10pt;">Fig 2. Generating an API token in Zendesk.</span></strong></p><p><br></p><p><strong><span style="font-size: 14pt;">Connecting to Zendesk</span></strong></p><p>Back in Halo, go to Configuration > Migrations > Zendesk Migration. At the top of the page, there are three fields : Zendesk URL, Email Address and API Token. Enter the corresponding values into these fields.</p><p><br></p><p>The URL should be your URL without any additions at the end, the email address that of the account that generate the API token, and the API token the one we generated previously.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImMwNTg0OWQ1LTkwYzEtNGViMC1iMzU1LTE3OTBlYmMyZDY0NiJ9.e-aoAcTLdiwXGaJSQH_dSunsPxf8H1a5_UQSnj6I2GE" class="fr-fic fr-fil fr-dib" width="1219" style="width: 1221px; height: 297.767px;" height="298"></p><p><strong><span style="font-size: 10pt;">Fig 3. Configuring the Zendesk migration.</span></strong></p><p><br></p><p>Upon filling these in, click the "Test Configuration" button. This will show the below popup if the connection is set up correctly, and will show an error to help troubleshoot if not.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImQ0MjE2MmI4LTM2ZGMtNDRkNy04Mjg3LWJjOGFjMGIzYzdhOSJ9.M9dcex9oA_T3U0hXIdAl11RSi1oAOUSJTrVAYKpY7vo" class="fr-fic fr-fil fr-dib" width="167" height="121"></p><p><strong><span style="font-size: 10pt;">Fig 4. Test successful popup.</span></strong></p><p><br></p><p><strong><span style="font-size: 14pt;">Importing Data</span></strong></p><p>Once the setup is all confirmed, you can now import your entities.</p><p><br></p><p>Select which entity you wish to import in the dropdown, here we are using "Organisations" as the example. Click the "Import Now" button upon selection.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjY3YjA0NGE4LTRkNGItNDFlNS1hYzA1LTNkZTc2M2Y4OGVmMiJ9.6UP_Nm1Imq-sNzol69bEdfmxSxv-zI0le6aXr6RBYVU" class="fr-fic fr-fil fr-dib" width="1216" style="width: 1218px; height: 228.947px;" height="229"></p><p><strong><span style="font-size: 10pt;">Fig 5. Selecting the Zendesk entity.</span></strong></p><p><br></p><p>A popup will then appear for the additional configuration for that entity. Since we chose organisations, we can select the top level to be assigned to these customers.</p><p><br></p><p>If selecting users, you will need to set the default site.</p><p>If selecting articles, you will need to select the FAQ list to add these to.</p><p>If selecting incidents, you will need to select the ticket type to import these as, which statuses should be included on the import, and the minimum creation date (i.e. import tickets created from this date onwards).</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6Ijc4MjVjZDZjLTIxM2MtNDNiMi05YzI3LTg1M2QyNmE4M2I3OSJ9.g_VM6CmItWWF77fjPSjeX-pZgrHlqvhO572Xpvysvsc" class="fr-fic fr-fil fr-dib" width="710" height="284"></p><p><strong><span style="font-size: 10pt;">Fig 6. Organisations popup when importing.</span></strong></p><p><br></p><p>Upon clicking "Save", the import screen will show. Select which you want to import (by default all will be selected), and then click "Start" in the top right to run the import. This may take a while dependant on the number of entities you are importing.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImQxODA1OWI5LTIxODItNDU0Yy05ZTU0LTAyZGU1YjIxZjlmZCJ9.Qtq_7YEGYtiV9yQrdAVGSRRW0JCPL_m7eUowUUTdBF8" class="fr-fic fr-fil fr-dib" width="1225" style="width: 1227px; height: 576.696px;" height="577"></p><p><strong><span style="font-size: 10pt;">Fig 7. Import screen.</span></strong></p><p><br></p><p>Organisations and users have matching abilities when importing. If any customers exist with the same name as the organisation, it will match and update the other fields with information instead of creating a new customer. For example, "Halo Service Solutions" in the first line of the import screen above has updated the existing record with the note.</p><p><br></p><p>Users will be updated if their email address matches an existing user.</p><p><br></p><p><em><strong>Note: Matching must be exact, i.e. the customer name must be the same as Zendesk with no extra words, spaces, etc.<br></strong></em></p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjEzNmE1M2EyLWY5NDEtNDMyOC1iOWRmLTcyYWY3ZTYxYjAzNyJ9.Ft_LJ5BPEMn9hpXr2qPUXitz1RA-6g66Kg5jlB-DATc" class="fr-fic fr-fil fr-dib" width="1223" style="width: 1225px; height: 693.86px;" height="694"></p><p><strong><span style="font-size: 10pt;">Fig 8. Updated existing customer.</span></strong></p><p><br></p>
