Meta Business Extension

MBE Termin-Onboarding

Der Terminvorgang bei Meta Business Extension (MBE) ermöglicht Verkäufer*innen auf deiner Plattform den Zugriff auf zahlreiche Business-Tools wie Jetzt buchen-Call-to-Action-Buttons auf ihrer Facebook-Seite, im Instagram-Konto und in Messenger-Chats mit Kund*innen.

Beispiel: Onboarding-Vorgang von Partneroberfläche (Unternehmens-Login)

Bevor du beginnst

  1. Registriere dich als Meta-Entwickler*in, um auf unsere Entwicklungstools zuzugreifen und Facebook-Apps zu erstellen.
  2. Erstelle, falls noch nicht geschehen, eine Meta-App vom Typ Business.
  3. Erstelle eine Test-App aus deiner Live-/Produktions-App und führe damit alle neuen Entwicklungs- und Testaufgaben aus.
  4. Deine Apps (Live/Produktion und Test) müssen vom Typ Business-App sein und einem Business Manager gehören, der ein verifiziertes Unternehmen ist. Erfahre mehr darüber, wie du dein Unternehmen verifizierst und wie du dem Unternehmen Apps hinzufügst.
  5. Füge das MBE Developer Panel zu deiner Facebook-App hinzu.
  6. Wenn du das Feature für Seitenkarten (empfohlene Dienstleistungen) aktivieren möchtest, benötigst du für deine App die Genehmigung der Katalogberechtigung (catalog_management) mittels App Review, bevor die App live gehen kann. Mit catalog_management kann deine App Kataloge, die sich im Besitz des Unternehmens befinden (Servicebestand), erstellen, lesen, aktualisieren und löschen. Übermittle die App Review-Anfrage, sobald du über eine funktionierende Demo verfügst, mit der du Screencasts von folgenden Situationen erstellen kannst:
    • Anforderung der Katalogberechtigung im Onboarding-Vorgang
    • Übertragung des Servicebestands zum verknüpften Katalog
    • Die abschließende Aktivierung der Servicekarte auf der verbundenen Seite

Onboarding-Schritte und Zugangspunkte

Unternehmensinhaber (Kund*innen) brauchen einen Mechanismus, um ihr Unternehmen auf einer Partnerplattform mit ihrem Facebook- oder Instagram-Profil zu verbinden und umgekehrt. Hierzu kann der MBE-Onboarding-Vorgang verwendet werden. Der Terminvorgang umfasst die folgenden Punkte:

  • Elementerstellung/-auswahl
  • Erteilen von Berechtigungen
    • Business Extension verwalten
    • Kataloge verwalten (optional)
  • Einrichtung und Features des Unternehmens

Damit die Verbindung hergestellt werden kann, musst du zwei Authentifizierungsvorgänge unterstützen, je nachdem, von wo aus der Nutzer (Unternehmensinhaber) die Verbindung aufbaut:

  • Partner-Oberfläche (meist als Unternehmens-Login bezeichnet): Diese Option bietet Unternehmen die Möglichkeit, diese Verbindung von deiner Plattform aus über einen Button auf deiner Website zu initiieren.
  • Business-Apps: Diese Option ermöglicht Unternehmen die Initiierung der Verbindung von Facebook/Instagram aus. Um diesen Vorgang zu aktivieren und deine App in die Liste der Business-Apps aufzunehmen, musst du eine personalisierte Authentifizierungs-UI bereitstellen, über die der Nutzer auf deiner Website sein Unternehmen auswählen kann und dann wieder zum Facebook- oder Instagram-Vorgang weitergeleitet wird.

Erforderliche Konfigurationen

extras

FeldTypBeschreibung

setup

setup

Erforderlich

Die Facebook-Einrichtung des Verkäufers, etwa seine eindeutige ID (external_business_id) oder die Währung seines Katalogs (currency). Siehe Details zum Objekt „setup“.

business_config

business_config

Erforderlich

Konfigurationsobjekt, mit dem die Facebook Business Extension den Facebook Business Extension-Workflow konfiguriert. Siehe Details zum Objekt business_config.

repeat

Boolean

Erforderlich

Lege diesen Wert auf false fest.

setup

