Integreren met Salesforce CRM

Wat je leert

Leer hoe je Salesforce CRM met Klaviyo kunt integreren. Met deze integratie kun je eenvoudig je Salesforce-account koppelen, kiezen welke objecten je wilt synchroniseren en velden toewijzen — allemaal via een begeleide, in-app installatie-flow.

Met deze integratie kan Klaviyo Salesforce-gegevens (zoals leads of contactpersonen) automatisch synchroniseren naar Klaviyo-profielen, zodat je berichten kunt personaliseren en klanten kunt segmenteren met behulp van CRM-gegevens.

Voordat je van start gaat

Voordat je begint, zorg ervoor dat:

• Je bent ingelogd op je Salesforce-account.
• Als je bedrijf meerdere Salesforce-organisaties heeft, ben je ingelogd bij de juiste organisatie.
• Je hebt beheerderstoegang tot je Salesforce-account.

Salesforce koppelen aan Klaviyo

1. Log in op Klaviyo. Selecteer vervolgens het tabblad Integraties.
2. Klik op Apps verkennen om de Klaviyo App Marketplace te openen. Zoek de Salesforce app-vermelding en open deze. Klik vervolgens op Installeren.
3. Je wordt doorgestuurd naar de setup-flow voor de Salesforce-integratie. Selecteer voor stap 1 of je verbinding maakt met een Production- of Sandbox-Salesforce-organisatie en klik vervolgens op Klaviyo Client-app installeren.
   

4. Volg in Salesforce de installatiewizard om het pakket "Klaviyo Salesforce OAuth Connector" te bevestigen en te installeren in de Salesforce-organisatie die je met Klaviyo verbindt.
   

5. Zodra de installatie is voltooid, ga je terug naar de pagina voor het instellen van de Salesforce-integratie in Klaviyo. Volg daarna stap 2 en klik op Verbinding maken met Salesforce.
   

6. Klik op Toestaan om de OAuth-flow te voltooien en Klaviyo te koppelen aan Salesforce.
   

Kies een Salesforce-object om te synchroniseren

Na het koppelen wordt je gevraagd te selecteren welke Salesforce-objecten je wilt synchroniseren naar Klaviyo. Klik op Volgende om door te gaan.

Je kunt nu maximaal 3 objecten kiezen om te synchroniseren met Klaviyo. Beschikbare opties zijn onder andere:

• Lead - Potentiële klanten die interesse hebben getoond in je Salesforce-producten of -services
• Contact - Personen die zijn gekoppeld aan accounts in je Salesforce-organisatie
• Account - Organisaties of personen die betrokken zijn bij je bedrijf (zoals klanten, concurrenten en partners)
• Opportunity - Potentiële verkopen of deals
• Overig (beschikbaarheid is afhankelijk van je Salesforce-configuratie)

Objecten die worden gesynchroniseerd vanuit Salesforce worden gemaakt of bijgewerkt als Klaviyo-profielen. Bij het synchroniseren van meerdere objecten:

• Records van alle geselecteerde objecten worden gesynchroniseerd met Klaviyo.
• Als het e-mailadres van een record overeenkomt met een bestaand Klaviyo-profiel, wordt dat profiel bijgewerkt.
• Als het e-mailadres van een record niet bestaat in Klaviyo, wordt er een nieuw profiel aangemaakt.
• Als dezelfde persoon in meerdere gesynchroniseerde objecten met hetzelfde e-mailadres voorkomt, consolideert Klaviyo deze op basis van e-mail tot één enkel profiel. (Veldtoewijzingen worden per object geconfigureerd in de volgende stap.)

Wijs Salesforce-velden toe aan Klaviyo-profieleigenschappen

Vervolgens wijs je Salesforce-velden toe aan Klaviyo-profieleigenschappen. Let op: sommige kern-toewijzingen, zoals e-mail, telefoonnummer, voornaam en achternaam, zijn al vooraf toegewezen. Toewijzing van het e-mailadres van Salesforce is vereist.

Wanneer je meerdere Salesforce-objecten hebt geselecteerd om te synchroniseren, configureer je veldtoewijzingen afzonderlijk voor elk object. Zo kun je bepalen welke velden uit elk object Klaviyo-profieleigenschappen worden.

Toewijzingen toevoegen of bewerken

• Gebruik Toewijzing toevoegen om extra Salesforce-velden toe te wijzen voor het momenteel geselecteerde object.
• Selecteer links een Salesforce-veld en rechts de bijbehorende Klaviyo-eigenschap.
• Verwijder mappings indien nodig met het prullenbakpictogram.
• Herhaal dit proces voor elk gesynchroniseerd object.
  

Als dezelfde Klaviyo-profieleigenschap (bijvoorbeeld Telefoonnummer of Plaats) vanuit meerdere Salesforce-objecten wordt gekoppeld, synchroniseert Klaviyo de meest recent bijgewerkte waarde uit Salesforce naar het profiel.

Importeer mappings via CSV (optioneel)

Afmelden verwerken (optioneel)

