Facebook Messenger-Einrichtung

Stand: Juni 2026

Die Facebook Messenger-Integration erlaubt Kunden, Ihr Support-Team über Nachrichten an eine Facebook Page zu kontaktieren. Eingehende Page-Nachrichten werden als i-net HelpDesk-Tickets erfasst und aus der Tickets-Anwendung beantwortet.

Meta-App vorbereiten

Vor der Konfiguration in i-net HelpDesk benötigen Sie eine Meta-App und die Facebook Page, über die Kunden schreiben sollen:

Melden Sie sich bei Meta for Developers an.
Erstellen oder öffnen Sie eine Business-App und fügen Sie das Messenger-Produkt oder den Anwendungsfall Mit Kunden im Messenger from Meta interagieren hinzu.
Wenn Meta nach der Erstellung das App-Dashboard öffnet, wird die Page-Auswahl dort nicht direkt angezeigt. Klicken Sie im Bereich App-Anpassung und Anforderungen auf Anwendungsfall "Mit Kunden im Messenger from Meta interagieren" anpassen. Alternativ öffnen Sie links Anwendungsfälle und passen dort den Messenger-Anwendungsfall an.
Suchen Sie auf der Anpassungsseite des Messenger-Anwendungsfalls den Bereich für Messenger API, Page-Einrichtung oder Zugriffstoken. Klicken Sie abhängig davon, ob eine Page bereits eingerichtet und verbunden wurde, auf Page hinzufügen, Page verbinden, Page auswählen oder Token generieren für die Page.
Folgen Sie dem Facebook-Berechtigungsdialog von Meta. Melden Sie sich mit einem Konto an, das die Page verwalten darf, oder verwenden Sie einen Systemnutzer mit entsprechender Page-Berechtigung. Wählen Sie die Page aus, an die Kunden schreiben sollen, und gewähren Sie die angeforderten Berechtigungen. Wenn die Page nicht erscheint, prüfen Sie zuerst in den Meta Business-Einstellungen, ob die Page zum ausgewählten Business gehört und ob Ihr Benutzer Verwaltungszugriff auf die Page hat.
Erzeugen Sie einen Page-Zugriffstoken für diese Page. Der Token muss für eine Person mit Page-Verwaltungsrechten oder für einen Systemnutzer ausgestellt sein und benötigt die Berechtigungen pages_messaging und pages_manage_metadata. Meta führt pages_show_list außerdem als Abhängigkeit für Page-Verwaltung und Page-Subscription-Operationen auf.
Für den Produktivbetrieb schalten Sie die App in den Live-Modus und schließen App-Review und Unternehmensverifizierung ab, wenn Meta Advanced Access für die Page-Berechtigungen verlangt.
Notieren Sie die folgenden Werte aus Meta:

Wert	Fundstelle
Page-Zugriffstoken	Messenger-API-Einrichtung, Graph API Explorer oder Page-Zugriffstoken eines Systemnutzers für den Produktivbetrieb
Facebook Page-ID	Messenger-API-Einrichtung, Page-Details oder die von Meta gelieferte Page-Liste
App-Geheimcode	App-Einstellungen → Allgemeines
Webhook-Verifizierungstoken	Ein frei gewähltes Kennwort. Tragen Sie denselben Wert in i-net HelpDesk ein. i-net HelpDesk verwendet ihn, wenn Meta die Rückruf-URL verifiziert

Nützliche Meta-Referenzen: Messenger Platform Quick Start, Permissions Reference, App Subscriptions und Page subscribed_apps.

Wichtig: Verwenden Sie für den Produktivbetrieb einen dauerhaften Page-Zugriffstoken. Kurzlebige Test-Token aus dem Graph API Explorer eignen sich nur für Einrichtungstests.

In i-net HelpDesk konfigurieren

Öffnen Sie Konfiguration → Kommunikation → Messenger-Kanäle.
Klicken Sie auf Messenger hinzufügen... und wählen Sie Facebook Messenger.
Tragen Sie die Werte aus Meta in die Gruppen Konto und Verbindung ein:

