Come effettuare l'integrazione con Salesforce CRM

Cosa imparerai

Scopri come integrare Salesforce CRM con Klaviyo. Questa integrazione semplifica la connessione del tuo account Salesforce, la scelta degli oggetti da sincronizzare e la mappatura dei campi, il tutto attraverso un flusso guidato di configurazione in-app.

Grazie a questa integrazione, Klaviyo può sincronizzare automaticamente i dati di Salesforce (come lead o contatti) nei profili Klaviyo, consentendoti di personalizzare la messaggistica e segmentare i clienti utilizzando i dati CRM.

Prima di iniziare

Prima di iniziare, assicurati che:

• Hai effettuato l'accesso al tuo account Salesforce.
• Se la tua azienda ha più organizzazioni Salesforce, hai effettuato l'accesso all'organizzazione corretta.
• Hai accesso come amministratore al tuo account Salesforce.

Connetti Salesforce a Klaviyo

1. Accedi a Klaviyo. Quindi, seleziona la scheda Integrazioni .
2. Fai clic su Esplora le app per aprire il Klaviyo App Marketplace. Cerca e apri la presentazionedell' app Salesforce. Dopodiché, clicca su Installa.
3. Verrai reindirizzato al flusso di configurazione dell'integrazione Salesforce. Per il passaggio 1, seleziona se ti stai connettendo a un'organizzazione di Salesforce Production o Sandbox, quindi fai clic su Installa l'app Klaviyo Client.
   

4. In Salesforce, segui la procedura guidata per riconoscere e installare il pacchetto "Klaviyo Salesforce OAuth Connector" nell'organizzazione Salesforce che stai collegando a Klaviyo.
   

5. Una volta completata l'installazione, torna alla pagina di configurazione dell'integrazione Salesforce in Klaviyo. Quindi segui il passaggio 2 e fai clic su Connettiti a Salesforce.
   

6. Clicca su Consenti di completare il flusso OAuth e termina la connessione di Klaviyo a Salesforce.
   

Scegli un oggetto Salesforce da sincronizzare

Dopo la connessione, ti verrà chiesto di selezionare gli oggetti Salesforce che desideri sincronizzare con Klaviyo. Clicca su Avanti per continuare.

Ora puoi scegliere fino a 3 oggetti da sincronizzare con Klaviyo. Le opzioni disponibili includono:

• Lead - Potenziali clienti che hanno mostrato interesse per i tuoi prodotti o servizi Salesforce
• Contatto - Persone associate agli account nella tua organizzazione Salesforce
• Account - Organizzazioni o persone coinvolte nella tua attività (come clienti, competitor e partner)
• Opportunità - Potenziali vendite o offerte
• Altro (la disponibilità dipende dalla configurazione del tuo Salesforce)

Gli oggetti sincronizzati da Salesforce saranno creati o aggiornati come profili Klaviyo. Quando sincronizzi più oggetti:

• I record di tutti gli oggetti selezionati saranno sincronizzati con Klaviyo.
• Se l'indirizzo e-mail di un record corrisponde a un profilo Klaviyo esistente, quel profilo verrà aggiornato.
• Se l'indirizzo e-mail di un record non esiste in Klaviyo, verrà creato un nuovo profilo.
• Se la stessa persona esiste in più oggetti sincronizzati con lo stesso indirizzo e-mail, Klaviyo li consoliderà in un unico profilo basato sull'e-mail. (Le mappature dei campi sono configurate per oggetto nella fase successiva).

Mappa i campi di Salesforce alle proprietà di Klaviyo

Successivamente, mapperai i campi di Salesforce con le proprietà del profilo di Klaviyo. Tieni presente che alcune mappature fondamentali, come e-mail, numero di telefono, nome e cognome sono già state mappate. La mappatura dell'indirizzo e-mail di Salesforce è obbligatoria.

Quando hai selezionato più oggetti Salesforce da sincronizzare, configura le mappature dei campi separatamente per ogni oggetto. Questo ti permette di controllare quali campi di ogni oggetto diventano proprietà del profilo Klaviyo.

Aggiungi o modifica le mappature

• Utilizza Aggiungi mappatura per mappare ulteriori campi di Salesforce per l'oggetto attualmente selezionato.
• Seleziona un campo Salesforce a sinistra e la corrispondente proprietà Klaviyo a destra.
• Rimuovi le mappature utilizzando l'icona del cestino, se necessario.
• Ripeti questa procedura per ogni oggetto sincronizzato.
  

Se la stessa proprietà del profilo Klaviyo (ad esempio, Numero di telefono o Città) viene mappata da più oggetti Salesforce, Klaviyo sincronizzerà il valore aggiornato più di recente da Salesforce nel profilo.

Importa le mappature tramite CSV (facoltativo)

Manipolazione (facoltativa)

