Crea uno schema di Platform per Zendesk
Prima di creare una connessione di origine Zendesk, è inoltre necessario assicurarsi di creare uno schema Platform da utilizzare per l'origine. Consulta il tutorial su creazione di uno schema di Platform per i passaggi completi sulla creazione di uno schema.
Per ulteriori informazioni sullo schema Zendesk richiesto per Zendesk Search API, consulta la sezione limits di seguito.
Connetti il tuo account Zendesk
Nell'interfaccia utente di Platform, seleziona Origini dalla barra di navigazione a sinistra per accedere all'area di lavoro Origini. Nella schermata Catalogo sono visualizzate diverse origini con cui è possibile creare un account.
Puoi selezionare la categoria appropriata dal catalogo sul lato sinistro dello schermo. In alternativa, è possibile trovare l’origine specifica che si desidera utilizzare utilizzando l’opzione di ricerca.
Nella categoria Customer Success, selezionare Zendesk, quindi Add data.
Viene visualizzata la pagina Connetti account Zendesk. In questa pagina è possibile utilizzare nuove credenziali o credenziali esistenti.
Account esistente
Per utilizzare un account esistente, seleziona l'account Zendesk con cui vuoi creare un nuovo flusso di dati, quindi seleziona Next per continuare.
Nuovo account
Se stai creando un nuovo account, seleziona Nuovo account, quindi fornisci un nome, una descrizione facoltativa e le tue credenziali. Al termine, selezionare Connetti all'origine e quindi attendere un po' di tempo per stabilire la nuova connessione.
Selezionare i dati
Una volta autenticata l’origine, la pagina si aggiorna in una struttura ad albero interattiva dello schema che consente di esplorare e ispezionare la gerarchia dei dati. Seleziona Avanti per procedere.
Passaggi successivi
Seguendo questa esercitazione, hai autenticato e creato una connessione di origine tra l'account Zendesk e Platform. Ora puoi continuare con l'esercitazione successiva e creare un flusso di dati per portare i dati di successo dei clienti in Platform.
Risorse aggiuntive
Le sezioni seguenti forniscono ulteriori risorse a cui è possibile fare riferimento quando si utilizza l'origine Zendesk.
Convalida
Di seguito vengono descritti i passaggi che è possibile eseguire per verificare che la connessione all'origine Zendesk sia stata eseguita correttamente e che i profili Zendesk vengano acquisiti in Platform.
Nell'interfaccia utente di Platform, seleziona Set di dati dalla navigazione a sinistra per accedere all'area di lavoro Set di dati. Nella schermata Attività set di dati vengono visualizzati i dettagli delle esecuzioni.
Quindi, seleziona l’ID di esecuzione del flusso di dati che desideri visualizzare per visualizzare dettagli specifici su tale esecuzione.
Infine, seleziona Anteprima set di dati per visualizzare i dati acquisiti.
Puoi anche verificare i dati di Platform rispetto ai dati presenti nella pagina Zendesk > Customers.
Schema Zendesk
Nella tabella seguente sono elencate le mappature supportate che devono essere impostate per Zendesk.
Origine | Tipo |
---|---|
results.active | Booleano |
results.alias | Stringa |
results.created_at | Stringa |
results.custom_role_id | Intero |
results.default_group_id | Intero |
results.details | Stringa |
results.email | Stringa |
results.external_id | Intero |
results.iana_time_zone | Stringa |
results.id | Intero |
results.last_login_at | Stringa |
results.locale | Stringa |
results.locale_id | Intero |
results.moderator | Booleano |
results.name | Stringa |
results.notes | Stringa |
results.only_private_comments | Booleano |
results.organization_id | Intero |
results.phone | Stringa |
results.photo | Stringa |
results.report_csv | Booleano |
results.restricted_agent | Booleano |
results.result_type | Stringa |
results.role | Stringa |
results.role_type | Intero |
results.shared | Booleano |
results.shared_agent | Booleano |
results.shared_phone_number | Booleano |
results.signature | Stringa |
results.suspended | Booleano |
results.ticket_restriction | Stringa |
results.time_zone | Stringa |
results.two_factor_auth_enabled | Booleano |
results.updated_at | Stringa |
results.url | Stringa |
results.verified | Booleano |
Limiti
-
API di ricerca Zendesk > Esporta risultati ricerca restituisce un massimo di 1000 record per pagina.
- Il valore per il parametro
filter[type]
è impostato suuser
e pertanto la connessione Zendesk restituisce solo gli utenti. - Numero di risultati per pagina gestito dal parametro
page[size]
. Valore impostato su100
. Questo viene fatto per ridurre l'impatto dei vincoli di riduzione della velocità stabiliti da Zendesk. - Vedi Limiti e Paginazione.
- È inoltre possibile fare riferimento a Paginazione tramite elenchi tramite l'impaginazione del cursore.
- Il valore per il parametro