FAQs

Apps können von der App-Website mithilfe des Facebook Login installiert werden und indem einer bestimmten Seite die Berechtigung „pages_messaging“ erteilt wird. Zugelassene Apps werden in den Seiteneinstellungen unter Erweitertes Messaging angezeigt.

Ja, eine Facebook-App kann mehrere Seiten abonnieren. Nachdem sie zur App-Überprüfung eingereicht wurde, wie die Berechtigung pages_messaging, kann die App den Erhalt von Webhooks auf mehreren Seiten abonnieren. Es obliegt dir, den Kontext jedes Webhooks anhand des Payloads abzurufen.

Ja, es können auch mehrere Apps eine Seite abonnieren. Wenn mehrere Apps mit derselben Unterhaltung arbeiten, sollte am besten mit dem Übergabeprotokoll verwaltet werden, welcher Bot jeweils gerade die Threadsteuerung übernimmt.

Die häufig gestellten Fragen zur DSGVO und der Messenger-Plattform findest du unter „Messenger-Plattform und Datenschutz-Grundverordnung“.

Wenn du das Plugin „An Messenger senden“ verwendest, kann der data-ref-Parameter als Passthrough-Parameter genutzt werden, um Informationen zum Klick-Kontext zu übermitteln.

Personen entdecken deine Seite möglicherweise bei der Suche in Messenger. In diesen Fällen ist kein Passthrough-Parameter verfügbar. Du kannst die Kontoverknüpfungsfunktion verwenden, um einen Thread mit einem Nutzerkonto auf deiner Seite zu verknüpfen.

Wenn sich eine App im Entwicklungsmodus befindet, ist das Plugin nur für Administratoren, Entwickler und Tester der App sichtbar. Nachdem die App geprüft und genehmigt wurde, kannst du deine App der allgemeinen Öffentlichkeit zugänglich machen. Verwende dazu den „App Review“-Tab im App-Dashboard.

No. Unlike subscriptions where a business can send multiple messages to people on a recurring basis, the one-time notification API limits the business to a single message per user request. If the person engages with the message, the standard messaging window will reopen.

Yes. Pages interested in using the One-time Notification API need to apply for permission. Go to the Advanced Messaging section of your Page Settings and consent to the terms. A Page will be granted permission if the Page meets our criteria.

Common uses of the API include various promotional and non-promotional use cases where the User explicitly requested a follow-up. Examples include:

• Back in stock alerts
• Collection launches
• Concert tickets going on sale
• Price drop alerts
• Train tickets available for purchase
• CSAT surveys

Your Page is not allowed to send a notification on a topic for which the User has not agreed to receive a notification. Please see the Usage and Restrictions and Limitations sections of the One-time Notification guide for more information.

A Page can send multiple requests however, the 24-hour policy will be applied to all the requests being sent. We also have controls in place to prevent spamming users with multiple requests.

The 24 hour standard messaging window will open only if the user interacts with the opt-in message. The behavior is consistent with interactions with other elements in the Messenger experience.

Pages will need to subscribe to message_optins webhook to receive notifications about User consent.

Once a person asks to be notified, the Page will receive a token which is equivalent to a permission to send a single message to the person. The token can be used to send a message to the person outside the 24 hour window. The token can only be used once and unused tokens will expire within 1 year of creation.

Yes. However, while it is possible to send another notification request using an existing token, there is no clear benefit for the business to send these type of requests.

Token is for one-time use only. Once a token is used it can not be used again.

No. The API does not return tokens available to a Page.

Page level. Permissions for the One-time Notification API are given at the Page level.

No. The app does not need to specify any message tags when sending a message outside the 24-hour standard messaging window using this API.

Dafür gibt es verschiedene Gründe:

• Du verwendest eine ID von Facebook Login. Nutzer-IDs von Facebook Login können nicht in Verbindung mit der Send/Receive API verwendet werden. Es können auf der Messenger-Plattform nur Nutzer-IDs verwendet werden, die durch eine entsprechende Authentifizierung mit der Plattform bereitgestellt wurden.
• Du nutzt eine ID mit fehlerhaftem Seiten-Zugriffsschlüssel. Nutzer-IDs für die Messenger-Plattform sind seitenspezifisch, d. h. auf eine bestimmte Seite bezogen. Wenn du eine gültige Nutzer-ID verwendest, der Seiten-Zugriffsschlüssel jedoch einer anderen Seite zugewiesen ist, kann der Aufruf nicht funktionieren. Achte darauf, eine Nutzer-ID und einen Seiten-Zugriffsschlüssel zu verwenden, die beide derselben Seite zugewiesen sind.
• Du sendest die Nachricht an eine Telefonnummer, die noch nicht bestätigt wurde. Wenn du die Send API mit einer Telefonnummer verwendest, werden Nachrichten nur gesendet, wenn die Telefonnummer kürzlich bestätigt wurde. Selbst wenn für die Telefonnummer angegeben ist, dass sie bestätigt ist, schlägt der Senden-Vorgang fehl, wenn keine kürzliche Bestätigung erfolgt ist. Bestätige deine Telefonnummer erneut, warte 24 Stunden und versuche es dann erneut.

