Facebook Messenger für 3CX konfigurieren

Einführung

Facebook-Integration ermöglicht es Ihren Agenten, direkt aus 3CX auf Nachrichten Ihrer Facebook-Seite zu antworten, ohne sich bei Facebook Messenger anmelden zu müssen. Nachrichten können an eine Anrufwarteschleife, eine Rufgruppe oder eine einzelne Nebenstelle zugestellt werden. Agenten können die Eigentümerschaft einer Nachricht übernehmen oder diese an einen anderen Agenten oder eine andere Gruppe übertragen.

Ein verifiziertes Facebook-Business-Konto ist erforderlich.

Die folgende Anleitung folgt dem Update 2026 des App-Erstellungsablaufs von Meta mit optimierten Berechtigungsoptionen.

Schritt 1: Starten Sie die Konfiguration Ihrer 3CX-Telefonanlage

• Gehen Sie zu Admin > Sprach- & Chatkanäle, wählen Sie Nachrichtendienst hinzufügen und dann Facebook hinzufügen.
• Legen Sie den Namen auf Ihren bevorzugten Namen fest.
• Wenn Sie ein System-Eigentümer oder ein System-Admin sind, können Sie die Integration systemweit oder nur für die Gruppe verfügbar machen.

• Kopieren Sie die 3CX-Webhook-URL in einen Texteditor und halten Sie diese bereit.

Schritt 2: Erstellen Sie eine Facebook-Anwendung

• Navigieren Sie zu https://developers.facebook.com und klicken Sie oben rechts auf Anmelden.

• Navigieren Sie zu Meine Apps.
• Klicken Sie auf App erstellen.
• Geben Sie Ihrer Anwendung einen Anzeigennamen, geben Sie eine Kontakt-E-Mail-Adresse ein und klicken Sie auf Weiter.

• Wählen Sie die Option Business-Messaging.

• Wählen Sie die Option „Messenger von Meta“ und klicken Sie auf Weiter.
• Wählen Sie das Business-Portfolio aus, mit dem Sie diese App verbinden möchten; Sie können es auch später hinzufügen.
• Falls Meta weitere Veröffentlichungsanforderungen hat, die Sie vor dem Fortfahren erfüllen müssen, werden diese nun aufgelistet.
• Klicken Sie auf Weiter.

• Stellen Sie vor dem Erstellen der App sicher, dass der App-Name, die App-Kontakt-E-Mail-Adresse und andere Details korrekt sind; klicken Sie auf App erstellen.
• Bestätigen Sie Ihr Passwort, falls Sie dazu aufgefordert werden.

• Der nächste Bildschirm ist das App-Dashboard:

• Hier wird eine Liste der Aufgaben angezeigt, die vor der Veröffentlichung abgeschlossen werden müssen.
• Sie müssen sicherstellen, dass alle erforderlichen Aufgaben abgeschlossen sind.

• Falls Sie das Facebook-Entwicklerportal verlassen, können Sie über den Menüpunkt „Anwendungsfälle“ (Stift-Symbol) zu diesem Punkt zurückkehren.
• Wählen Sie die Option Anpassen:

• Wählen Sie Messenger-API-Einstellungen.

• Erweitern Sie Webhooks konfigurieren:

• Geben Sie den in Schritt 1 gespeicherten Webhook in das Feld Callback-URL ein.
• Geben Sie die lange Zeichenfolge nach dem letzten „/“ (z. B. aabbccddeeff000000001122334455) am Ende des Webhooks in das Feld Verify Token ein.

• Scrollen Sie nach unten und fügen Sie die erforderlichen Webhook-Felder mit der neuesten verfügbaren API-Version hinzu:

• messages
• message_deliveries
• messaging_customer_information
• message_reads
• message_echoes

• Klicken Sie auf Verifizieren und speichern.

• Erweitern Sie Zugriffstoken generieren:

• Klicken Sie auf Seite hinzufügen:

• Durchlaufen Sie den Authentifizierungsprozess und wählen Sie die Business-Seite aus, die Sie hinzufügen möchten.
• Sobald die Seite hinzugefügt wurde, notieren Sie sich die Facebook-Seiten-ID.
• Wählen Sie die Menüoption Webhook-Abonnements hinzufügen und fügen Sie hinzu:

• messages
• message_deliveries
• messaging_pre_checkouts
• messaging_customer_information
• message_reads
• message_echoes

• Klicken Sie auf Generieren, um ein API-Token zu erhalten, und speichern Sie es.
• Wenn Sie zu dieser Seite zurückkehren, können Sie den Mauszeiger über die Abonnements bewegen, um die Option Bearbeiten zu erhalten.

• Fahren Sie vorerst NICHT mit App-Überprüfung abschließen fort.

Schritt 3: Konfiguration in 3CX fortsetzen

• Gehen Sie zu Admin > Nutzer und erstellen Sie einen temporären Test-Nutzer, der für den Anwendungsüberprüfungsprozess in Schritt 4 unten verwendet wird.
• Fügen Sie Ihre Seiten-ID und Ihren Zugriffstoken ein, die Sie in Schritt 2 erhalten haben.
• Stellen Sie sicher, dass das Nachrichten-Routing auf Ihren neuen temporären Test-Nutzer konfiguriert ist.

Schritt 4: Development Modus

Ihre Anwendung ist nun für die Verwendung mit 3CX konfiguriert und Sie können versuchen, eine Nachricht an Ihre Facebook-Seite zu senden.

In diesem Stadium befindet sich Ihre App im Development-Modus, was bedeutet, dass Sie nur mit Folgendem interagieren können:

• Nutzern, die die Berechtigung haben, Ihre Seite zu verwalten
• Nutzern, die als Tester hinzugefügt wurden.

Sie können weitere Test-Nutzer über App-Dashboard > Rollen > App-Rollen > Personen hinzufügen hinzufügen.

Im Development-Modus ist in 3CX nur die numerische ID des Facebook-Nutzers sichtbar. Die Sichtbarkeit des vollständigen Namens des Facebook-Nutzers erfordert das Umschalten in den Modus „Live“.

Um in den Modus „Live“ zu wechseln, müssen Sie zusätzliche Berechtigungen anfordern und eine Anwendungsprüfung durchführen – Details im Schritt „Application Review“.

Schritt 5: Application Review

• Gehen Sie im Meta App-Dashboard zu App-Einstellungen > Basis.

• Füllen Sie die erforderlichen Angaben aus:

• Datenschutz-URL
• URL zur Nutzerdatenlöschung (kann dieselbe URL wie die Datenschutzrichtlinie sein)
• Kategorie (Wählen Sie Messaging oder Business)
• Laden Sie ein App-Symbol hoch

• Je nach Region und Geschäftsbereich müssen Sie möglicherweise den DSGVO-Abschnitt unter den Kerneinstellungen ausfüllen.
• Wählen Sie unten auf der Seite + Plattform hinzufügen.
• Geben Sie Ihre Website-URL ein und klicken Sie auf Weiter.

• Geben Sie Ihre 3CX PBX-URL ein, z. B. https://mypbx.3cx-example.com.

• Klicken Sie auf Änderungen speichern.
• Klicken Sie im Seitenmenü auf Anwendungsfälle (Stift-Symbol).
• Klicken Sie auf Anpassen und fügen Sie die Zugriffsberechtigung Business Asset User Profile hinzu.
• Klicken Sie auf Messenger-API-Einstellungen.
• Klicken Sie auf Anwendungsfall anpassen.
• Fügen Sie unter Berechtigungen und Funktionen Business Asset User Profile Access hinzu.

• Klicken Sie auf die Schaltfläche Berechtigung anfordern:

