Konfiguration der Facebook-Integration

Einführung

Die Facebook-Integration von 3CX ermöglicht es Ihnen, über Facebook-Seiten verschickte Nachrichten direkt beantworten zu können, ohne beim Facebook Messenger angemeldet sein zu müssen. Facebook-Nachrichten können an eine Warteschleife, Rufgruppe oder einzelne Nebenstelle übertragen werden. 3CX-Agenten können bei Bedarf zudem einen Facebook-Chat übernehmen und Nachrichten an andere Agenten(gruppen) weiterleiten.

Wichtiger Hinweis: Zur Nutzung der Facebook-Integration muss ein verifiziertes Facebook-Unternehmenskonto vorliegen.

Schritt 1: Erstellen einer Facebook-App

1. Navigieren Sie zu https://developers.facebook.com/?locale=de_DE und klicken Sie oben rechts auf "Anmelden“.
2. Navigieren Sie zu "Meine Apps“.
3. Klicken Sie auf "App erstellen“.
4. Wählen Sie die Option "Andere“ und klicken Sie auf "Weiter“.
5. Wählen Sie “Andere” aus.
6. Wählen Sie “Business” aus.
7. Geben Sie Ihrer Anwendung einen Anzeigenamen, geben Sie eine Kontakt-E-Mail-Adresse ein und verwenden Sie die Drop-Down-Liste, um Ihr Geschäftskonto auszuwählen. Klicken Sie auf "App erstellen“.
8. Klicken Sie auf “Messenger > Einrichten”.

9. Auf dem nächsten Bildschirm können Sie Produkte zu Ihrer App hinzufügen. Scrollen Sie nach unten zu "Messenger“ und klicken Sie auf "Messenger-API-Einstellungen“.
10. Scrollen Sie nach unten zum Abschnitt "Zugriffstokens“ und klicken Sie auf “Verbinden”.
11. Klicken Sie auf "Weiter als (Nutzername)“ und wählen Sie dann mithilfe des Kontrollkästchens die Seite(n) aus, die Sie integrieren möchten.
12. Klicken Sie auf "Weiter“ und füllen Sie die folgenden Bestätigungsmeldungen aus.
13. Ihre Facebook-Seite wird nun im Abschnitt "Zugriffstokens“ aufgeführt.
14. Klicken Sie auf "Token generieren“. Aktivieren Sie im Popup-Fenster das Kästchen "Ich verstehe“, kopieren Sie das Token in einen Notizblock und klicken Sie auf "Fertig“.
15. Kopieren Sie abschließend die Seiten-ID (unter Ihrem Seitennamen angezeigt) in einen Notizblock.

Schritt 2: Konfiguration der Facebook-App in 3CX

1. Melden Sie sich an Ihrem 3CX-Webclient an, und navigieren Sie zu "Admin > Trunks & Chat", und klicken Sie auf "Facebook hinzufügen".
2. Ändern Sie den standardmäßig vorgegebenen Namen in Ihren für Facebook gewählten Anzeigenamen.
3. Wenn Sie  "Systemeigentümer " oder  "Systemadministrator " sind, kann die Integration systemweit oder gruppenbezogen verfügbar gemacht werden.
4. Fügen Sie Ihre Seiten-ID und Ihren Zugriffstoken ein, die Sie in Schritt 1 kopiert haben.
5. Kopieren Sie den angezeigten 3CX-Webhook in einen Text-Editor, und klicken Sie auf "Speichern".
6. Klicken Sie auf "Nutzer", und erstellen Sie nur zu Testzwecken einen neuen Nutzer, der im nachfolgenden Schritt 4 zum Überprüfen der Facebook-App benötigt wird.
7. Überprüfen Sie, ob die Weiterleitung von Nachrichten an Ihren Testnutzer konfiguriert ist. Weiterführende Informationen hierzu erhalten Sie in der Anleitung zum Digitalen Rezeptionisten (IVR).

Schritt 3: Konfigurieren Ihres 3CX Webhooks in Facebook

1. Rufen Sie erneut das Entwicklerportal von Meta auf.
2. Navigieren Sie zu “Apps”, wählen Sie Ihre App aus, und klicken Sie auf “Bearbeiten”. Klicken Sie in den Messenger-API-Einstellungen auf “Webhooks konfigurieren > Konfigurieren”.
3. Fügen Sie Ihren zuvor generierten 3CX-Webhook im Bereich zur Rückruf-URL ein.
4. Geben Sie zur Überprüfung des Tokens eine beliebige Zeichen- und Zahlenfolge ein. Diese wird nur einmalig benötigt und muss daher nicht gespeichert werden. Klicken Sie auf “Überprüfen und speichern”.

5. Klicken Sie auf “Abonnements hinzufügen”, und markieren Sie die folgenden Kontrollkästchen:

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

6. Klicken Sie abschließend auf “Speichern”.

Ihre Facebook-App kann nun gemeinsam mit 3CX eingesetzt werden. Senden Sie jetzt eine Facebook-Testmitteilung. Zum aktuellen Zeitpunkt befindet sich Ihre App im Entwicklungsmodus, sodass Sie nur mit Nutzern kommunizieren können, die zur Verwaltung Ihrer Seite berechtigt sind. Wenn Sie in den Live-Modus wechseln möchten, müssen Sie von Facebook weitere Berechtigungen anfordern und Ihre App durch Facebook per App Review überprüfen lassen.

Schritt 4: Überprüfen der App durch Facebook