Feld	Gruppe	Beschreibung
Aktiv	Konto	Schaltet das Facebook Messenger-Konto ein oder aus
Webhook-URL	Konto	Wird automatisch angezeigt. Sie basiert auf der externen Server-URL und endet mit `/hooks/messenger/facebook`
Ticket-Ressource	Konto	Optional. Ressource für neue Tickets aus diesem Kanal
Page-Zugriffstoken	Verbindung	Facebook-Page-Zugriffstoken mit Messenger- und Metadaten-Berechtigungen. i-net HelpDesk speichert ihn verschlüsselt
Facebook Page-ID	Verbindung	Page-ID, die als Absender und als Ziel der Webhook-Subscription verwendet wird
App-Geheimcode	Verbindung	Geheimcode derselben Meta-App, die das Page-Zugriffstoken ausgestellt hat. i-net HelpDesk speichert ihn verschlüsselt und nutzt ihn für die Webhook-Signaturprüfung
Webhook-Verifizierungstoken	Verbindung	Ihr selbst gewähltes Verifikationskennwort. i-net HelpDesk speichert es verschlüsselt

Setzen Sie Aktiv und klicken Sie in der Gruppe Verbindung auf Prüfen.
Wenn Verbindung gültig. erscheint, bestätigen Sie den Kontodialog mit OK.

Wenn die Prüfung erfolgreich ist oder das aktive Konto übernommen wird, registriert i-net HelpDesk den Page-Webhook und abonniert die Page in Meta automatisch. Eine manuelle Webhook-Einrichtung in Meta ist normalerweise nicht erforderlich.

Wichtig: Die Externe Server-URL in i-net HelpDesk muss HTTPS verwenden und aus dem Internet erreichbar sein, bevor Meta die Rückruf-URL verifizieren kann.

Hinweis: Pro i-net HelpDesk-Installation kann aktuell eine Facebook Page konfiguriert werden.

Hinweis: Den App-Geheimcode tragen Sie nur in i-net HelpDesk ein. Im Meta-Webhook-Formular gehört das Webhook-Verifizierungstoken in das passende Feld, nicht der App-Geheimcode.

Befehle für Kunden

Kunden können diese Textbefehle senden:

/finish – Schließt das aktuelle Support-Ticket
/support – Fordert menschliche Unterstützung für das aktuelle Ticket an. Das ist vor allem relevant, wenn Messenger-KI zuerst antwortet oder eine KI-Unterhaltung an Support-Mitarbeiter übergeben werden soll

Verhalten und Grenzen

i-net HelpDesk speichert die Facebook Messenger-Absender-ID als Facebook Messenger-Benutzer-ID und kann sie verwenden, um eingehende Nachrichten bestehenden i-net HelpDesk-Benutzern zuzuordnen.
Unbekannte Facebook Messenger-Kontakte werden nur dann als i-net HelpDesk-Benutzer angelegt, wenn Unbekannte Benutzer aus Messenger-Anfragen anlegen auf der Messenger-Kanäle-Seite aktiviert ist.
Eingehende Anhänge werden heruntergeladen, wenn das Attachments-Plugin geladen ist. Andernfalls werden sie ignoriert.
Supporter-Textantworten werden über die Facebook Page Send API gesendet. Antwortanhänge aus i-net HelpDesk werden nicht an Facebook Messenger gesendet, weil Facebook für ausgehende Mediennachrichten eine öffentliche Medien-URL verlangt.
Facebook kann Antworten ablehnen, wenn das Antwortfenster überschritten ist oder das Page-Zugriffstoken nicht mehr die nötigen Berechtigungen hat.

Fehlerbehebung

Prüfung schlägt sofort fehl: Prüfen Sie, ob das Page-Zugriffstoken zur gleichen Meta-App gehört wie der App-Geheimcode, ob der Token pages_messaging und pages_manage_metadata enthält und ob die Page vom Token-Inhaber verwaltet werden darf.
Webhook-Verifikation in Meta schlägt fehl: Die externe Server-URL muss öffentlich per HTTPS erreichbar sein, das Konto muss dasselbe Webhook-Verifizierungstoken verwenden, und der Token in Meta muss exakt übereinstimmen.
Keine Nachrichten in i-net HelpDesk: Prüfen Sie den Kontostatus in i-net HelpDesk, die Page-ID und das Nachrichten-Abonnement auf App- und Page-Ebene in Meta.
Antworten werden nicht zugestellt: Prüfen Sie, ob das Page-Zugriffstoken noch gültig ist und ob Meta die Antwort für die aktuelle Konversation erlaubt.