Übersicht über die Messenger-Plattform

In der Übersicht über die Messenger-Plattform erfährst du, wie die Plattform funktioniert und was du für eine erfolgreiche Implementierung der Plattform benötigst.

Messenger from Meta ist ein Messaging-Dienst, der es der Facebook-Seite oder dem professionellen Instagram-Konto eines Unternehmens ermöglicht, Personen zu antworten, die sich für dein Unternehmen oder deine sozialen Medien interessieren. Unterhaltungen zwischen einer Person und deinem Konto müssen von der Person initiiert werden.

Die Verwendung der Messenger-Plattform ist für dich kostenlos.

So funktioniert’s

Eine Person sendet eine Nachricht an deine Unternehmensseite oder dein professionelles Instagram-Konto, während sie bei Facebook oder Instagram angemeldet ist, oder über ein Meta-Plugin, während sie deine mobile App oder Website besucht. Deine Unternehmensseite oder dein professionelles Instagram-Konto können die Messenger-Plattform verwenden, um die Nachricht der Person zu bearbeiten, indem du entweder eine automatische Antwort sendest, einen Live-Agenten antworten lässt oder eine Kombination aus Automatisierung und Live-Agenten verwendest.

Messaging-Vorgang

Wenn eine Person deiner Unternehmensseite oder deinem professionellen Instagram-Konto eine Nachricht sendet, wird ein Webhook ausgelöst und sendet dir eine Benachrichtigung, dass deine Unternehmensseite oder dein professionelles Instagram-Konto eine Nachricht erhalten hat. Deine App kann dann Aufrufe an den Meta Social Graph senden, um diese Unterhaltung abzurufen, die entsprechende Antwort zu ermitteln und innerhalb von 24 Stunden eine Antwort an die Person zu senden. Die Plattform ermöglicht dir dies in großem Umfang und bietet eine Vielzahl von Einstiegspunkten für Unterhaltungen und Nachrichtentypen.

Einschränkungen

  • Eine bei Facebook angemeldete Person kann weder eine Nachricht an dein professionelles Instagram-Konto senden, noch kann sie eine Nachricht an deine Facebook-Unternehmensseite oder deine professionelle Instagram-Kontoseite senden, während sie über die Messenger-Plattform bei Instagram angemeldet ist.
  • Instagram Messaging ist für alle professionellen Instagram-Konten verfügbar, sowohl für Unternehmen als auch für Creator.

Das benötigst du

Um die Messenger-Plattform erfolgreich zu implementieren, musst du die folgenden Komponenten kennen.

Zugriffsschlüssel

Ein Zugriffsschlüssel ist ein verdeckter String, der eine App, eine Facebook-Seite oder eine Person identifiziert und von einer App für sichere Meta Social Graph-Aufrufe verwendet werden kann. Ein Zugriffsschlüssel bietet temporären, sicheren Zugriff auf bestimmte Endpunkte, der es einer Unternehmensseite oder einem professionellen Konto ermöglicht, Nachrichten von Personen zu senden und zu empfangen. Mehr erfahren.

Erweiterter und Standardzugriff

Es gibt zwei Zugriffsebenen für Apps für Unternehmensseiten oder professionelle Instagram-Konten: Standardzugriff und erweiterter Zugriff. Der Standardzugriff ist die standardmäßige Zugriffsebene, wenn du deine App zum ersten Mal bei Meta registrierst. Mit dem Standardzugriff kannst du Daten für Personen abrufen, die eine Rolle in deiner App haben (z. B. eine Admin-, Entwicklungs- oder Testrolle), oder eine Rolle auf einer Unternehmensseite oder einem professionellen Instagram-Konto, die/das die App beansprucht hat. Mit dem erweiterten Zugriff kann deine App, Daten für Personen abrufen, die deine App verwenden, aber keine Rolle in deiner App oder auf der Unternehmensseite oder dem professionellen Instagram-Konto haben, die/das die App beansprucht hat. Erfahre mehr über App-Rollen , App-Typen und erweiterten bzw. Standardzugriff .

Aufgrund der Begrenzungen des Standardzugriffs funktionieren einige Features möglicherweise erst richtig, sobald deine App erweiterten Zugriff erhalten hat. Daher können alle von dir verwendeten Test-Apps eingeschränkt sein.

App-Review

Du musst die App-Review abschließen, wenn deine App erweiterten Zugriff benötigt, um Daten über oder für App-Nutzer*innen abzurufen, die keine Rolle in der App oder auf einer Unternehmensseite oder einem professionellen Instagram-Konto haben, die/das die App beansprucht hat. Mehr erfahren.

Wenn du die App entwickelst, um Nachrichten für deine eigene Seite zu senden und zu empfangen, musst du keinen App Review durchlaufen. Wenn du jedoch Nutzer*innenprofilinformationen abholen möchtest, musst du weiterhin die App Review für die Berechtigungen für den Zugriff auf die Nutzer-Profil-API durchlaufen.

Unternehmensbestätigung

Deine App muss die Unternehmensverifizierung durchlaufen, wenn sie von App-Nutzer*innen verwendet werden wird, die keine Rolle in der App und keine Rolle in einem Unternehmen innehaben, das die App beansprucht hat. Mehr erfahren.

Content Delivery Network-URLs

Die Messenger-Plattform nutzt Content Delivery Network(CDN)-URLs, mit denen du von Instagram-Nutzer*innen geteilte Rich-Media-Inhalte abzurufen. Die CDN-URL hält Datenschutzrichtlinien ein und gibt die Medien nicht zurück, wenn der Inhalt gelöscht wurde oder abgelaufen ist.

Facebook Login

Damit eine Person deiner Seite oder deinem professionellen Instagram-Konto erlauben kann, ihr eine Nachricht zu senden, musst du sie nach der entsprechenden Berechtigung fragen. Um diese Berechtigung anzufragen, musst du Facebook Login implementieren. Mehr erfahren.

Facebook-Seite

Eine Facebook-Seite ist erforderlich, um Nachrichten über die Messenger-Plattform zu senden oder zu empfangen. Mehr erfahren.

Funktionen

Die Funktion menschlicher Vermittler ermöglicht es deiner App, Nutzer-Nachrichten durch Nutzung des Tags human_agent innerhalb von sieben Tagen nach Erhalt von einem menschlichen Vermittler beantworten zu lassen. Die zulässige Nutzung für diese Funktion liegt in der Bereitstellung von Unterstützung durch einen menschlichen Vermittler in Fällen, in denen ein Nutzerproblem nicht über das Standard-Nachrichtenfenster behoben werden kann. Zum Beispiel, wenn das Geschäft übers Wochenende geschlossen ist oder das Problem nicht innerhalb von 24 Stunden behoben werden kann.

Übergabeprotokoll

Wenn du für die Verarbeitung von Nachrichten mehr als eine App verwendest, z. B. eine App zum Verarbeiten automatisierter Antworten und eine andere App für Eskalationen an eine*n Mitarbeiter*in, musst du das Übergabeprotokoll implementieren, um die Unterhaltung von einer App zur anderen zu übergeben. Damit eine App auf eine Nachricht antworten kann, muss sie die Unterhaltung kontrollieren und das Übergabeprotokoll ermöglicht es deiner App, die Kontrolle von einer anderen App anzufordern, wenn sie auf eine Nachricht antworten muss, die Kontrolle von einer anderen App zu übernehmen und die Kontrolle über die Unterhaltung freizugeben, wenn die App die Antwort gesendet hat.

Hohes Nachrichtenaufkommen

Wenn deine Seite oder dein professionelles Instagram-Konto eine große Menge an Nachrichten sendet oder empfängt, kann das Postfach keine neuen Nachrichten mehr anzeigen oder neue Nachrichten senden, bis das Nachrichtenaufkommen abnimmt.

Messenger-Nachrichten

Wenn eine Seite mehr als 40 Nachrichten pro Sekunde sendet oder ständig eine große Anzahl von Unterhaltungsnachrichten gleichzeitig sendet oder empfängt, werden neue Nachrichten nicht im Postfach der Seite angezeigt und die Seite kann keine neuen Nachrichten senden, bis das Nachrichtenaufkommen abnimmt.

Wenn eine Seite die Obergrenze für das Nachrichtenaufkommen erreicht, schlagen API-Aufrufe zum Abrufen aller Unterhaltungen fehl. Du kannst jedoch weiterhin eine einzelne Unterhaltung aufrufen, um neue Nachrichten für diese Unterhaltung zu erhalten.

Instagram-Nachrichten

Wenn ein professionelles Instagram-Konto mehr als 72.000 Nachrichten sendet und empfängt, werden neue Nachrichten nicht im Instagram-Postfach angezeigt und dein professionelles Instagram-Konto kann keine neuen Nachrichten senden, bis das Nachrichtenaufkommen abnimmt.

Die Banner werden in der Unterhaltung angezeigt und melden, dass die Obergrenze erreicht wurde. Diese Banner werden nicht mehr angezeigt, wenn das Nachrichtenaufkommen abnimmt.

  • Deine Nachricht wird möglicherweise verzögert zugestellt. Die Zustellung deiner Nachricht kann länger als gewöhnlich dauern, da [dein Kontoname] eine große Anzahl von Nachrichten erhält.

  • Deine Nachricht wurde nicht zugestellt. Deine Nachrichten wurden nicht zugestellt, da [dein Kontoname] eine große Anzahl von Nachrichten erhält. Versuche es später erneut.

Professionelles Instagram-Konto

Du musst über ein professionelles Instagram-Konto verfügen, um Instagram-Nachrichten zu senden und zu empfangen. Dadurch kann deine App über die mit deinem Konto verknüpfte Facebook-Seite auf Daten von den Meta Social Graph-Endpunkten zugreifen. Mehr erfahren.

Instagram-spezifische IDs

Wenn eine Person eine Nachricht an ein professionelles Instagram-Konto sendet, wird eine Instagram-spezifische ID erstellt, die diese Person in dieser App repräsentiert. Diese ID ist spezifisch für die Person und das Instagram-Konto, mit dem sie interagiert. Dies ermöglicht es einem professionellen Instagram-Konto, Interaktionen derselben Person über mehrere Messaging-Apps hinweg zuzuordnen.

Meta-Registrierung

Du musst dich als Entwickler*in registrieren und deine App bei Meta registrieren, um Aufrufe an den Meta Social Graph zu senden. Mehr erfahren.

Seitenspezifische IDs

Wenn eine Person eine Nachricht an eine Facebook-Seite sendet, wird eine seitenspezifische ID erstellt, die diese Person auf dieser Seite repräsentiert. Diese ID ist spezifisch für die Person und die Seite, mit der sie interagiert. Dies ermöglicht es einer Seite, Interaktionen derselben Person über mehrere Messaging-Apps hinweg zuzuordnen.

Seitenaufgaben

Die Person, die den Seitenzugriffsschlüssel anfordert, muss in der Lage sein, die MESSAGING-Aufgabe durchzuführen, um Nachrichten zu senden, und die MODERATE-Aufgabe durchzuführen, um Kommentare auf der Facebook-Seite zu beantworten, die mit deiner Messaging-App verknüpft ist. Mehr erfahren.

Partnerverzeichnis

Finde einen Partner mit Erfahrung mit der Messenger-Plattform in unserem Meta-Partnerverzeichnis .

Berechtigungen

Deine App muss über Facebook Login für Messenger-Unterhaltungen die folgenden Berechtigungen anfordern:

  • pages_show_list
  • pages_manage_metadata
  • pages_messaging
  • pages_read_engagement
  • business_management

Um auf Instagram-Nachrichten zugreifen zu können, musst du außerdem Folgendes anfordern:

  • instagram_basic
  • instagram_manage_messages

Anfordern der Berechtigung business_management

Weise beim Anfordern der Berechtigung business_management in der App-Review-Einreichung auf Folgendes hin:

  1. Diese Berechtigung wird als Abhängigkeit für die Berechtigungen pages_messaging und pages_show_list angefordert.
  2. Weise bei Instagram Messaging darauf hin, dass diese Berechtigung als Abhängigkeit für die Berechtigung instagram_manage_messages angefordert wird.
  3. Zeige im App-Review-Screencast deutlich, wie der*die Seitenadministrator*in den Facebook Login-Vorgang durchläuft, die Seiten oder Instagram-Handles auswählt und die nötigen Berechtigungen für die App gewährt.

Denke daran, den*die Seitenadministrator*in in deiner App daran zu erinnern, der App ausdrücklich Berechtigungen zur Verwaltung der Business-Assets zu erteilen. Du musst die Berechtigung business_management im Rahmen des Facebook Login for Business-Vorgangs hinzufügen.

Richtlinien

Um Zugriff auf den Meta Social Graph zu erhalten und diesen beizubehalten, musst du die Richtlinien der Messenger-Plattform, die Nutzungsbedingungen sowie die Richtlinien der Meta-Plattform und unsere Gemeinschaftsstandards einhalten. Mehr erfahren.

Richtlinienanforderungen für Bots

In verschiedenen Ländern gelten möglicherweise unterschiedliche Anforderungen für Nachrichten, die von einer Unternehmensseite oder einem professionellen Instagram-Konto gesendet werden. Bitte mache dich mit diesen Richtlinien sowie anderen von uns durchgesetzten Plattformrichtlinien vertraut.

Durchsatzratenbegrenzung

Durchsatzratenbegrenzungen für die Messenger-Plattform hängen von der verwendeten API und in einigen Fällen auch vom Nachrichteninhalt ab.

Messenger API

Aufrufe deiner App werden gegen die Anzahl der Aufrufe gezählt, die sie während eines rollierenden Zeitfensters von 24 Stunden durchführen kann, und wie folgt berechnet:

Aufrufe innerhalb von 24 Stunden = 200 * Anzahl der aktiven Nutzer*innen

Die Anzahl der aktiven Nutzer*innen ist die Anzahl der Personen, denen das Unternehmen im Messenger Nachrichten senden kann.

Messenger API für Instagram

Aufrufe deiner App werden gegen die Anzahl der Aufrufe, die sie je professionellem Instagram-Konto durchführen kann, und anhand der verwendeten API gezählt.

Conversations API

  • Je professionellem Instagram-Konto kann deine App zwei Aufrufe pro Sekunde durchführen

Send API

  • Bei Nachrichten, die Text, Links, Reaktionen und Sticker beinhalten, kann deine App 100 Aufrufe pro Sekunde je professionellem Instagram-Konto durchführen
  • Bei Nachrichten, die Audio- oder Video-Inhalte beinhalten, kann deine App 10 Aufrufe pro Sekunde je professionellem Instagram-Konto durchführen

Private Replies API

  • Bei privaten Antworten auf Instagram Live-Kommentare kann deine App 100 Aufrufe pro Sekunde je professionellem Instagram-Konto durchführen
  • Bei privaten Antworten auf Instagram-Beiträge und -Reels kann deine App 750 Aufrufe pro Stunde je professionellem Instagram-Konto durchführen

Webhooks

Meta-Webhooks sind Echtzeitbenachrichtigungen, mit denen du Informationen über Nachrichten erhalten kannst, die an deine Unternehmensseite oder dein professionelles Instagram-Konto gesendet wurden, ohne den Meta Social Graph aufrufen zu müssen, was zu einer Durchsatzratenbegrenzung führen könnte. Du musst Webhooks einrichten, um Benachrichtigungen über Nachrichten zu erhalten, die an deine Unternehmensseite oder professionelles Instagram-Konto gesendet werden, um Durchsatzratenbegrenzungen zu vermeiden.

Nächste Schritte

  • Webhooks einrichten  – Erfahre, wie du HTTP-Benachrichtigungen in Echtzeit für von deiner App gesendete und empfangene Nachrichten erhältst.

Mehr dazu

Erfahre mehr über die Messenger-Plattform in unseren Entwicklungsvideos . Zu den Videos gehören Schritt-für-Schritt-Anleitungen, Best Practices, aufgezeichnete Veranstaltungen und mehr.