• Wählen Sie die Optionen pages_show_list & pages_manage_metadata; klicken Sie auf die Schaltfläche Berechtigung anfordern. Dadurch werden Sie auf die Seite Zur App-Überprüfung einreichen weitergeleitet.
• Öffnen Sie Ihre 3CX-Telefonanlage und melden Sie sich als der Test-Nutzer an (oder imitieren Sie diesen); gehen Sie im Web Client zu Chat.
• Öffnen Sie Ihre verbundene Facebook-Seite mit einem Konto mit Testrechten für die App.
• Stellen Sie die beiden Fenster nebeneinander und starten Sie eine Bildschirmaufzeichnung; dies ist für die Facebook-Überprüfung und -Verifizierung erforderlich.
• Führen Sie einen kurzen Messaging-Chat durch und speichern Sie das Video.
• Gehen Sie zurück zur Facebook-Seite Zur App-Überprüfung einreichen und klicken Sie auf Weiter.

• Schließen Sie alle Schritte ab und füllen Sie alle Details aus, bis Sie zu Hinweise für Prüfer gelangen. Sie müssen ein verifiziertes Konto haben, um fortzufahren.

• Auf der Seite Hinweise für Prüfer page:

• Bestätigen Sie Ihre Website-URL.
• Füllen Sie die Fragenfelder wie folgt aus:

• (instructions-web-2) Anweisungen für den Zugriff auf die App bereitstellen, damit wir unsere Überprüfung abschließen können.

Diese Facebook-App wird verwendet, um eine 3CX-Telefonanlage (https://3cx.com) mit Facebook Messenger-Chats zu integrieren. Jeder 3CX-Kunde verfügt über eine eigene 3CX-Instanz und muss daher seine eigene App erstellen, um eine Facebook-Seite zu integrieren. pages_messaging ist erforderlich, um Nachrichten zu empfangen und zu senden, die von einem Besucher der Facebook-Seite gestartet wurden.

Schritt 1. Melden Sie sich beim 3CX WebClient mit den folgenden Anmeldeinformationen an:

• PBX Web Client-URL: https://example-pbx.3cx.com/

Schritt 2. Schreiben und senden Sie eine Testnachricht auf der Facebook-Seite.

Schritt 3. Empfangen und beantworten Sie die Nachricht in Ihrem 3CX Web Client.

• (accesscode-web-1) Falls Zahlung oder Mitgliedschaft erforderlich ist, um auf den vollen Funktionsumfang dieser App zuzugreifen:

• Nebenstelle: ________
• Passwort: ________

• (documents-web-1) Unterstützende Dokumentation beifügen:

• Laden Sie Ihr zuvor aufgezeichnetes Video hoch.

• Klicken Sie auf Weiter.
• Sobald alle Abschnitte abgeschlossen sind, können Sie zur Überprüfung einreichen.

Die App kann über die Schaltfläche Veröffentlichen im Seitenmenü veröffentlicht werden. Wenn Sie vor der Genehmigung veröffentlichen, erhalten Sie möglicherweise Nachrichten im Allgemeinen, aber nicht den Namen des Absenders oder andere Details.

Sobald Ihre Anwendung genehmigt wurde, erhalten Sie Nachrichten von Facebook-Nutzern, die den Namen des Absenders anzeigen. Stellen Sie sicher, dass Sie Ihren temporären Test-Nutzer löschen, der für den App-Verifizierungsprozess erstellt wurde, und aktualisieren Sie Ihr Nachrichten-Routing auf das gewünschte Ziel.

Siehe auch

• Installieren und Konfigurieren von 3CX Live Chat
• Konfigurieren der WhatsApp-Integration
• Konfiguration von SMS/MSS
• Verwalten von Kundenanfragen

Letztes Update

Dieses Dokument wurde zuletzt am 16. September 2026 aktualisiert.

https://www.3cx.de/docs/adminhandbuch/facebook/