Documentazione Experience Platform Guida alle destinazioni

Connessione Zendesk

Last update: Wed Oct 29 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Argomenti:
Destinazioni

Creato per:

Amministratore
Utente

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 diverse interazioni (ad esempio acquisti, restituzioni ecc.) e inviare tali 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

Prerequisiti di Experience Platform 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 sull'iscrizione al pubblico.

Zendesk prerequisiti prerequisites-destination

Per esportare dati da Experience 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:

Credenziali

Descrizione

Esempio

Bearer token

Il token di accesso generato nell'account Zendesk.
Segui la documentazione per generare un Zendesk token di accesso se non ne hai uno.

a0b1c2d3e4...v20w21x22y23z

Guardrail 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à.

Identità di destinazione

Esempio

Descrizione

Obbligatorio

email

test@test.com

Indirizzo e-mail del contatto.

Sì

Tipo e frequenza di esportazione export-type-frequency

Per informazioni sul tipo e sulla frequenza di esportazione della destinazione, consulta la tabella seguente.

Elemento

Tipo

Note

Tipo di esportazione

Profile-based

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 Experience Platform, in base al valore Mapping ID fornito durante il passaggio pianificazione del pubblico.

Frequenza di esportazione

Streaming

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

IMPORTANT

Per connettersi alla destinazione, sono necessarie le View Destinations e le Manage Destinations autorizzazioni di controllo di accesso. Leggi la panoramica sul controllo degli accessi o contatta l'amministratore del prodotto per ottenere le autorizzazioni necessarie.

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.

Entro Destinations > Catalog, 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.

Bearer Token: il token di accesso generato nell'account Zendesk.

Per eseguire l'autenticazione nella destinazione, selezionare Connect to destination.
Schermata dellinterfaccia utente di Experience Platform che mostra come eseguire lautenticazione.

Se i dettagli forniti sono validi, nell'interfaccia utente viene visualizzato lo stato Connected 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.
Schermata dellinterfaccia utente di Experience Platform con i dettagli della destinazione.

Name: nome con cui riconoscerai questa destinazione in futuro.
Description: 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 della connessione di destinazione, selezionare Next.

Attivare tipi di pubblico in questa destinazione activate

IMPORTANT

Per attivare i dati, sono necessarie le View Destinations, Activate Destinations, View Profiles e View Segments 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 View Identity Graph per il controllo degli accessi.
{width="100" modal="regular"}

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 Experience Platform e i corrispondenti equivalenti dalla destinazione.

Gli attributi specificati in Target field devono essere denominati esattamente come descritto nella tabella dei mapping degli attributi, in quanto tali attributi formeranno il corpo della richiesta.

Gli attributi specificati in Source field 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, selezionare Add new mapping. Viene visualizzata una nuova riga di mappatura.
Nella finestra Select source field, scegli la categoria Select attributes e seleziona l'attributo XDM oppure scegli Select identity namespace e seleziona un'identità.

Nella finestra Select target field, scegliere la categoria Select identity namespace e selezionare un'identità di destinazione oppure la categoria Select attributes e selezionare 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:

table 0-row-3 1-row-3 2-row-3 3-row-3
Campo origine	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:

IMPORTANT

Le mappature di destinazione 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 delle mappature per la connessione di destinazione, selezionare Next.

Esempio di esportazione e pianificazione di un pubblico schedule-segment-export-example

Nel passaggio Schedule audience export del flusso di lavoro di attivazione, devi mappare manualmente i tipi di pubblico di Experience Platform all'attributo del campo personalizzato in Zendesk.

A questo scopo, selezionare ogni segmento, quindi immettere l'attributo del campo personalizzato corrispondente da Zendesk nel campo Mapping ID.

Di seguito è riportato un esempio:
Esempio di schermata dellinterfaccia utente di Experience Platform che mostra lesportazione pianificata del pubblico.

Convalidare l’esportazione dei dati exported-data

Per verificare di aver impostato correttamente la destinazione, segui i passaggi seguenti:

Selezionare Destinations > Browse e passare all'elenco delle destinazioni.
Selezionare quindi la destinazione e passare alla scheda Activation data, quindi selezionare 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 Contacts 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 gli stati audienceMapping ID e pubblico.
In alternativa, è possibile eseguire il drill-down in una singola pagina Person e controllare la sezione Additional fields che mostra il nome e lo stato 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.

Visualizza changelog

table 0-row-3 1-row-3 2-row-3 layout-auto
Mese di rilascio	Tipo di aggiornamento	Descrizione
Aprile 2023	Aggiornamento della documentazione	Abbiamo aggiornato la sezione casi d'uso con un esempio più chiaro di quando i clienti trarrebbero vantaggio dall'utilizzo di questa destinazione. La sezione mapping è stata aggiornata per riflettere i mapping richiesti corretti. Le mappature di destinazione `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. La sezione mapping è stata aggiornata con chiari esempi di mapping obbligatori e facoltativi.
Marzo 2023	Versione iniziale	Versione di destinazione iniziale e pubblicazione della documentazione.

recommendation-more-help

7f4d1967-bf93-4dba-9789-bb6b505339d6