Hier ist eine Problemumgehung zur Verwendung eines Plattform-Testnutzers für deine Messenger-Plattform-Integration:

1. Erstelle über die Seite „Rollen“ in deiner App einen neuen Testnutzer, indem du auf den „Hinzufügen“-Button klickst.
2. Schalte die Option „Testnutzer für diese App autorisieren?“ um und erteile die Berechtigungen "manage_pages" und "page_messaging".
3. Nutze den „Bearbeiten“-Button und rufe einen Zugriffsschlüssel für diesen Nutzer ab (mit v2.6). Speichere diesen für die spätere Verwendung.
4. Melde dich über den „Bearbeiten“-Button als Testnutzer an.
5. Erstelle nach der Anmeldung eine Seite als Testnutzer.
6. Verwende den Nutzer-Zugriffsschlüssel für den Testnutzer, um den Seiten-Zugriffsschlüssel für diesen Nutzer abzurufen. Verwende dazu den folgenden Aufruf:

   https://graph.facebook.com/v2.6/me/accounts?access_token=[TEST_USER_ACCESS_TOKEN]

   (Dokumentation)
7. Nutze diesen Seiten-Zugriffsschlüssel, um deine Facebook-App mit deiner Seite zu verknüpfen:

   https://graph.facebook.com/v2.6/me/subscribed_apps?method=POST&access_token=[TEST_USER_PAGE_ACCESS_TOKEN]
           

   (Dokumentation)
8. Wenn du diese Schritte ausgeführt hast, erhältst du RTU-Updates auf deiner Testseite. Damit kannst du nun von deiner Testseite Nachrichten an deinen Testnutzer senden. Zusätzlich zu diesen Schritten kannst du deinen Zugriffsschlüssel mit einem langlebigen Schlüssel ersetzen, falls der Zugriffsschlüssel für deine Tests zu schnell abläuft. Beachte hierzu die folgende Dokumentation:

   GET /oauth/access_token?  
       grant_type=fb_exchange_token&           
       client_id={app-id}&
       client_secret={app-secret}&
       fb_exchange_token={short-lived-token} 
           

Ja, ein Bot kann beide Nachrichtentypen enthalten. Eine Person muss die Standardnachrichten durch eine der zulässigen Handlungen auslösen und dann dem Erhalt von Abonnementnachrichten zustimmen.

Bots sind technisch nicht in der Lage, Nutzern im 24-Stunden-Zeitfenster mehr als eine Nachricht zu senden (die Nachricht wird nicht gesendet). Während der Übergangsphase für bestehende Bots werden diese Nachrichten zwar versendet, aber markiert.

Nein, die Messenger-Plattform bietet keine API, die eine Liste mit PSIDs der Personen zurückgibt, die angegeben haben, dass sie Nachrichten von deinem Bot erhalten möchten.

Um einen Rückruf zu erhalten, musst du zwei Schritte ausführen. Stelle zunächst sicher, dass dein Webhook korrekt eingerichtet ist (https://developers.facebook.com/docs/messenger-platform/webhook-reference#setup). Dort findest du Informationen, wann Webhooks korrekt eingerichtet sind.

Zweitens musst du die einzelnen Seiten abonnieren. Alle abonnierten Seiten werden aufgelistet.

Wenn Aufrufe für deinen Webhook für eine längere Zeitdauer fehlschlagen, wird das Abonnement deiner App aufgehoben und du musst deinen Webhook erneut hinzufügen und die Seite erneut abonnieren.

Webhook-Aufrufe enthalten in der Überschrift ein Feld mit dem Namen X-Hub-Signature. Damit kann validiert werden, dass die Anfrage von Facebook stammt.

Stelle sicher, dass dein Webhook immer den Statuscode 200 zurückgibt. Dies ist für uns die Information, dass der Webhook erfolgreich empfangen wurde. Wenn keine Statuscode-200-Antwort zurückgegeben wird, wird der Aufruf wiederholt, bis er erfolgreich ist. Wenn ein Webhook für einen längeren Zeitraum keine 200-Antwort zurückgibt, werden die Entwickler-Benachrichtigungen angezeigt.

Beachte, dass eine erfolgreiche Statuscode-Antwort zeitnah zurückgegeben wird. Nach 20 Sekunden erfolgt beim Webhook-Aufruf eine Zeitüberschreitung. Achte bei der Entwicklung deines Codes darauf, dass Webhooks asynchron verarbeitet werden, damit eine erfolgreiche Statuscode-Antwort umgehend zurückgegeben werden kann und die Verarbeitung separat erfolgt.

Es gibt ein Tool zur Anzeige aktueller Webhook-Fehler. Wenn Webhooks nicht zugestellt werden, heben die Facebook-Server das Abonnement deiner URL-Adresse auf. So rufst du das Tool auf: Klicke im App-Dashboard auf „Messenger > Einstellungen“ und dann auf der Webhooks-Karte auf den Button Aktuelle Fehler anzeigen.