Documentation / Product / Integrations / Zendesk

Zendesk: Import Tickets and Users

Import Zendesk users and tickets to leverage Lytics Insights and behavioral scoring to make sure you're reaching the right users with the right messages.

Integration Details

This integration utilizes the Zendesk Support API to import user data. Once the import is started the job will:

  1. Retrieve all users in your Zendesk account via the /api/v2/search.json endpoint.
  2. Retrieve all tickets in your Zendesk account via the /api/v2/incremental/tickets.json endpoint.
  3. Ingest all users and tickets and emit them to the zendesk_users and zendesk_tickets data streams in Lytics.
  4. Sleep for 15 minutes.
  5. On subsequent runs, only users and tickets that have been modified since the last time they were imported will be retrieved.

Fields

The following fields are included in the default mapping of the zendesk_users stream:

Source FieldLytics User FieldDescriptionType
idzd_userid unique idZendesk User IDstring
emailemail unique idEmail Addressstring
emailemaildomainEmail Domainstring
namenameFull Namestring
external_idzd_external_idZendesk External IDstring
localezd_localeZendesk Localestring
phonezd_phoneZendesk Phone Numberstring
rolezd_roleZendesk Rolestring
timezonezd_timezoneZendesk Timezonestring
tagszd_user_tagsZendesk User Tagsstring

The following fields are included in the default mapping of the zendesk_tickets stream:

Source FieldLytics User FieldDescriptionType
requester_idzd_userid unique idZendesk User IDstring
channelsAll Channels Used[]string
created_atlast_active_tsLast Active on Any Channeldate
last_channel_activitiesLast Activity By Channelmap[string]time
created_atzd_created_dtLast Zendesk Ticket Created Datedate
created_atzd_first_created_dtFirst Zendesk Ticket Created Datedate
has_incidentszd_has_incidentsZendesk User Has Incidentsstring
idzd_idZendesk Ticket IDstring
created_atzd_last_created_dtLast Zendesk Ticket Created Datedate
organization_idzd_org_idZendesk Organization IDstring
organization_namezd_org_nameZendesk Organization Namestring
organization_tagszd_org_tagsZendesk Organization Tagsstring
via_channelzd_platformsZendesk Platform Submitted Via[]string
satisfaction_rating_scorezd_satisfaction_scoresZendesk Ticket Satisfaction Scores[]string
statuszd_statusZendesk Ticket Status[]string
subjectzd_subjectsZendesk Ticket Subjects[]string
submitter_idzd_submitter_idsZendesk Ticket Submitter IDs[]string
tagszd_tagsZendesk Ticket Tags[]string
idzd_ticket_ctZendesk Ticket Countint
urlzd_ticket_urlsZendesk Ticket URLs[]string
typezd_typesZendesk Ticket Types[]string
zd_yymmZendesk User Submitted Tickets Countsmap[string]intsum

Configuration

Follow these steps to set up and configure an import job for Zendesk in the Lytics platform. If you are new to creating jobs in Lytics, see the Jobs Dashboard documentation for more information.

  1. Select Zendesk from the list of providers.
  2. Select the Import job type from the list.
  3. Select the Authorization you would like to use or create a new one.
  4. Enter a Label to identify this job you are creating in Lytics.
  5. (Optional) Enter a Description for further context on your job.
  6. Select the Tickets checkbox to import all Zendesk tickets.
  7. Select the Users checkbox to import all Zendesk users.
  8. Click the Start Import button.

Zendesk Import Config