L’integrazione Zendesk per Salesforce permette la sincronizzazione unidirezionale dei dati da Salesforce a Zendesk Support. Questo articolo descrive come configurare due tipi di sincronizzazione dei dati:
- Account Salesforce verso organizzazioni Zendesk: le organizzazioni Zendesk in Support vengono create e aggiornate automaticamente quando si creano o modificano gli account Salesforce.
- Contatti o clienti potenziali Salesforce verso utenti Zendesk: gli utenti Zendesk in Support vengono creati e aggiornati automaticamente quando vengono creati o modificati contatti o clienti potenziali Salesforce.
Articoli correlati:
Informazioni sul processo di sincronizzazione dei dati
Una sincronizzazione dei dati viene attivata quando un campo mappato viene aggiornato in un record Salesforce esistente o quando viene creato un nuovo record. Tutti i campi non mappati aggiornati non attivano la sincronizzazione.
Quando un record Salesforce viene creato o modificato, il processo di sincronizzazione determina se creare un nuovo record o aggiornare un record esistente in Zendesk Support. A tal fine, vengono confrontati i valori dei campi in base ai criteri definiti.
Una volta effettuata la corrispondenza tra i record esistenti o dopo aver creato un nuovo record in Support, i record Salesforce e Support vengono collegati. Ciò significa che i successivi aggiornamenti del record in Salesforce non usano criteri di corrispondenza, ma aggiornano il record collegato in Support.
Se vengono trovati più risultati corrispondenti, la sincronizzazione non può determinare quale record deve essere aggiornato. Poiché si tratta di un processo in background, la sincronizzazione in corso non aggiorna i record e registra un evento di sincronizzazione non riuscito.
Se un utente Salesforce aggiorna un campo mappato indirettamente tramite un flusso Salesforce, un processo di vendita o un trigger Apex, il campo potrebbe non sincronizzarsi con Zendesk se l’utente che ha attivato l’aggiornamento indiretto non dispone dell’autorizzazione alla modifica del campo mappato.
Quando i record vengono creati o aggiornati a un campo mappato mediante l’API Salesforce, viene attivata una sincronizzazione con Zendesk.
Poiché la sincronizzazione dei dati è unidirezionale, qualsiasi modifica applicata in Zendesk non si riflette in Salesforce.
Sincronizzazione tra gli account Salesforce e le organizzazioni Zendesk
La sincronizzazione tra account Salesforce e organizzazioni Zendesk è una sincronizzazione individuale che per impostazione predefinita usa il nome dell’account con il nome dell’organizzazione per le corrispondenze dei record. Tuttavia, non tutte le implementazioni di Salesforce rispettano questa regola. Se disponi di nomi di account duplicati, puoi impostare un altro campo account univoco. Potrebbe non essere una funzionalità adatta se non disponi di campi account univoci.
Questa sincronizzazione dei dati presenta le limitazioni seguenti:
- La sincronizzazione dei dati consuma i limiti regolatori dell’API di streaming di Salesforce. Ad esempio, se hai una grande quantità di dati da sincronizzare, questa supera il limite del governatore e i dati potrebbero non essere sincronizzati.
- Gli account personali Salesforce vengono importati come organizzazioni Zendesk. Se preferisci che un account Persona Salesforce venga aggiunto come utente Zendesk, puoi eseguire un’importazione in blocco di utenti o usare l’ API Crea utente con informazioni specifiche per Salesforce.
Sincronizzazione tra contatti o clienti potenziali Salesforce e utenti Zendesk
La sincronizzazione dai contatti o clienti potenziali Salesforce agli utenti Zendesk avviene individualmente e si basa su indirizzi email univoci. Tuttavia, non tutte le implementazioni di Salesforce rispettano queste regole, quindi valuta se questa funzione soddisfa le tue esigenze.
Questa sincronizzazione dei dati presenta le limitazioni seguenti:
- Per motivi di sicurezza, la sincronizzazione dei dati non sincronizza un contatto Salesforce con un utente Zendesk se l’utente Zendesk è un agente o un amministratore.
- La sincronizzazione dei dati consuma i limiti regolatori dell’API di streaming di Salesforce. Ad esempio, se hai una grande quantità di dati da sincronizzare, questa supera il limite del governatore e i dati potrebbero non essere sincronizzati.
Configurazione di una sincronizzazione dati
La configurazione di una sincronizzazione dei dati richiede diverse attività in Salesforce e nel Centro amministrativo Zendesk.
Per configurare la sincronizzazione dei dati per la tua integrazione
- Configura l’integrazione Zendesk per Salesforce.
- Configura le impostazioni e le autorizzazioni dell’API Salesforce per la sincronizzazione.
- Nel Centro amministrativo, configura le impostazioni di sincronizzazione degli account Salesforce con le organizzazioni Zendesk e dei contatti o clienti potenziali Salesforce con gli utenti Zendesk.
Configurazione delle impostazioni e delle autorizzazioni dell’API Salesforce
Prima di configurare una sincronizzazione dei dati, è necessario abilitare alcune impostazioni e autorizzazioni delle API Salesforce affinché la sincronizzazione dei dati abbia esito positivo. Le informazioni nelle procedure seguenti sono descritte per Salesforce Lightning Edition.
Per abilitare l’API Salesforce
- Nella pagina Configurazione Salesforce, seleziona Amministrazione > Utenti > Profili.
- Seleziona Amministratore di sistema o il profilo dell’utente autenticato.
- Fai clic su Autorizzazioni di sistema e seleziona la casella di spunta API abilitata .
Per impostare le autorizzazioni del canale API di streaming
- Nella pagina Configurazione Salesforce, seleziona Amministrazione > Utenti > Profili.
- Seleziona il profilo utente dell’amministratore che configura l’integrazione.
- Fai clic su Impostazioni oggetto > Canali di streaminge, in Autorizzazioni oggetti, seleziona la casella di spunta Lettura .
Per impostare le autorizzazioni di PushTopic
- Nella pagina Configurazione Salesforce nella barra laterale sinistra, seleziona Amministrazione > Utenti > Profili.
- Seleziona il profilo utente dell’amministratore che configura l’integrazione.
- Fai clic su Impostazioni oggetto > Trasmetti argomento, quindi su Modifica.
- In Autorizzazioni oggetti, seleziona la casella di spunta Leggi e fai clic su Salva.
Per abilitare l’API Streaming
- Nella pagina di configurazione di Salesforce nella barra laterale sinistra, seleziona Strumenti piattaforma > Interfaccia utente > Interfaccia utente.
- In Configurazione, seleziona la casella di spunta Abilita Streaming API .
Configurazione degli account Salesforce per la sincronizzazione con Zendesk Organizations
La procedura seguente spiega come impostare una sincronizzazione in modo che le organizzazioni Zendesk in Support vengano create e aggiornate automaticamente quando vengono creati o modificati gli account Salesforce.
Per configurare gli account Salesforce per la sincronizzazione tra organizzazioni Zendesk
- Nel Centro amministrativo, fai clic su App e integrazioni nella barra laterale, quindi seleziona Integrazioni > Integrazioni.
- In Salesforce, fai clic su Configura.
- Fai clic sulla scheda laterale Sincronizzazione dati e in Sincronizzazione tra account e organizzazioni, fai clic su Configura.
- Seleziona la casella di spunta Abilita sincronizzazione e configura le impostazioni di sincronizzazione degli account e dei campi account con Zendesk.
- In Filtri di sincronizzazione, configura i filtri condizionali per definire quali account Salesforce devono essere sincronizzati con Zendesk. Per maggiori informazioni, consulta la sezione relativa ai filtri di sincronizzazione.
- In Criteri di corrispondenza, imposta i criteri per abbinare gli account Salesforce alle organizzazioni Zendesk. Per maggiori informazioni, consulta Criteri di corrispondenza.
- In Mappatura campi, mappa i campi dell’account Salesforce da compilare con il campo organizzazione Zendesk. Per maggiori informazioni, consulta Mappatura dei campi.
- In Mappatura organizzazionisincronizzate , puoi scegliere di mappare l’organizzazione Zendesk a un account Salesforce. Seleziona un qualsiasi campo account Salesforce standard o personalizzato. Questa sincronizzazione unidirezionale è utile per visualizzare un utente Zendesk collegato a un account Salesforce. Nota: L’integrazione Salesforce scrive l’ID Zendesk nel campo di mappatura dell’organizzazione sincronizzata solo alla prima sincronizzazione riuscita. Tutti i dati esistenti in quel campo verranno sovrascritti. Le sincronizzazioni successive non compilano questo campo in Salesforce.
- In ID esterno Zendesk, seleziona la casella di spunta per includere l’ID esterno nel campo ID esterno dell’organizzazione Zendesk. Può essere impostato solo sull’ID account Salesforce. Nota: Qualsiasi valore di ID esterno esistente viene sovrascritto e non può essere ripristinato. Ciò potrebbe influire sulle altre applicazioni che si basano su questo campo. Questa modifica viene applicata solo quando fai clic su Salva.
- Fai clic su Salva per salvare la configurazione. Viene visualizzata la conferma delle impostazioni salvate.
Configurazione della sincronizzazione tra contatti o clienti potenziali Salesforce e utenti Zendesk
La procedura seguente spiega come configurare una sincronizzazione in modo che gli utenti Zendesk in Support vengano creati e aggiornati automaticamente quando vengono creati o modificati contatti o clienti potenziali Salesforce.
Per configurare i contatti o clienti potenziali Salesforce con le impostazioni di sincronizzazione degli utenti Zendesk
- Nel Centro amministrativo, fai clic su App e integrazioni nella barra laterale, quindi seleziona Integrazioni > Integrazioni.
- In Salesforce, fai clic su Configura.
- Fai clic sulla scheda laterale Sincronizzazione dati e in Sincronizzazione tra contatti/clienti potenziali e utenti, fai clic su Configura.
- Seleziona la casella di spunta Abilita sincronizzazione e configura le impostazioni per le quali i contatti o clienti potenziali e i campi associati vengono sincronizzati con Zendesk.
- In Tipo di sincronizzazione, scegli se creare utenti Zendesk in base ai contatti o clienti potenziali Salesforce. Tieni presente che puoi selezionarne solo uno.
- In Filtri di sincronizzazione, configura i filtri condizionali per scegliere quali contatti o account clienti potenziali Salesforce devono essere sincronizzati con Zendesk. Per maggiori informazioni, consulta la sezione relativa ai filtri di sincronizzazione.
- In Criteri di corrispondenza, imposta i criteri per abbinare i contatti o clienti potenziali Salesforce agli utenti Zendesk. Per maggiori informazioni, consulta Criteri di corrispondenza.
- In Mappatura campi, mappa i campi dei contatti o dei clienti potenziali Salesforce da compilare con il campo organizzazione Zendesk. Per maggiori informazioni, consulta Mappatura dei campi.
- In Mappatura utentisincronizzati , puoi scegliere di mappare l’utente Zendesk a un contatto o cliente potenziale Salesforce. Seleziona un qualsiasi campo di contatto o cliente potenziale Salesforce standard o personalizzato. Questa sincronizzazione unidirezionale è utile per visualizzare un utente Zendesk collegato a un contatto o cliente potenziale Salesforce.Nota: L’integrazione Salesforce scrive l’ID utente Zendesk nel campo del contatto/cliente potenziale mappato solo alla prima sincronizzazione riuscita. Tutti i dati esistenti in quel campo verranno sovrascritti. Le sincronizzazioni successive non compilano questo campo in Salesforce.
- In ID esterno Zendesk, seleziona la casella di spunta per includere l’ID esterno nel campo ID esterno dell’utente Zendesk. Può essere impostato solo sull’ID contatto Salesforce. Nota: Qualsiasi valore di ID esterno esistente viene sovrascritto e non può essere ripristinato. Ciò potrebbe influire sulle altre applicazioni che si basano su questo campo. Questa modifica viene applicata solo quando fai clic su Salva.
- In Opzioni generali, seleziona la casella Invia email di benvenuto per inviare un’email di benvenuto ai nuovi utenti in Support. Per maggiori informazioni, consulta Personalizzazione dell’email di benvenuto e dell’email di verifica dell’account.
- Fai clic su Salva per salvare la configurazione. Viene visualizzata la conferma delle impostazioni salvate.
Filtri di sincronizzazione
Nella sezione Sincronizzazione dati > Filtri di sincronizzazione, puoi filtrare gli account Salesforce da sincronizzare con Zendesk o scegliere quali contatti o clienti potenziali Salesforce sincronizzare con Zendesk. Puoi controllare la sincronizzazione creando istruzioni condizionali. Se non sono impostati filtri, tutti gli account saranno inclusi nell’ambito della sincronizzazione.
Per creare una condizione di filtro di sincronizzazione, specifica il campo, l’operatore e il valore:
- Soddisfa TUTTE le condizioni seguenti: Tutte le condizioni aggiunte a questa sezione devono essere soddisfatte per includere il record Salesforce nella sincronizzazione.
- Soddisfa UNA QUALUNQUE delle condizioni seguenti: Per includere il record Salesforce nella sincronizzazione, devono essere soddisfatte una o più condizioni in questa sezione.
I filtri di sincronizzazione seguono le regole seguenti:
- Tutti i valori fanno distinzione tra maiuscole e minuscole.
- I valori multipli in una condizione possono essere separati da una virgola senza spazi.
- Quando si usa un campo elenco di selezione Salesforce nel filtro di sincronizzazione, il valore deve essere il nome API delle opzioni dell’elenco di selezione.
- Il campo Tipo di record account in Salesforce non è supportato.
- Quando un campo con tipo di casella di spunta viene usato come condizione, inserisci un valore vero o falso .
I seguenti campi Salesforce non sono supportati per il filtraggio:
- Campo formula
- Campo di ricerca
- Campo di testo lungo
Informazioni sui criteri di corrispondenza
Nella sezione Sincronizzazione dati > Criteri di corrispondenza , i criteri vengono definiti per abbinare gli account Salesforce alle organizzazioni Zendesk o i contatti o clienti potenziali Salesforce agli utenti Zendesk. Quando un record in Salesforce viene creato o modificato, il processo di sincronizzazione verifica se è necessario creare un nuovo record utente o organizzazione in Support oppure se è necessario aggiornare un record utente o organizzazione esistente. A tal fine, vengono confrontati i valori impostati nei criteri di corrispondenza definiti. Quando viene trovata una corrispondenza, i campi corrispondenti vengono aggiornati in base alle impostazioni di mappatura dei campi.
Le opzioni nel menu a discesa dei campi Zendesk variano in base al tipo di campo selezionato nel menu a discesa Salesforce. I campi standard e personalizzati sono supportati per la corrispondenza.
Nota:
- È supportato un solo criterio di corrispondenza.
- Se vengono trovati più risultati corrispondenti, la sincronizzazione non avrà esito positivo perché non è in grado di determinare quale record deve essere aggiornato. In questo caso, la sincronizzazione in corso non aggiorna i record e registra un evento di sincronizzazione non riuscito.
Mappatura dei campi
Le sezioni di mappatura dei campi consentono di mappare i campi Salesforce ai campi Zendesk. Ogni campo di account, contatto o cliente potenziale Salesforce deve essere mappato a un campo Zendesk standard o personalizzato. I campi mappati vengono aggiornati durante la sincronizzazione.
I dati Salesforce sono la “fonte di verità” per i campi mappati. Se un campo Zendesk mappato contiene dati al momento della sincronizzazione, viene sovrascritto con i dati Salesforce. Per non sovrascrivere i dati in Zendesk, non mappare il campo. Fanno eccezione i campi Tag, Emaile Telefono . A questi campi vengono aggiunti i valori Salesforce al momento della sincronizzazione. Gli indirizzi email Salesforce aggiunti a Zendesk durante la sincronizzazione vengono aggiunti come indirizzi secondari.
Quando un campo Salesforce in più elenchi di selezione viene selezionato per la mappatura, viene visualizzato il link Valori mappati. Il link apre una finestra per mappare più campi Salesforce ai campi Zendesk.
In questo caso, evita di mappare più campi Salesforce su un singolo campo in Zendesk. Altrimenti, verrà sincronizzato solo l’ultimo campo Salesforce mappato.
I seguenti campi Salesforce non sono supportati per la mappatura:
- Area di testo (lunga)
- Area di testo (richiesto)
- Area di testo (crittografata)
- Campo di ricerca: i campi di ricerca Salesforce non possono essere mappati a Zendesk perché i valori dei campi di ricerca sono memorizzati in un oggetto Salesforce correlato.
- ID tipo di record
Mappatura dei campi tra gli account Salesforce e le organizzazioni Zendesk
In Data Sync > Account to Organizations, la sezione Mappatura campi consente di mappare i campi dell’account Salesforce da compilare con i campi dell’organizzazione Zendesk. Controlla quale campo del record dell’account Salesforce viene sincronizzato come nome dell’organizzazione correlata. Per impostazione predefinita, è impostato su Nome account su Nome organizzazione.
Le opzioni del menu a discesa nel campo Zendesk variano in base al tipo di campo selezionato nel menu a discesa Salesforce. La tabella seguente mostra quali tipi di campi Salesforce possono essere mappati ai tipi di campi Zendesk.
tipo di campo Salesforce | Testo |
A discesa |
Decimale |
Casella di spunta |
Data | Numerico |
ID | ✓ | |||||
Stringa | ✓ | |||||
Telefono | ✓ | |||||
Elenco di selezione | ✓ | ✓ | ||||
Valuta | ✓ | ✓ | ||||
Booleano | ✓ | ✓ | ||||
Casella di spunta | ✓ | |||||
Data/ora | ✓ | ✓ | ||||
Numero | ✓ | ✓ | ||||
Doppio | ✓ | ✓ | ||||
Data | ✓ | ✓ | ||||
Multi elenco di selezione |
✓ | |||||
✓ |
Mappatura dei campi dei contatti o dei clienti potenziali Salesforce con gli utenti Zendesk
In Sincronizzazione dati > Contatti/clienti potenziali con gli utenti , la sezione Mappatura campi mappa i campi dei contatti o dei clienti potenziali Salesforce da compilare con i campi utente Zendesk. Identifica quale campo del record dell’account del contatto o del cliente potenziale Salesforce è sincronizzato come utente correlato. Per impostazione predefinita, la mappatura dei campi è impostata su Email a Email.
Le opzioni del menu a discesa nel campo Zendesk variano in base al tipo di campo selezionato nel menu a discesa Salesforce. La tabella seguente mostra quali tipi di campi Salesforce possono essere mappati ai tipi di campi Zendesk.
tipo di campo Salesforce | Testo |
A discesa |
Decimale |
Casella di spunta |
Data | Numerico |
ID | ✓ | |||||
Stringa | ✓ | |||||
Telefono | ✓ | |||||
Elenco di selezione | ✓ | ✓ | ||||
Valuta | ✓ | ✓ | ||||
Booleano | ✓ | ✓ | ||||
Casella di spunta | ✓ | |||||
Data/ora | ✓ | ✓ | ||||
Numero | ✓ | ✓ | ||||
Doppio | ✓ | ✓ | ||||
Data | ✓ | ✓ | ||||
Multi elenco di selezione |
✓ | |||||
✓ |
Controllo della configurazione della sincronizzazione dei dati
Usa il seguente elenco di controllo per verificare che la sincronizzazione dei dati sia configurata correttamente:
- Assicurati di disporre dei requisiti di impostazione API Salesforce corretti per l’integrazione.
- Conferma di aver collegato un solo account Salesforce a un account Zendesk.
- Filtro di sincronizzazione: Conferma di non usare campi Saleforce non supportati, come Campo formula e Campo di ricerca.
- Filtro di sincronizzazione: Conferma di usare la sintassi corretta nei valori del filtro di sincronizzazione. Questi messaggi fanno distinzione tra maiuscole e minuscole e devono corrispondere esattamente al valore del campo Salesforce. Se stai usando un campo dell’elenco di selezione Salesforce per i filtri, il valore è il nome API.
- Sincronizza mappatura campi: Controlla che la mappatura dei campi includa Nome a Nome. È obbligatorio perché non è possibile creare organizzazioni senza nome in Zendesk.
- Sincronizza mappatura campi: Se hai aggiunto o rimosso le opzioni dei campi a discesa Zendesk o le opzioni degli elenchi di selezione Salesforce, potrebbe essere necessario rimuovere e rimappare il campo per risolvere gli errori di sincronizzazione o aggiungere nuove opzioni.
- Durante il test della sincronizzazione hai apportato aggiornamenti ai campi Salesforce mappati a Zendesk? La sincronizzazione viene attivata solo quando un campo mappato viene aggiornato.
- Se l'opzione Convalida numeri di telefono degli utenti è abilitata nella pagina Utenti finali del Centro amministrativo, Zendesk verifica che tutti i numeri di telefono sincronizzati da Salesforce usino un formato E.164 internazionalevalido. Per evitare errori di convalida dei numeri di telefono in Zendesk Support, formatta i numeri di telefono usando il formato E.164 in Salesforce, che include il segno più (+). Per maggiori informazioni, consulta Perché i numeri di telefono sincronizzati da Salesforce perdono il prefisso del Paese?
Avvertenza sulla traduzione: questo articolo è stato tradotto usando un software di traduzione automatizzata per fornire una comprensione di base del contenuto. È stato fatto tutto il possibile per fornire una traduzione accurata, tuttavia Zendesk non garantisce l'accuratezza della traduzione.
Per qualsiasi dubbio sull'accuratezza delle informazioni contenute nell'articolo tradotto, fai riferimento alla versione inglese dell'articolo come versione ufficiale.