1. Navigieren Sie zu “App-Einstellungen > Grundlegend)”. Scrollen Sie zum Ende der Seite, und klicken Sie auf "Plattform hinzufügen”.
2. Wählen Sie "Website", und klicken Sie auf “Weiter”.
3. Geben Sie die URL Ihres 3CX-Webclients ein (z. B. https://exampledomain.com/webclient/), und klicken Sie auf “Änderungen speichern”.

4. Navigieren Sie zu “App-Review > Berechtigungen und Features”.
5. Suchen Sie nach "pages_messaging", und klicken Sie auf “Erweiterten Zugriff anfordern”.

Hinweis: Haben Sie die obigen Schritte durchgeführt, kann es nach dem Versenden oder Empfangen von Testmitteilungen im Entwicklungsmodus bis zu 24 Stunden dauern, bis die entsprechende Schaltfläche angezeigt wird.

6. Suchen Sie nach dem Zugriff auf Business-Asset-Nutzerprofileund klicken Sie erneut auf ““Erweiterten Zugriff anfordern”. Klicken Sie auf die Schaltfläche zum Bearbeiten der App-Überprüfungsanfrage.

Hinweis: Um fortzufahren, reichen Sie eine Geschäftsbestätigung ein.

7. Klicken Sie auf den blauen Pfeil, um das Formular „Fragen zur Datenverarbeitung“ auszufüllen und abzusenden. (Dieser Abschnitt wird angezeigt, nachdem die „Geschäftsüberprüfung“ übermittelt wurde.)
8. Klicken Sie auf den blauen Pfeil, um das Formular „App-Einstellungen“ auszufüllen. Fügen Sie dazu ein Bild für Ihr App-Symbol hinzu, geben Sie die URL Ihrer Datenschutzrichtlinie ein und wählen Sie im Dropdown-Feld Ihre App-Kategorie „Messaging“ aus. Klicken Sie auf „Speichern“. (Dieser Abschnitt wird angezeigt, nachdem Sie die Fragen zur Datenverarbeitung abgeschickt haben.)
9. Klicken Sie auf den blauen Pfeil, um den Abschnitt „Anweisungen für Prüfer“ auszufüllen. Tragen Sie dazu die Anmeldedaten Ihres temporären Testbenutzers ein, der am Ende von Schritt 2 erstellt wurde, und fügen Sie diese in das erste Pflichtfeld ein (der Rest kann leer bleiben).

                Step 1. Log in to the 3CX WebClient with the following credentials:

• PBX Web client URL: https://exampledomain:5001/webclient
• Extension: ________
• Password: ________

Step 2. Write and send a test message on the Facebook Page.

Step 3. Receive and reply to the message in your 3CX Web Client.

10. Klicken Sie anschließend im nächsten Abschnitt mit der Überschrift „Wie verwendet diese App pages_messaging?“ auf den blauen Pfeil.
11. Kopieren Sie den folgenden Text und fügen Sie ihn in das erste Feld „Detaillierte Beschreibung“ ein.
    

This Facebook App is used to integrate 3CX Phone System (https://3cx.com) with Facebook Messenger chats. Each 3CX customer has their own 3CX instance and therefore will need to create their own App to integrate a Facebook Page. “pages_messaging” is required to receive and send messages started by a Facebook Page visitor.

12. Wählen Sie unter „Funktionalität Ihrer Integration testen und reproduzieren“ Ihre Facebook-Seite über das Dropdown-Menü aus. Tragen Sie anschließend die Anmeldedaten Ihres temporären Testbenutzers ein, den Sie am Ende von Schritt 2 erstellt haben.

                Step 1. Log in to the 3CX WebClient with the following credentials:

• PBX Web client URL: https://exampledomain:5001/webclient
• Extension: ________
• Password: ________

Step 2. Write and send a test message on the Facebook Page.

Step 3. Receive and reply to the message in your 3CX Web Client.

13. Nun müssen Sie einen Screencast aufzeichnen, der eine Nachricht zeigt, die an Ihre Facebook-Seite gesendet, vom Webclient empfangen und vom Webclient beantwortet wird. Es gibt viele kostenlose Bildschirmaufzeichnungsoptionen, darunter Loom und Screenrec.
14. Klicken Sie nach der Aufnahme auf „Datei hochladen“ und wählen Sie Ihren Screencast aus.
15. Aktivieren Sie das Bestätigungsfeld und klicken Sie auf „Speichern“.
16. Klicken Sie anschließend auf den blauen Pfeil im Abschnitt „Wie nutzt diese App den Zugriff auf das Benutzerprofil des Unternehmensvermögens?“.
17. Kopieren Sie den folgenden Text und fügen Sie ihn in das Feld mit der ausführlichen Beschreibung ein.

This Facebook App is used to integrate 3CX Phone System (https://3cx.com) with Facebook Messenger chats. Each 3CX customer has their own 3CX instance and will create their own App to integrate their Facebook Page. 3CX needs “Business Asset User Profile Access” because it exposes the user's name and picture for identification of chat users by agents. 3CX is using the name and picture attributes.

18. Laden Sie denselben Screencast hoch, den Sie zuvor aufgenommen haben, aktivieren Sie das Bestätigungsfeld und klicken Sie auf „Speichern“.

19. Klicken Sie auf „Zur Überprüfung einreichen“, geben Sie zur Überprüfung Ihr Facebook-Passwort ein und Sie sehen eine erfolgreiche Übermittlung Ihrer Bestätigungsnachricht.

20. Verwenden Sie abschließend die Umschalttaste oben auf dem Bildschirm, um Ihren „App-Modus“ von „Entwicklung“ auf „Live“ zu ändern.

Sobald Ihre Bewerbung genehmigt wurde, erhalten Sie Nachrichten von Facebook-Nutzern. Löschen Sie Ihren temporären Testnutzer, der für die App-Verifizierung erstellt wurde, und aktualisieren Sie Ihre Nachrichtenweiterleitung 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 27. Juni 2025 aktualisiert.

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