Anfragen aus Facebook Leads Ads direkt an tricoma als CRM senden

Allgemein

Mit den Leads Ads Hooks für Facebook kannst du Leads, die über Facebook-Werbeanzeigen generiert wurden, direkt an tricoma übermitteln lassen. Diese erscheinen anschließend im Reiter Anfragen.

Die Einrichtung ist recht komplex und du benötigst dafür folgende Voraussetzungen:

• 1. Eine angelegte Facebook-App im Developer-Account
• 2. Eine Facebook-Seite mit Administratorrechten
• 3. Zugriff auf das Facebook Business Konto inklusive zugehörigem Unternehmenskonto

Verwaltung und Anlage der Formulare

Die Leads Ads Formulare kannst du in deinem Facebook Business Zugang unter Instant-Formulare anlegen. Dort hast du auch die Möglichkeit, direkt passende Werbeanzeigen für deine Formulare zu erstellen.

Einrichtung

Anlegen einer App bei Facebook

Um die Funktion nutzen zu können, musst du eine eigene App bei Facebook anlegen. Das kannst du unter folgendem Link tun: https://developers.facebook.com/apps/

Lege die App mit dem Typ Business an. Im nächsten Schritt füllst du deine Daten aus und verknüpfst dein Business-Konto.

Anlegen einer Schnittstelle in tricoma

Lege nun in der App Funnel Planer unter Einstellungen eine neue Schnittstelle im Bereich Facebook Leads Ads Hook an und trage dort deine App-Daten ein. Diese findest du in deinem Facebook-Entwicklerzugang bei der jeweils angelegten App.

Aktivierung der Webhooks

Aktiviere nun die Webhooks in deiner Facebook-App. Diese werden benötigt, damit Facebook die Lead-Daten an dein tricoma-System senden kann.

Aktiviere nun die Webhooks für den Bereich Page in deinem Facebook-Entwicklerzugang.

Dabei musst du eine Callback-URL deines tricoma-Systems sowie einen Verifizierungstoken angeben. Den benötigten Token findest du in den Zugangseinstellungen.

Nun kannst du eine Testanfrage an dein tricoma-System senden lassen.

In der App Funnel Planer sollte die Testanfrage anschließend unter Meldungen sichtbar sein. Der Fehler 400 ist in diesem Fall unproblematisch, da es sich um einen Test-Lead handelt, der nicht von Facebook abgeholt werden darf.

Aktiviere nun die Option, damit künftig neue Leads automatisch an tricoma übergeben werden.

API-Zugänge über das Facebook Graph Tool

Im nächsten Schritt musst du Zugänge für dein tricoma in Facebook anlegen. Dafür nutzt du das Graph Tool unter: https://developers.facebook.com/tools/explorer/

Wähle dort deine Facebook-App aus und generiere einen Benutzertoken. Dem Token müssen folgende Berechtigungen zugewiesen werden:

• pages_show_list
• leads_retrieval
• pages_read_engagement
• pages_manage_metadata
• public_profile

Außerdem musst du beim Generieren des Zugangs deiner Facebook-Seite Zugriff gewähren – also der Seite, über die später die Leads erzeugt werden.

Den erzeugten Nutzer-Zugriffstoken trägst du nun in die entsprechende Einstellung im Funnel Planer ein.

Wähle im Facebook Graph Explorer nun die Seite aus, über die du die Leads generieren möchtest. Daraufhin erhältst du einen weiteren Token, den du in tricoma unter Facebook Seiten Zugriffstoken hinterlegst.

Page ID hinterlegen und Hook aktivieren

Im nächsten Schritt musst du deine Facebook Page ID – also die eindeutige ID deiner Facebook-Seite – in tricoma hinterlegen. Die Page ID findest du z. B. in deinem Facebook Business Account oder auf der Info-Seite deiner Facebook-Seite.

