Skip to content

Instantly share code, notes, and snippets.

@michaelkarrer81
Last active September 22, 2022 14:29
Show Gist options
  • Save michaelkarrer81/b02c27f47a9269cb26bc15954de251a5 to your computer and use it in GitHub Desktop.
Save michaelkarrer81/b02c27f47a9269cb26bc15954de251a5 to your computer and use it in GitHub Desktop.
[facebook leads connector] Download leads via Graph API #facebook

Weblinks

Neue Facebook App anlegen

  1. Unter https://developers.facebook.com/apps einen neu App anlegen indem man auf den Button "Create App" klickt
  2. Option "Manage Integration for your business" wählen
    • Dann den Typ "Business wählen"
    • Add Details > Name: "FS-Online Leads", App Contact E-Mail: (Eure FB-Admin E-Mail)"
  3. Dann der App Marketing API hinzufügen
  4. App Daten ausfüllen in den Basic Settings der App
    • "Add Plattform" klicken dann "Webseite" wählen und "eure Webseite" eintragen
    • Pflichtfelder ausfüllen wie "Privacy Policy"
    • Icon und Kategorie hinzufügen
    • Optional: GDPR (DSGVO) Informationen eintragen
  5. App Daten ausfüllen in den Advanced App Settings:
    • Api Version 11 ist nun Pflicht und kann auch nicht geändert werden daher ist hier nix mehr zu tun und der Punkt 5 kann eigentl. übersprungen werden.
  6. Benötigte Rechte hinzufügen unter "App Review > Permissions and Features":
    • leads_retrival,
    • pages_manage_ads,
    • pages_read_engagement,
    • pages_show_list
  7. App Verification Process durchführen unter "App Review > Requests > Request Permission and Features"
    • Alle Fragen beantworten: ACHTUNG: App Icon sowie Kategorie muss in den App Setting gesetzt sein sonst kommt hier eine merkwürdige Fehlermeldung

Facebook-Page Einstellungen (Token für die Externe Anwendung um Daten abzuholen)

Nun braucht die Facebook Page auf der die App laufen soll noch einen System User der zu seinen Assets die App als auch die Seite hinzugefügt bekommt. Über einen System User Token generieren wir dann einen Page Access Token der Permanent verwendet werden kann um Zugriff auf die Leads zu bekommen.

Unter https://business.facebook.com/ laufen alle Seinte-Tools bei FB Tools zusammen. Dort finden wir auch die Business Settings der Seite bei der wir neue Systemuser anlegen können.

  1. Unter https://business.facebook.com/ Business Settings öffnen
  2. Unter Users > System Users einen neuen User anlegen (Admin muss nicht sein)
  3. Assest hinzufügen
    • Seite hinzufügen
    • App hinzufügen
  4. User Token erzeugen
    • Rechte sollten alle passen da sie direkt von der App kommen
  5. Einen Page Access Token mit dem vorher generierten system_user_token erzeugen
    • Entweder einfach https://graph.facebook.com/<page_id>?fields=access_token&access_token=<system_user_token> aufrufen
    • Oder das im graph api explorer machen
    • TIPP: Die <page_id> kann man auf der Seite im Menüpunkt "About" finden wenn man ganz nach unten scrollt
    • TIPP: Um auf die Seite zu kommen man im Business Manager Unter Tools auf Seite Öffnen gehen

How to get available fields of an endpoint

To get a list of all available fields of an endpoint use ?metadata=1 e.g. "https://graph.facebook.com/v12.0/<form_id>?metadata=1&access_token=<page_access_token>

<form_id>/leads?fields= field_data,custom_disclaimer_responses

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment