Über die falcana Marketing API ist es möglich, Leads aus Facebook in falcana zu übernehmen. Dazu kann beispielsweise die Automationsplattform make.com eingesetzt werden, um Facebook mit falcana zu verknüpfen.
Im nachfolgenden Artikel wird die Einrichtung des dafür benötigten Szenarios in make beschrieben.
Die Nutzung von make.com erfordert ein Konto bei dieser Plattform. Möglicherweise können bei der Nutzung von make.com Gebühren anfallen.
Marketing Anmeldeformular erstellen
Im Admin-Bereich von falcana wird unter „Marketing“ ein Anmeldeformular erstellt, welches nur zur Übernahme der Facebook-Leads dient. Die Einstellungen können beispielsweise wie folgt aussehen:
Die Client ID und der Secret Key werden in den nachfolgenden Schritten noch benötigt.
make.com: Szenario erstellen
In make.com wird ein neues Szenario erstellt, welchem man einen sprechenden Namen gibt, z.B. „Facebook Lead in falcana übernehmen“.
Trigger: Facebook Lead Ad Webhook
Als Trigger für das Szenario sucht man nach „Facebook Lead Ads“ und wählt dort „New Lead“:
Im folgenden Fenster ist es notwendig, unter „Connection“ eine Verbindung zum eigenen Facebook-Konto herzustellen. Unter „Page“ wird die gewünschte Facebook-Seite gewählt, unter „Form“ das Lead-Generierungs-Formular der Facebook-Seite:
Modul hinzufügen: HTTP
Nachdem der Facebook-Trigger vollständig eingerichtet wurde, fügt man dem Szenario ein neues Modul hinzu und wählt „HTTP“:
Das HTTP-Modul wird nun konfiguriert, wie im folgenden Screenshot dargestellt. Unter „Fields“ wird ein erstes Feld „Item 1“ erstellt, bei dem die Einstellungen laut Screenshot vorgenommen werden.
Als value wird hier die Client ID aus dem falcana-Anmeldeformular (siehe oben) eingetragen:
Danach wird „Item 2“ hinzugefügt:
Hier wird unter „Value“ ein JSON-String mit diversen Parametern eingegeben, welche an die falcana API zu übergeben sind.
Kontaktiere gerne das falcana-Support-Team unter support@falcana.com, um die detaillierte API-Beschreibung zu erhalten.
Im Beispiel oben werden folgende Parameter aus dem Facebook-Formular an falcana übergeben:
- Full name: im Facebook-Formular wird der Name nicht aufgeteilt in Vor- und Nachname abgefragt, sondern in einem einzigen Namensfeld -> dieses wird in falcana ins Nachname-Feld eingetragen.
- Email und Phone Number: die e-mail-Adresse und die Telefon-Nr. werden in die entsprechenden Felder in falcana eingetragen.
- Als Anrede wird hier fix „4“ (=“keine Anrede“) übergeben, da das Facebook-Formular im Beispiel kein Feld für die Anrede hat.
- Als Adress-Art und Adress-Typ werden individuell gewünschte Werte übergeben. Hier ist wichtig, dass diese Werte in deiner falcana-DB in den jeweiligen Auswahlfeldern existieren.
- Benutzer und Vertriebsgruppe werden übergeben, um den neuen Lead einer Vertriebsgruppe und dem zuständigen Benutzer zuzuordnen. Auch hier gilt: die Werte müssen in deiner falcana-DB in dieser Art existieren.
Danach wird „Item 3“ hinzugefügt:
Hier wird nochmals exakt der gleiche JSON-Code angeführt wie bei Item 2 (hier begrenzt durch die roten Striche). Unmittelbar nach der schließenden geschwungenen Klammer wird der Secret Key aus dem Anmeldeformular (siehe oben, hier grün umrahmt) angehängt.
Der so resultierende String wird durch die make-Funktion sha1() umschlossen (im Screenshot grau hinterlegt).
SEHR WICHTIG!
Damit die Übertragung funktioniert, sind folgende Punkte unbedingt zu beachten:
– Der JSON-Code muss exakt gleich eingetragen werden wie in Item 2. Hier darf kein Leerzeichen oder Zeilenumbruch mehr oder weniger vorhanden sein. Ein einziges abweichendes Zeichen würde zu einem falschen SHA1-Hash führen und von falcana abgewiesen werden!
– Der Secret Key muss unmittelbar an die schließende Klammer des JSON-Codes angefügt werden. Es darf kein Leerzeichen oder Zeilenumbruch dazwischen sein!
– nach „sha1(“ muss unmittelbar die öffnende Klammer des Json-Codes folgen. Die schließende Klammer der sha1-Funktion muss unmittelbar nach dem Secret Key folgen.
Auch hier gilt: es dürfen keine Leerzeichen oder Zeilenumbrüche dazwischen sein.
Die übrigen Einstellungen für den HTTP-Request können wie folgt vorgenommen werden:
Szenario testen und aktivieren
Nachdem die oben beschriebenen Einstellungen vorgenommen wurden, kann das Szenario in make gespeichert und getestet werden. Nach erfolgreichem Test kann das Szenario für den Live-Betrieb freigegeben werden.