Connessione Zendesk
Zendesk è una soluzione di assistenza clienti e uno strumento di vendita.
Questa Adobe Experience Platform destinazione sfrutta l'API Zendesk Contatti per creare e aggiornare le identità all'interno di un pubblico come contatti in Zendesk.
Zendesk utilizza token Bearer come meccanismo di autenticazione per comunicare con l'API dei contatti di Zendesk. Le istruzioni per l'autenticazione nell'istanza Zendesk sono riportate di seguito, nella sezione Autentica nella destinazione.
Casi d’uso use-cases
Il reparto di assistenza clienti di una piattaforma B2C multicanale desidera garantire ai propri clienti un’esperienza personalizzata senza soluzione di continuità. Il reparto può creare tipi di pubblico dai propri dati offline per creare nuovi profili utente o aggiornare le informazioni di profilo esistenti da interazioni diverse (ad esempio acquisti, restituzioni, ecc.) e invia questi tipi di pubblico da Adobe Experience Platform a Zendesk. L'aggiornamento delle informazioni in Zendesk garantisce che l'agente del servizio clienti disponga immediatamente delle informazioni recenti del cliente, consentendo risposte e risoluzioni più rapide.
Prerequisiti prerequisites
Experience Platform prerequisiti prerequisites-in-experience-platform
Prima di attivare i dati nella destinazione Zendesk, è necessario disporre di uno schema, un set di dati e segmenti creati in Experience Platform.
Se hai bisogno di indicazioni sugli stati del pubblico, consulta la documentazione di Experience Platform per il gruppo di campi dello schema Dettagli appartenenza pubblico.
Zendesk prerequisiti prerequisites-destination
Per esportare i dati da Platform all'account Zendesk, è necessario disporre di un account Zendesk.
Raccogli Zendesk credenziali gather-credentials
Annotare gli elementi riportati di seguito prima di eseguire l'autenticazione nella destinazione Zendesk:
Bearer tokenSegui la documentazione per generare un Zendesk token di accesso se non ne hai uno.
a0b1c2d3e4...v20w21x22y23zGuardrail guardrails
Nella pagina Determinazione prezzi e limiti tariffari sono illustrati i limiti API Zendesk associati al tuo account. Assicurati che i dati e il payload rientrino in questi vincoli.
Identità supportate supported-identities
Zendesk supporta l'aggiornamento delle identità descritte nella tabella seguente. Ulteriori informazioni su identità.
emailtest@test.comTipo e frequenza di esportazione export-type-frequency
Per informazioni sul tipo e sulla frequenza di esportazione della destinazione, consulta la tabella seguente.
- Stai esportando tutti i membri di un segmento, insieme ai campi dello schema desiderati (ad esempio: indirizzo e-mail, numero di telefono, cognome), in base al mapping dei campi.
- Ogni stato del segmento in Zendesk viene aggiornato con lo stato del pubblico corrispondente da Platform, in base al valore ID mappatura fornito durante il passaggio pianificazione del pubblico.
- Le destinazioni di streaming sono connessioni "sempre attive" basate su API. Non appena un profilo viene aggiornato in Experience Platform in base alla valutazione del pubblico, il connettore invia l’aggiornamento a valle alla piattaforma di destinazione. Ulteriori informazioni sulle destinazioni di streaming.
Connettersi alla destinazione connect
Per connettersi a questa destinazione, seguire i passaggi descritti nell'esercitazione sulla configurazione della destinazione. Nel flusso di lavoro di configurazione della destinazione, compila i campi elencati nelle due sezioni seguenti.
All'interno di Destinazioni > Catalogo, cerca Zendesk. In alternativa, è possibile individuarlo nella categoria CRM.
Autenticarsi nella destinazione authenticate
Compila i campi obbligatori di seguito. Per ulteriori informazioni, consulta la sezione Raccogli Zendesk credenziali.
- Token Bearer: il token di accesso generato nell'account Zendesk.
Per eseguire l'autenticazione nella destinazione, selezionare Connetti alla destinazione.
Se i dettagli forniti sono validi, nell'interfaccia utente viene visualizzato lo stato Connesso con un segno di spunta verde. A questo punto è possibile procedere al passaggio successivo.
Inserire i dettagli della destinazione destination-details
Per configurare i dettagli per la destinazione, compila i campi obbligatori e facoltativi seguenti. Un asterisco accanto a un campo nell’interfaccia utente indica che il campo è obbligatorio.
- Nome: un nome con cui riconoscerai questa destinazione in futuro.
- Descrizione: una descrizione che ti aiuterà a identificare questa destinazione in futuro.
Abilita avvisi enable-alerts
Puoi abilitare gli avvisi per ricevere notifiche sullo stato del flusso di dati verso la tua destinazione. Seleziona un avviso dall’elenco per abbonarti e ricevere notifiche sullo stato del flusso di dati. Per ulteriori informazioni sugli avvisi, consulta la guida su abbonamento a destinazioni avvisi tramite l'interfaccia utente.
Dopo aver fornito i dettagli per la connessione di destinazione, seleziona Avanti.
Attivare tipi di pubblico in questa destinazione activate
- Per attivare i dati, è necessario Visualizza destinazioni, Attiva destinazioni, Visualizza profili e Visualizza segmenti Autorizzazioni di controllo di accesso. Leggi la panoramica sul controllo degli accessi o contatta l'amministratore del prodotto per ottenere le autorizzazioni necessarie.
- Per esportare identità, è necessario disporre dell'autorizzazione Visualizza grafo identità Controllo di accesso.
Leggi Attivare profili e tipi di pubblico nelle destinazioni di esportazione del pubblico di streaming per le istruzioni sull'attivazione dei tipi di pubblico in questa destinazione.
Considerazioni sulla mappatura ed esempio mapping-considerations-example
Per inviare correttamente i dati sul pubblico da Adobe Experience Platform alla destinazione Zendesk, è necessario eseguire il passaggio di mappatura dei campi. La mappatura consiste nella creazione di un collegamento tra i campi dello schema Experience Data Model (XDM) nell’account Platform e i corrispondenti equivalenti dalla destinazione.
Gli attributi specificati nel campo Target devono essere denominati esattamente come descritto nella tabella dei mapping degli attributi, in quanto tali attributi formeranno il corpo della richiesta.
Gli attributi specificati nel campo Source non seguono alcuna restrizione di questo tipo. È possibile eseguirne la mappatura in base alle proprie esigenze. Tuttavia, se il formato dei dati non è corretto al momento del push in Zendesk, si verificherà un errore.
Per mappare correttamente i campi XDM ai campi di destinazione Zendesk, effettua le seguenti operazioni:
-
Nel passaggio Mapping, seleziona Aggiungi nuovo mapping. Viene visualizzata una nuova riga di mappatura.
-
Nella finestra Seleziona campo di origine, scegli la categoria Seleziona attributi e seleziona l'attributo XDM oppure scegli lo spazio dei nomi Seleziona identità e seleziona un'identità.
-
Nella finestra Seleziona campo di destinazione, scegli la categoria Seleziona spazio dei nomi identità e seleziona un'identità di destinazione, oppure scegli la categoria Seleziona attributi e seleziona uno degli attributi di schema supportati.
-
Ripeti questi passaggi per aggiungere le seguenti mappature obbligatorie, puoi anche aggiungere qualsiasi altro attributo che desideri aggiornare tra lo schema del profilo XDM e l'istanza Zendesk:
Campo Source|Campo di destinazione| Obbligatorio
|—|—|—|
|xdm: person.name.lastName|xdm: last_name| Sì |
|IdentityMap: Email|Identity: email| Sì |
|xdm: person.name.firstName|xdm: first_name| | -
Di seguito è riportato un esempio che utilizza queste mappature:
-
Attribute: last_name e Identity: email sono obbligatorie per questa destinazione. Se mancano queste mappature, tutte le altre mappature vengono ignorate e non inviate a Zendesk.Al termine della fornitura dei mapping per la connessione di destinazione, selezionare Avanti.
Esempio di esportazione e pianificazione di un pubblico schedule-segment-export-example
Nel passaggio Pianifica esportazione pubblico del flusso di lavoro di attivazione, devi mappare manualmente i tipi di pubblico di Platform all'attributo del campo personalizzato in Zendesk.
A questo scopo, seleziona ogni segmento, quindi immetti l'attributo del campo personalizzato corrispondente da Zendesk nel campo ID mappatura.
Di seguito è riportato un esempio:
Convalidare l’esportazione dei dati exported-data
Per verificare di aver impostato correttamente la destinazione, segui i passaggi seguenti:
-
Seleziona Destinazioni > Sfoglia e passa all'elenco delle destinazioni.
-
Quindi, seleziona la destinazione e passa alla scheda Dati attivazione, quindi seleziona un nome di pubblico.
-
Controlla il riepilogo del pubblico e assicurati che il conteggio dei profili corrisponda al conteggio all’interno del segmento.
-
Accedi al sito Web Zendesk, quindi passa alla pagina Contatti per verificare se i profili del pubblico sono stati aggiunti. Questo elenco può essere configurato in modo da visualizzare le colonne per i campi aggiuntivi creati con il pubblico ID mappatura e stati di pubblico.
-
In alternativa, puoi eseguire il drill-down in una singola pagina di Persona e controllare la sezione Campi aggiuntivi che mostra il nome del pubblico e gli stati del pubblico.
Utilizzo dei dati e governance data-usage-governance
Tutte le destinazioni Adobe Experience Platform sono conformi ai criteri di utilizzo dei dati durante la gestione dei dati. Per informazioni dettagliate su come Adobe Experience Platform applica la governance dei dati, vedi Panoramica sulla governance dei dati.
Risorse aggiuntive additional-resources
Di seguito sono riportate ulteriori informazioni utili dalla documentazione di Zendesk:
Changelog
Questa sezione acquisisce le funzionalità e i significativi aggiornamenti alla documentazione apportati al connettore di destinazione.
| table 0-row-3 1-row-3 2-row-3 layout-auto | ||
|---|---|---|
| Mese di rilascio | Tipo di aggiornamento | Descrizione |
| Aprile 2023 | Aggiornamento della documentazione |
|
| Marzo 2023 | Versione iniziale | Versione di destinazione iniziale e pubblicazione della documentazione. |