Messenger
Verbinden Sie eine Facebook-Seite über Meta-Messenger-Platform-Zugangsdaten und signierte Webhooks.
Verbinden Sie eine Facebook-Seite über Meta-Messenger-Platform-Zugangsdaten und signierte Webhooks.
Meta-App und Seite vorbereiten#
Folgen Sie dem offiziellen Einstiegsleitfaden zur Messenger Platform von Meta. Fügen Sie Messenger zu einer Meta-App hinzu, verbinden Sie die Facebook-Seite, die Nachrichten empfangen soll, und stellen Sie sicher, dass Ihr Konto beide Assets verwalten kann.
Erfassen Sie die Werte aus derselben App und derselben Seite:
| Feld in Make Agent Fast | Wert des Anbieters | Zweck |
|---|---|---|
| Seitenzugriffstoken | Für die ausgewählte Seite ausgestelltes Token | Liest die Identität der Seite und sendet Antworten |
| App-Geheimnis | 32-stelliges hexadezimales Meta-App-Geheimnis | Überprüft signierte eingehende Webhook-Anfragen |
Verwenden Sie kein Benutzerzugriffstoken und kein Token, das zu einer anderen Seite gehört. Der Entwicklungs- bzw. Prüfstatus der Meta-App bestimmt, welche Personen die Integration nutzen können.
Zugangsdaten speichern und validieren#
Öffnen Sie die Seite Channels des Agents, wählen Sie Messenger, geben Sie das Seitenzugriffstoken und das App-Geheimnis ein und wählen Sie Verbinden.
Make Agent Fast ruft die Graph API mit appsecret_proof auf, ermittelt die Seiten-ID und den Seitennamen und bindet eingehende Ereignisse an genau diese Seite. Anschließend zeigt die Connector-Karte die Webhook-URL und das Verify-Token an.
Webhook der Seite konfigurieren#
In derselben Meta-App:
- Öffnen Sie die Messenger-Webhook-Einstellungen.
- Fügen Sie die Webhook-URL und das Verify-Token des Connectors ein.
- Schließen Sie die Verifizierungsabfrage ab.
- Wählen Sie das für den Messenger-Workflow erforderliche Abonnement für Nachrichtenereignisse.
- Abonnieren Sie die gewünschte Facebook-Seite für die App.
- Bestätigen Sie, dass das Seitenabonnement und der App-Modus Ihren Testnutzer zulassen.
Das Verify-Token wird nur für die erste Abfrage verwendet. Ereignisse zur Laufzeit müssen eine Signatur tragen, die zum App-Geheimnis passt. Make Agent Fast weist außerdem Ereignisse zurück, die an eine andere Seite adressiert sind, selbst wenn sie von derselben Meta-App stammen.
Funktionen testen#
Senden Sie von einem zugelassenen Testkonto ohne Administratorrolle eine normale Nachricht an die Seite und prüfen Sie die Antwort sowie den Thread unter Konversationen. Testen Sie anschließend einen Audioanhang, falls eingehende Sprachnachrichten für Ihren Workflow wichtig sind.
Text und unterstütztes eingehendes Audio werden verarbeitet. Antworten erfolgen im aktuellen Messenger-Connector ausschließlich als Text, auch wenn die ursprüngliche Nachricht eine Sprachnachricht war. Zustellungs- und Lesebestätigungen, Echos der eigenen Nachrichten der Seite, Bilder und andere nicht unterstützte Anhänge werden ignoriert.
Produktionsreife#
Schließen Sie die Schritte zu Berechtigungen, App-Prüfung, Unternehmensverifizierung, Datenschutz-URL und Veröffentlichung der Seite ab, die Meta für Ihre Zielgruppe verlangt. Ein Erfolg im Entwicklungsmodus mit einem Konto mit App-Rolle belegt nicht, dass die Öffentlichkeit der Seiten-Integration Nachrichten senden kann.
Dokumentieren Sie die zuständige Meta-App und die Seiten-ID für Ihre Administratoren. Ein Seitentoken kann ungültig werden, wenn sich sein Inhaber, die Berechtigungen, die Business-Zuordnung oder die Richtlinien des Anbieters ändern.
Rotieren oder trennen#
Erzeugen Sie das neue Seitentoken, aktualisieren Sie den Connector, testen Sie mit einem zugelassenen Nutzer und machen Sie anschließend das alte Token ungültig. Aktualisieren Sie Make Agent Fast unmittelbar nach der Rotation des App-Geheimnisses.
Das Deaktivieren oder Entfernen des Connectors hebt das Abonnement der Seite bei Meta nicht auf. Entfernen Sie bei der endgültigen Außerbetriebnahme der Integration das Seitenabonnement und die nicht mehr benötigten Zugangsdaten beim Anbieter.
Fehlerbehebung#
| Symptom | Lösung |
|---|---|
| Token wird abgelehnt | Prüfen Sie, ob es sich um ein Seitentoken für die vorgesehene Seite handelt und ob das App-Geheimnis zur selben App gehört |
| Webhook-Verifizierung schlägt fehl | Kopieren Sie die aktuelle URL und das Verify-Token exakt; verwenden Sie öffentliches HTTPS |
| Verifizierung funktioniert, aber Nachrichten kommen nicht an | Abonnieren Sie die Seite und das Nachrichtenereignis und prüfen Sie dann App-Modus, Nutzerrolle und die Zustellungsprotokolle von Meta |
| Anfragen sind nicht autorisiert | Korrigieren Sie das App-Geheimnis; signierte POST-Anfragen verwenden nicht das Verify-Token |
| Eingehende Nachricht erscheint, aber keine Antwort | Prüfen Sie die Gültigkeit des Seitentokens, die Messaging-Berechtigungen, Sendefehler des Anbieters und den Connector-Status |
| Auf eine Sprachnachricht folgt eine Textantwort | Erwartetes Verhalten; ausgehende Sprachnachrichten werden in Messenger derzeit nicht unterstützt |
Zugangsdaten des Anbieters gehören ausschließlich in das authentifizierte Connector-Formular oder in einen vertrauenswürdigen serverseitigen API-Aufruf.