Wenn Sie die Page ID gespeichert haben, können Sie nun den Web Hook aktivieren. Das übergibt somit an Facebook:

Ihre Seite möchte künftig, dass Ihre App eine Info erhält, wenn es einen neuen Lead gibt.

Rechte bei Facebook vergeben

Wir haben zwar nun einen Zugriff auf die API und auch wurden die Hooks eingerichtet, aber uns fehlen nun noch die Rechte um Leads zu erhalten. Öffnen Sie daher über Ihren Facebook Business Account die Unternehmenseinstellungen, gehen dort Integrationen --> Leads Access und fügen noch Rechte unter CRM für Ihre Facebook App hinzu.

Testlauf

Wir können nun einen Testlauf über das "Lead Ads-Testtool" von Facebook starten. Dieses finden Sie unter: https://developers.facebook.com/tools/lead-ads-testing/.
Wählen Sie hier Ihre Seite + Ihr Leadformular um einen Test zu starten.

Sie sollte nun eine Testanfrage in Ihrem tricoma finden, was bedeutet das die Anfrage geklappt hat.

Sie sind nun bereit um Leads aus Facebook zu erhalten.

Fehlerbehebungen

Die Einrichtung ist leider aufgrund der vielen Schritte bei Facebook sehr komplex. Daher ist es wichtig das Sie diese nach und nach befolgen um entsprechend ein gutes Ergebnis zu haben. Nachfolgend haben wir ein paar Infos zu Fehlerbehebungen aufgelistet.

Das Lead-Tool zeigt: "103 (CRM access has been revoked from Lead Access Manager)"

In diesem Fall hat Ihre App noch keinen Zugriff auf Ihre Facebook Leads. Wiederholen und prüfen Sie daher den Schritt "Rechte bei Facebook vergeben".

Leads landen nicht in tricoma

Dies kann mehrere Ursachen haben. Aktivieren Sie als erstes in der App Funnel Planer in den Einstellungen die Option "Debug Log aktivieren?".

Unter Meldungen im Funnel Planer gibt es dann für künftige Hooks weitere Meldungen.

Z. b. in diesem Fall ist der Token bei Facebook ausgelaufen: "Session has expired on.."

Token ist ausgelaufen

Die Hauptursache wird vermutlich ein abgelaufener Token sein. Standardmäßig ist ein Token, welchen Sie über das Graph Tool generieren, nur 1-2 Stunden gültig. Sie können aber über die Hook Verwaltung im Funnel Planer den kurzfristigen Token in einen langfristigen Token umwandeln. Generieren Sie hierzu neue Token gemäß dieser Anleitung über das Graph Tool, speichern diese ab, und wandeln diese dann über die Punkte 3 und 4 in langfristige Token um.

Leads werden nicht abgeholt: Probleme mit der Facebook App

Sollten zwar der Testlead ankommen, aber echte Leads folgenden Fehler produzieren "Unsupported get request. Object with ID '1699572936900714' does not exist, cannot be loaded due to missing permissions, or does not support this operation. Please read the Graph API documentation at https://developers.facebook.com/docs/graph-api", dann liegt es an fehlenden Zugriffsrechten bei der App.

1. Prüfen Sie ob Sie noch der Datennutzungserklärung zustimmen müssen. Diese kommt ggf. erst rund 1-2 Wochen nach Beantragung der Berechtigungen für leads_retrieval.
2. Prüfen Sie ob die bei "leads_retrieval" entsprechend verifiziert sind. Im nachfolgenden Beispiel wäre dies nicht der Fall.
3. Prüfen Sie ob Ihr Unternehmen für die App verifiziert wurde.
Die Punkte 2 und 3 müssen erfüllt sein um Leads erhalten zu können.

Shortinfo

Sollten Leads nicht mehr abholbar sein, so erzeugt tricoma automatisch eine Shortinfo. Sie können die Leads dann manuell über den Facebook Business Zugang z. B. per CSV herunterladen und einsehen.