Mit diesem Objekt definierst du die Einstellungen für die Facebook-Präsenz des Endnutzers

FeldBeschreibung

external_business_id
String

Erforderlich.
Eindeutige Unternehmens-ID für das Unternehmen deines*deiner Kund*in. Wir verwenden diese als eindeutige ID. Wenn das Unternehmen des*der Verkäufer*in beispielsweise „Fubar“ heißt, könnte die external_business_id „fubar-123“ lauten.

timezone
Typ: String

Erforderlich.
Die Zeitzone, in der sich das Unternehmen befindet.

Siehe mögliche Zeitzonenwerte.

currency
Typ: String

Erforderlich
ISO-Währungscode mit drei Buchstaben für die Standardwährung, die für die Katalogartikel des Unternehmens verwendet wird.

Siehe Unterstützte Währungscodes.

business_vertical
Typ: enum {APPOINTMENTS}

Erforderlich.
Die Branche des Unternehmens.

Du kannst APPOINTMENTS als mit dem Unternehmen verknüpfte Branche nutzen.

business_config

Mit diesem Objekt konfigurierst du die Unternehmenseinstellungen für Endnutzer*innen. Dazu gehören CTA, Services-Karte und mehr. Zu jedem Feld gehört ein „Typ“, der mit den jeweiligen Tabellen unten verknüpft ist.

FeldBeschreibung

business
Typ: FBEBusinessPropertiesConfigData

Erforderlich.
Informationen für das Unternehmen des*der Endnutzer*in.

ig_cta
Typ: FBEIGCtaConfigData

Erforderlich.
Funktionen für den CTA-Button (Call to Action) auf Instagram, z. B. enabled, cta_button_text, cta_button_url usw.


Unterstützter CTA-Text: Book Now

page_cta
Typ: FBEPageCtaConfigData

Erforderlich.
Funktionen für den CTA-Button (Call to Action) auf der Facebook-Seite, z. B. cta_button_text, cta_button_url usw.


Unterstützter CTA-Text: Book Now

page_card
Typ: FBEPageCardConfigData

Optional.
Aktiviert die Karte mit den angebotenen Diensten (bis zu drei) auf der Facebook-Seite.

Erfordert eine Katalog-Implementierung.

messenger_menu
Typ: FBEMessengerMenuConfigData

Optional.
Features für den CTA-Button im Messenger, wenn ein*e Nutzer*in Nachrichten an das Unternehmen sendet, z. B. cta_button-text und cta_button_url


Unterstützter CTA-Text: Book Now

thread_intent
Typ: FBEThreadIntentConfigData

Optional
Messenger-Vorschlag, mit dem Business-Admins auf einfache Weise ihre Verfügbarkeit an eine*n Nutzer*in im Chat senden können.

Beispiel-Extras für Termine

{
    "setup": {
        "external_business_id": "<YOUR_ID_FOR_THE_BUSINESS>",
        "timezone": "<BUSINESS_TIMEZONE>",
        "currency": "<BUSINESS_CURRENCY>",
        "business_vertical": "APPOINTMENTS"
    },
    "business_config": {
        "business": {
            "name": "<BUSINESS_NAME>"
        },
        "page_cta": {
            "enabled": true,
            "cta_button_text": "Book Now",
            "cta_button_url": "<BUSINESS_URL_FOR_CTA>",
            "below_button_text": "Powered by <YOU>"
        },
        "page_card": {
            "enabled": true,
            "see_all_text": "See All",
            "see_all_url": "<BUSINESS_URL_FOR_CTA>",
            "cta_button_text": "Book"
        },
        "ig_cta": {
            "enabled": true,
            "cta_button_text": "Book Now",
            "cta_button_url": "<BUSINESS_URL_FOR_CTA>"
        },
        "messenger_menu": {
            "enabled": true,
            "cta_button_text": "Book Now",
            "cta_button_url": "<BUSINESS_URL_FOR_CTA>"
        },
        "thread_intent": {
            "enabled": true,
            "cta_button_url": "<BUSINESS_URL_FOR_CTA>"
        }
    },
    "repeat": false
}

Weitere Informationen zur Unternehmenskonfiguration.

Nächste Schritte