Salesforce Integration

INHALTSVERZEICHNIS

• 1. Vorraussetzungen

• 2. Überblick über die Integration

• 3. Verknüpfung von Lemontaps mit Salesforce 

• 4. Einstellungen in Lemontaps 

• 5. FAQs

1. Vorraussetzungen

Hinweis: Bitte stelle sicher, dass ihr eine der Salesforce-Edition einen API-Zugang besitzt, um die Integration mit Lemontaps nutzen zu können: Siehe Salesforce-Editionen mit API-Zugang hier. Außerdem musst du Administrator-Rechte besitzen, um die Verknüpfung einzurichten.

2. Überblick über die Integration

Mit der Salesforce Integration können entweder nur Administratoren oder auch die Endnutzer die mit Lemontaps erfassten Kontakte zu Salesforce als Leads oder als Kontakte entweder automatisch oder manuell pushen. Dies funktioniert sowohl für die mobile Version als auch für die Desktop Version.

User Journey: 

• Fall 1 - Manueller Push: Wenn man den "manuellen Push" eingestellt hat, wählt man sowohl in der Kontaktübersicht der Admins als auch in der Endnutzer Kontaktübersicht durch die Checkboxen die zu exportierenden Kontakte aus und klickt dann auf Salesforce. Der Export wird dann gestartet.
• Fall 2 - Automatischer Push: Hat man in den Einstellungen den "automatischen Push" ausgewählt, wird der Push zu Salesforce bei jedem neuen Kontakt automatisch gestartet. Bisherige Kontakte werden nicht automatisch gepusht. Falls du die bisher aufgenommen Kontakte auch in Salesforce haben möchtest, müsstest du diese einmalig pushen.

• Status des Exports: In der Kontakttabelle sieht man in der "Export" Spalte den Status. Wenn man auf das Symbol klickt, sieht man weitere Informationen, bspw. wann der Export stattgefunden hat. Falls hinter dem Salesforce Symbol ein Ausrufezeichen steht, sieht man dass der Export fehlgeschlagen ist. Falls man manuell die Kontakte pusht, bekommt man außerdem immer eine Email bei wie vielen Kontakten der Export funktioniert/fehlgeschlagen hat. 

Folgende Attribute werden dabei übertragen: 

Benutzerdefinierte Feldern: 
Hast du benutzerdefinierte Felder in Salesforce selbst angelegt, kannst du diese auch im Leadformular von Lemontaps sichtbar machen. 

• Navigiere zum Kontaktformular -> internes Kontaktformular.
• Klicke auf "CRM-Felder re-importieren

• Klicke auf "Feld hinzufügen" -> CRM Custom Field -> und wähle das Custom Field, das du hinzufügen möchtest

Die benutzerdefinierten Felder aus Salesforce werden dann in Lemontaps angezeigt.

Wenn du nun über das Lemontaps Leadformular die benutzerdefinierten Felder ausfüllst und den Kontakt zu Salesforce exportierst, wird das richtige Feld ausgefüllt. 

Duplikate:

Wenn es bereits einen Kontakt/Lead in Salesforce gibt mit der gleichen Email Adresse wie der Kontakt der von Lemontaps nach Salesforce gepusht werden soll, dann funktioniert der Export nicht, da Duplikate verhindert werden. In diesem Fall wird der Grund in der Export Spalte mit angezeigt. Bei einem manuellen Push erhält man außerdem eine Email, ob es Duplikate beim Export gab. 

Kampagnen:

Es ist möglich Kontakten, die in Salesforce gepusht werden, einer Kampagne zuzuordnen. 

Gehe dafür auf "Kontaktformen" -> scrolle nach unten zu "Kampagnenzuordnung"

Du hast hier die Möglichkeit eine bestimmte Kampagne für alle Exporte zu Salesforce auszuwählen, für jeden Export separat zu wählen ob bzw. welche Kampagne zugeordnet werden soll, oder keine Kampagne auszuwählen. 

Ist die Option gewählt für jeden Export separat eine Kampagne zu wählen, machst du dies anschließend unter "Meine Kontakte" (für Admins auch unter "Kontakte").

3. Verknüpfung von Lemontaps mit Salesforce 

• Navigiere zu der CRM Integration Seite. 
• Klicke auf Salesforce 

• Klicke nun auf "Authorisieren Salesforce" 

• Es erscheint nun ein Popup von Salesforce. Gebe deine Anmeldedaten ein. In den meisten Fällen musst du Administratorrechte bei Salesforce haben. 
• Autorisiere nun Lemontaps im darauffolgenden Popup.
• Voilá Salesforce ist nun verbunden. Du kannst das Popup nun schließen. Zur Info: Bei den Feldern "Leads", "Contacts" etc. musst du nichts machen. 

4. Einstellungen in Lemontaps 

Folgende Einstellungsmöglichkeiten hast du in Lemontaps:

• Automatischer oder Manueller Export zu Salesforce
• Sollen Kontakte als Leads oder als Kontakte in Salesforce angelegt werden oder willst du es dem Nutzer überlassen?
• Rechte: Dürfen Einzelnutzer Kontakte auch zu Salesforce übertragen oder nur Admins? 

Hier kannst du die ersten 2 Punkte einstellen und hier die Bearbeitungsrechte.