Puoi abilitare l'opzione per sincronizzare l'oggetto Salesforce come iscritto annullato quando Email Opt Out è impostato su true sull'oggetto Salesforce. Questo contrassegnerà il profilo come "Iscrizione annullata" dalle e-mail in Klaviyo.

Completa la configurazione

Una volta completate le tue mappature, fai clic su Completa la configurazione. Klaviyo finalizzerà l'integrazione (di solito questa operazione richiede alcuni secondi). Vedrai un messaggio di conferma una volta che il tuo account Salesforce sarà stato collegato e sincronizzato correttamente.

Controlla la sincronizzazione e la verifica dei dati di Salesforce

L'integrazione Salesforce si sincronizza con Klaviyo ogni ora.

Per controllare la tua integrazione:

1. Fai clic sul menu a discesa Dati analitici in Klaviyo e seleziona Metriche. Filtra per Salesforce, quindi trova la metrica Diventa lead e fai clic sull'icona del feed delle attività.
2. Se la tua integrazione ha iniziato a sincronizzare i dati, vedrai gli eventi Diventa lead, con l'icona di Salesforce, aggiunti a questo feed di attività.
3. Klaviyo importa tutti i tuoi contatti Salesforce. Per verificarlo, confronta il numero di contatti aggiunti a Klaviyo in una determinata giornata con il numero di contatti aggiunti a Salesforce e conferma che corrispondono.
4. Passa il mouse sul punto dati di ieri (sul feed delle attività per Diventa lead, che puoi trovare cliccando sulla metrica) o guarda nella tabella dei dati sotto il grafico per vedere quanti pagamenti sono avvenuti ieri e confrontarli con i dati memorizzati in Salesforce.
5. Se i dati non corrispondono, il problema è più probabile che il fuso orario del tuo account Klaviyo non corrisponda al fuso orario del tuo account Salesforce. Per controllare le impostazioni del tuo fuso orario in Klaviyo:
   • Fai clic sul nome del tuo account in basso a sinistra.
   • Seleziona quindi clicca su Impostazioni > Organizzazione.
   • Scorri verso il basso fino al fuso orario.

Metriche di Salesforce in Klaviyo

Al momento, Klaviyo sincronizza una metrica con Salesforce CRM: Diventa lead.

Questa metrica viene tracciata quando viene creato un nuovo lead in Salesforce. L'evento in sé non include alcun dato proveniente da Salesforce, ma quando questo evento viene registrato, Klaviyo sincronizza le seguenti proprietà personalizzate per ogni lead e le allega al profilo Klaviyo del lead:

• ID
• Nome
• Cognome
• Titolo
• Azienda
• Via
• Città
• Stato
• Codice postale
• Paese
• Latitudine
• Longitudine
• Telefono
• E-mail
• Sito web
• Origine lead
• Stato
• Settore
• Numero di dipendenti
• Ha annullato l'iscrizione alle e-mail
• E-mail del proprietario

Puoi quindi utilizzare queste proprietà nei segmenti, nei flussi e per popolare dinamicamente le proprietà dei clienti nei tuoi modelli di messaggio.

Risoluzione dei problemi

Problemi con l'installazione e l'autenticazione

Migra dall'autenticazione di base a OAuth

Se configuri l'integrazione Salesforce prima che OAuth fosse supportato, la tua applicazione Salesforce potrebbe essere connessa a Klaviyo utilizzando l'autenticazione di base.

Le connessioni di autenticazione di base esistenti continueranno a funzionare fino alla scadenza delle credenziali. Tuttavia, una volta scadute, le credenziali non possono essere ripristinate o rinnovate. Per mantenere l'integrazione di Salesforce connessa a Klaviyo, dovrai migrare a OAuth.

1. Accedi all'organizzazione Salesforce collegata a Klaviyo.
2. Nel portale di Klaviyo, vai alla pagina delle impostazioni di integrazione di Salesforce. Nella parte superiore della pagina dovrebbe esserci un banner con scritto "L'autenticazione OAuth è ora obbligatoria". Nella descrizione del banner, clicca sul link ipertestuale che dice "app esterna di Klaviyo" per installare il pacchetto "Klaviyo Salesforce OAuth Connector" nella tua organizzazione Salesforce.

3. Una volta terminata l'installazione, torna alla pagina delle impostazioni di integrazione Salesforce e fai clic su Aggiorna. Quindi completa il flusso OAuth.

Per maggiori informazioni, dai un'occhiata alla sezione "Connetti Salesforce a Klaviyo" in alto in questa guida.

Errore "L'app Klaviyo esterna non è installata. Installalo e poi riprova"

Questo errore indica che il pacchetto "Klaviyo Salesforce OAuth Connector" non è installato nell'organizzazione Salesforce con cui stai cercando di autenticarti (o autenticarti nuovamente).

Assicurati che:

1. Hai effettuato l'accesso a Salesforce
2. Hai effettuato l'accesso all'organizzazione Salesforce integrata con Klaviyo. Se la tua azienda ha più organizzazioni Salesforce, potresti aver effettuato l'accesso all'organizzazione sbagliata.
3. Se hai effettuato l'accesso all'organizzazione Salesforce corretta e continui a riscontrare questo errore, cerca i tuoi pacchetti installati in Salesforce per verificare se il pacchetto "Klaviyo Salesforce OAuth Connector" è installato. Se non è installato, ripeti il passaggio 1 nel flusso di configurazione dell'integrazione per installare il pacchetto (vedi la sezione "Connetti Salesforce a Klaviyo" in alto in questa guida). In alternativa, se disponi di un'integrazione esistente e stai effettuando la migrazione a OAuth, fai clic sul link ipertestuale "external Klaviyo App" per installare il pacchetto (vedi la sezione "Migra a OAuth" in alto).

Se hai ancora problemi, contatta l'assistenza.

Messaggio di errore di mancata corrispondenza dell'account

Se la tua azienda ha più organizzazioni Salesforce, assicurati di aver effettuato l'accesso all'organizzazione Salesforce attualmente collegata a Klaviyo quando autentichi nuovamente l'integrazione

Se hai effettuato l'accesso a un'altra organizzazione Salesforce, vedrai un errore di "Account non corrispondente":

Per risolvere l'errore, procedi in uno dei seguenti modi:

1. Riconnetti l'organizzazione Salesforce esistente: chiudi la finestra, esci da Salesforce, quindi accedi all'organizzazione Salesforce attualmente connessa a Klaviyo e riprova.
2. Collega un'altra organizzazione Salesforce: disinstalla l'integrazione Salesforce in Klaviyo, reinstallala e completa il flusso di configurazione dell'integrazione Salesforce utilizzando la nuova organizzazione Salesforce.

Avvisi ed errori di mappatura dei campi

Klaviyo convalida continuamente le tue mappature dei campi Salesforce per garantire che i dati possano sincronizzarsi in modo affidabile. Se un campo Salesforce mappato non è più disponibile (ad esempio, se è stato eliminato, rinominato o le autorizzazioni sono state modificate), potresti notare un avviso o un errore nelle impostazioni di integrazione.

Quando un campo non obbligatorio non è disponibile

Se un campo Salesforce mappato non è più disponibile e non è obbligatorio, Klaviyo:

• Visualizza un avviso che indica quale campo è mancante.
• Continua a sincronizzare tutti gli altri campi disponibili.
• Escludi il campo non disponibile dalle sincronizzazioni future fino a quando non sarà aggiornato o rimosso.

Per risolvere il problema,

1. Vai all'integrazione Salesforce in Klaviyo.
2. Apri l'oggetto interessato.
3. Aggiorna o rimuovi la mappatura dei campi non valida.
4. Salva le tue modifiche.

Una volta aggiornato, la sincronizzazione continuerà come previsto.

Quando un campo obbligatorio (e-mail) non è disponibile

Se il campo E-mail di Salesforce non è più disponibile per un oggetto (ad esempio, a causa di modifiche allo schema o autorizzazioni), Klaviyo:

• Visualizza un errore che indica che il campo E-mail è mancante.
• Interrompi la sincronizzazione dei dati per l'oggetto interessato.
• Ti chiede di aggiornare le mappature dei campi per ripristinare la sincronizzazione.

Per risolvere il problema,

1. Vai all'integrazione Salesforce in Klaviyo.
2. Apri l'oggetto interessato.
3. Assicurati che un campo Salesforce Email valido sia mappato sulla proprietà Email di Klaviyo.
4. Salva le tue modifiche.

Una volta che il campo E-mail sarà nuovamente mappato con successo, la sincronizzazione dei dati riprenderà automaticamente.

Profili mancanti in Klaviyo

Se i record Salesforce non appaiono come profili in Klaviyo, verifica prima che venga mappato un campo e-mail valido per ogni oggetto che stai sincronizzando. Klaviyo utilizza l'indirizzo e-mail come identificatore obbligatorio per creare o aggiornare i profili; i record senza un campo e-mail mappato o senza valori e-mail validi non si sincronizzeranno come profili. Assicurati che:

• Un campo e-mail di Salesforce è mappato sulla proprietà E-mail di Klaviyo per ogni oggetto selezionato.
• Il campo e-mail mappato contiene i valori effettivi delle e-mail in Salesforce: le e-mail vuote o non valide possono impedire la sincronizzazione dei record come profili.

Una volta mappato un campo e-mail valido e i record includono gli indirizzi e-mail, Klaviyo creerà o aggiornerà questi profili alla prossima sincronizzazione.

Risultato

Ora hai integrato il tuo account Klaviyo con Salesforce CRM ed esaminato i dati sincronizzati.

Risorse aggiuntive