Je kunt de optie inschakelen om het Salesforce-object te synchroniseren als afgemeld wanneer Email Opt Out is ingesteld op true op het Salesforce-object. Hierdoor wordt het profiel in Klaviyo gemarkeerd als afgemeld voor e-mail.

Installatie afronden

Zodra je toewijzingen klaar zijn, klik je op Setup voltooien. Klaviyo rondt de integratie af (dit duurt meestal een paar seconden). Je ziet een bevestigingsbericht zodra je Salesforce-account succesvol is gekoppeld en synchroniseert.

Controleer de Salesforce-sync en verifieer de gegevens

De Salesforce-integratie synchroniseert elk uur met Klaviyo.

Zo controleer je je integratie:

1. Klik op de dropdown Analytics in Klaviyo en selecteer meetwaarde. Filter op Salesforce, zoek vervolgens de meetwaarde Werd lead en klik op het pictogram Activiteitenfeed.
2. Als je integratie is begonnen met het synchroniseren van gegevens, zie je Became Lead -events, met het Salesforce-pictogram, toegevoegd aan deze activiteitenfeed.
3. Klaviyo importeert al je Salesforce-leads. Om dit te verifiëren, vergelijk je het aantal leads dat op een bepaalde dag aan Klaviyo wordt toegevoegd met het aantal leads dat aan Salesforce wordt toegevoegd en controleer je of ze overeenkomen.
4. Ga met de muis over het datapunt van gisteren (in de activity feed voor Became Lead, die je kunt vinden door op de meetwaarde te klikken) of kijk in de gegevenstabel onder de grafiek om te zien hoeveel betalingen er gisteren hebben plaatsgevonden en vergelijk dat met de datastore in Salesforce.
5. Als de gegevens niet overeenkomen, komt dat waarschijnlijk doordat de tijdzone in je Klaviyo-account niet overeenkomt met de tijdzone in je Salesforce-account. Zo controleer je je tijdzone-instelling in Klaviyo:
   • Klik linksonder op je accountnaam.
   • Selecteer Instellingen > Organisatie en klik vervolgens erop.
   • Scroll naar beneden naar Tijdzone.

Salesforce-meetwaarden in Klaviyo

Op dit moment synchroniseert Klaviyo één meetwaarde met Salesforce CRM: Werd lead.

Deze meetwaarde wordt bijgehouden wanneer er een nieuwe lead wordt aangemaakt in Salesforce. De gebeurtenis zelf bevat geen gegevens uit Salesforce, maar wanneer deze gebeurtenis wordt geregistreerd, synchroniseert Klaviyo de volgende aangepaste eigenschappen voor elke lead en koppelt deze aan het Klaviyo-profiel van de lead:

• ID
• Voornaam
• Achternaam
• Titel
• Bedrijf
• Straat
• Plaats
• Status
• Postcode
• Land
• Breedtegraad
• Lengtegraad
• Telefoonnummer
• E-mail
• Website
• LeadSource
• Status
• Branche
• Aantal werknemers
• HasOptedOutOfEmail
• E-mailadres van eigenaar

Je kunt deze eigenschappen vervolgens gebruiken in segmenten, in flow en om klanteigenschappen dynamisch in je berichttemplates te vullen.

Probleemoplossing

Problemen met installatie en verificatie

Migreer van basisauthenticatie naar OAuth

Als je de Salesforce-integraties hebt ingesteld voordat OAuth werd ondersteund, is het mogelijk dat je Salesforce-applicatie met Klaviyo is verbonden via basisverificatie.

Bestaande verbindingen met basisverificatie blijven werken totdat hun inloggegevens verlopen. Zodra die inloggegevens verlopen, kunnen ze niet opnieuw worden ingesteld of verlengd. Om je Salesforce-integratie verbonden te houden met Klaviyo, moet je migreren naar OAuth.

1. Log in bij de Salesforce-organisatie die is gekoppeld aan Klaviyo.
2. Ga in het Klaviyo-portal naar je pagina met Salesforce-integratie-instellingen. Bovenaan de pagina zou een banner moeten staan met de tekst "OAuth-authenticatie is nu vereist". Klik in de beschrijving van de banner op de hyperlink met de tekst "externe Klaviyo-app" om het pakket "Klaviyo Salesforce OAuth Connector" in je Salesforce-organisatie te installeren.

3. Wanneer de installatie is voltooid, navigeer je terug naar je pagina met Salesforce-integratie-instellingen en klik je op Bijwerken. Voltooi vervolgens de OAuth-flow.

Bekijk voor meer informatie de sectie "Salesforce koppelen aan Klaviyo" bovenaan deze handleiding.

Foutmelding “Externe Klaviyo-app is niet geïnstalleerd. Installeer het en probeer het daarna opnieuw.”

Deze foutmelding geeft aan dat de Salesforce-org waarmee je probeert te verifiëren (of opnieuw te verifiëren) het pakket "Klaviyo Salesforce OAuth Connector" niet heeft geïnstalleerd.

Zorg ervoor dat:

1. Je bent ingelogd bij Salesforce
2. Je bent ingelogd bij de Salesforce-organisatie die is geïntegreerd met Klaviyo. Als je bedrijf meerdere Salesforce-organisaties heeft, ben je mogelijk ingelogd bij de verkeerde organisatie.
3. Als je bent ingelogd bij de juiste Salesforce-organisatie en je deze fout nog steeds krijgt, zoek je in Salesforce naar je geïnstalleerde pakketten om te controleren of het pakket "Klaviyo Salesforce OAuth Connector" is geïnstalleerd. Als het niet is geïnstalleerd, herhaal je stap 1 in de flow voor het instellen van de integratie om het pakket te installeren (zie de sectie "Salesforce verbinden met Klaviyo" bovenaan deze handleiding). Of als je al een bestaande integratie had en je migreert naar OAuth, klik je op de gelinkte tekst "external Klaviyo App" om het pakket te installeren (zie de sectie "Migreren naar OAuth" hierboven).

Als je nog steeds problemen ondervindt, neem dan contact op met support.

Foutmelding bij niet-overeenkomend account

Als je bedrijf meerdere Salesforce-organisaties heeft, zorg er dan voor dat je bent ingelogd bij de Salesforce-organisatie die momenteel met Klaviyo is verbonden wanneer je de integraties opnieuw autoriseert

Als je bent ingelogd bij een andere Salesforce-organisatie, zie je een foutmelding "Account komt niet overeen":

Voer een van de volgende stappen uit om de fout op te lossen:

1. Maak opnieuw verbinding met de bestaande Salesforce-organisatie: sluit het venster, log uit bij Salesforce, log vervolgens in bij de Salesforce-organisatie die momenteel met Klaviyo is verbonden en probeer het opnieuw.
2. Een andere Salesforce-organisatie koppelen: Verwijder de Salesforce-integratie in Klaviyo, installeer deze opnieuw en voltooi de Salesforce-integratie-instellingsflow met de nieuwe Salesforce-organisatie.

Waarschuwingen en fouten bij veldtoewijzing

Klaviyo valideert continu je Salesforce-veldtoewijzingen om ervoor te zorgen dat gegevens betrouwbaar kunnen synchroniseren. Als een toegewezen Salesforce-veld niet meer beschikbaar is (bijvoorbeeld omdat het is verwijderd, hernoemd of omdat de machtigingen zijn gewijzigd), zie je mogelijk een waarschuwing of foutmelding in je integratie-instellingen.

Wanneer een niet-verplicht veld niet beschikbaar is

Als een toegewezen Salesforce-veld niet langer beschikbaar is en het niet vereist is, zal Klaviyo:

• Geef een waarschuwing weer die aangeeft welk veld ontbreekt.
• Blijf alle andere beschikbare velden synchroniseren.
• Sluit het niet-beschikbare veld uit van toekomstige synchronisaties totdat het is bijgewerkt of verwijderd.

Om dit op te lossen,

1. Ga naar je Salesforce-integratie in Klaviyo.
2. Open het betreffende object.
3. Werk de ongeldige veldtoewijzing bij of verwijder deze.
4. Sla je wijzigingen op.

Zodra dit is bijgewerkt, wordt er weer gesynchroniseerd zoals verwacht.

Wanneer een verplicht veld (E-mail) niet beschikbaar is

Als het veld Salesforce Email niet langer beschikbaar is voor een object (bijvoorbeeld door schemawijzigingen of machtigingen), zal Klaviyo:

• Geef een fout weer die aangeeft dat het veld E-mail ontbreekt.
• Stop met het synchroniseren van gegevens voor het getroffen object.
• Je krijgt de vraag om je veldtoewijzingen bij te werken om het synchroniseren te herstellen.

Om dit op te lossen,

1. Ga naar je Salesforce-integratie in Klaviyo.
2. Open het betreffende object.
3. Zorg dat er een geldig Salesforce-e-mailveld is toegewezen aan de e-maileigenschap van Klaviyo.
4. Sla je wijzigingen op.

Zodra het veld E-mail weer succesvol is toegewezen, wordt het synchroniseren van gegevens automatisch hervat.

Profielen ontbreken in Klaviyo

Als Salesforce-records niet als profielen in Klaviyo worden weergegeven, controleer dan eerst of er voor elk object dat je synchroniseert een geldig e-mailveld is toegewezen. Klaviyo gebruikt het e-mailadres als de vereiste identificatie om profielen te maken of bij te werken; records zonder een toegewezen e-mailveld of zonder geldige e-mailwaarden worden niet gesynchroniseerd als profielen. Zorg dat:

• Een Salesforce-veld voor e-mail wordt voor elk geselecteerd object toegewezen aan de eigenschap E-mail van Klaviyo.
• Het toegewezen e-mailveld bevat echte e-mailwaarden in Salesforce — lege of ongeldige e-mailadressen kunnen voorkomen dat records als profielen worden gesynchroniseerd.

Zodra een geldig e-mailveld is toegewezen en records e-mailadressen bevatten, maakt Klaviyo die profielen aan of werkt ze bij bij de volgende synchronisatie.

Resultaat

Je hebt nu je Klaviyo-account geïntegreerd met Salesforce CRM en je gesynchroniseerde gegevens gecontroleerd.