Wählst du die 3.Option "Ermögliche Benutzer:innen die Auswahl zwischen "Kontakt" und "Lead" aus, dann navigiere zum Internen Formular und schiebe das Feld "Kontakt/Lead" auf „Anzeigen“.

Kontakt-Export in ein CRM-System

• Beim Export eines Kontakts, z. B. nach Salesforce, erscheint nun eine Auswahloption.

• Der Nutzer muss festlegen, ob der Kontakt als Lead oder als Kontakt exportiert wird.
  
  
  

• Nach dem Export wird die gewählte Option im System angezeigt.
  
  
  

Automatische Zuweisung beim Anlegen eines Kontakts

• Falls die Auswahl bereits beim Erstellen des Kontakts in Lemontaps getroffen wurde, entfällt die erneute Abfrage beim Export.
  
  
  

• Die Zuweisung erfolgt dann automatisch.
  

Durch die Möglichkeit, die Export-Option bereits bei der Erstellung eines Kontakts festzulegen, wird der Prozess effizienter und transparenter. 

5. FAQs

Mein Export ist fehlgeschlagen, was können Gründe hierfür sein?

Hinweis: Ist ein Export fehlgeschlagen, wird eine Fehlermeldung angezeigt, die du dir anschauen kannst indem du unter "Kontakte" auf das kleine Icon in der Spalte "Exporte" gehst.

1) Fehlende Informationen im Kontakt in Lemontaps: 

• Bei Kontakten muss mindestens 1 Name angegeben sein in dem Lemontaps Kontakt, also entweder Vor- oder Nachname, und jedes Feld, das sonst als erforderlich markiert ist, ansonsten gibt es Probleme beim Export
• Bei Leads muss mindestens der Firmennamen und 1 Name (Vor- oder Nachname) im Lemontaps Kontakt angegeben sein, und jedes Feld, das sonst als erforderlich markiert ist, ansonsten funktioniert der Export nicht

2) Duplikat:

• Die Email Adresse des Kontaktes in Lemontaps existiert bereits in Salesforce bei einem Lead oder bei einem Kontakt. Es kann sein, dass die Email Adresse auch an sonstiger Stelle in Salesforce existiert und deshalb den Export verhindert - in diesem Fall sollte in den eigenen Salesforce Regeln nachgesehen werden wie die Duplikatseinstellungen vorgenommen wurden.  

3) Aktualisierung: 

• Bei automatischer Synchronisation ist es manchmal erforderlich, die Seite zu aktualisieren, um das entsprechende Icon zu sehen, wenn bspw. ein neuer Kontakt erstellt wurde.
• Aktualisierungen von Kontakten in Lemontaps werden nicht automatisch im CRM aktualisiert.

4) Fehlermeldung - INVALID FIELD 

• Diese Meldung weist darauf hin, dass der Salesforce-Benutzer keinen Zugriff auf bestimmte Felder wie Description oder Lead Source hat.

• Lösung:
  Stelle sicher, dass der verbundene Benutzer Lese- und Schreibrechte für das Feld Description im Lead-Objekt hat.

  So geht’s:

  1. Gehe zu Setup > Object Manager > Lead.

  2. Klicke auf Fields & Relationships und wähle Description.

  3. Wähle Set Field-Level Security.

  4. Aktiviere "Visible" und deaktiviere "Read-Only" für den Benutzer oder das Profil.

  Danach sollte der Export funktionieren.

  
  

5) Andere Gründe: 

• Es kann sein, dass es trotzdem nicht klappt. Versuche den Kontakt nochmals zu exportieren. Falls es immer noch nicht klappt kontaktiere bitte support@lemontaps.com

Was passiert mit Duplikaten?
Der Export bricht ab, sobald eine doppelte E-Mail-Adresse auftaucht und es wird kein neuer Kontakt im CRM angelegt. Der bisherige Kontakt wird somit auch nicht aktualisiert.

Können Duplikate aktualisiert werden?
Nein, bei einem Duplikat wird der bestehende CRM-Kontakt nicht aktualisiert. Der Lemontaps-Kontakt wird daher nicht exportiert – der Vorgang schlägt fehl.

Ist die Integration DSGVO-konform? 

Ja, das ist sie. Mehr Informationen erfahren Sie hier.

Wie gehe ich mit Pflichtfeldern von Salesforce um?

Wenn du in Salesforce Pflichtfelder definiert hast, werden dir diese automatisch im Popup für die Einrichtung angezeigt. 

Dabei hast du mehrere Möglichkeiten:

1. Gleiche Werte für alle Leads/Kontakte
   Trage die gewünschten Werte direkt im Popup ein – diese werden dann für alle Kontakte übernommen.
   

2. Pflichtfelder individuell im Leaderfassungsformular abfragen
   Wenn die Pflichtfelder für euch wichtig sind, kannst du sie direkt ins Lemontaps-Leaderfassungsformular einfügen.

   • Navigiere zum Kontaktformular -> internes Kontaktformular.
   • Klicke auf "CRM-Felder re-importieren“
   • Klicke auf "Feld hinzufügen" -> CRM Custom Field -> und wähle das Custom Field, das du hinzufügen möchtest

           So stellst du sicher, dass deine Kollegen die Pflichtfelder gleich bei der Kontakterfassung mit ausfüllen.