Verbinden eines Bots mit Facebook

  • Artikel

Sie können Ihren Bot so konfigurieren, dass er mit Personen über Facebook Messenger oder Facebook Workplace kommuniziert. In diesem Artikel wird beschrieben, wie Sie eine Facebook-App mit der Meta for Developers-Website erstellen, Ihren Bot mit Ihrer Facebook-App in Azure verbinden und Ihren Bot auf Facebook testen.

In diesem Artikel wird gezeigt, wie Sie den Facebook-Kanal über das Azure-Portal ihrem Bot hinzufügen. Weitere Informationen zur Verwendung eines benutzerdefinierten Kanaladapters finden Sie unter Weitere Informationen.

Voraussetzungen

  • Ein Azure-Abonnement. Wenn Sie noch nicht über ein Abonnement verfügen, erstellen Sie ein kostenloses Konto, bevor Sie beginnen.
  • Ein Bot, der in Azure veröffentlicht wurde, den Sie mit Facebook verbinden möchten.
  • Ein „Facebook für Entwickler“-Konto. Wenn Sie kein Konto haben, können Sie ein Konto bei developers.facebook.com erstellen.
  • Eine Facebook-Seite, von der Benutzer auf Ihren Bot zugreifen. Falls Sie noch keine besitzen, erstellen Sie eine neue Seite.
  • Wenn Sie Facebook Workplace mit Ihrem Bot verwenden möchten, müssen Sie ein Workplace-Konto und eine benutzerdefinierte Integration erstellen, um eine Verbindung mit dem Bot herzustellen.

Erstellen Sie eine Facebook-App

Benutzer greifen über eine Facebook-Seite auf Ihren Bot zu. Um den Bot zu verbinden, aktivieren Sie Facebook Messenger auf der Facebook-Seite und verbinden dann den Bot mit der Seite.

Erstellen Ihrer App

  1. Melden Sie sich bei Ihrem Meta for Developers-Konto an.
  2. Gehen Sie zu Erstellen einer neuen Facebook-App.
  3. Wählen Sie auf der Seite App-TypGeschäft und dann Weiter aus.
  4. Geben Sie auf der Seite Grundlegende Informationen bereitstellen einen Namen für Ihre App ein, und wählen Sie App erstellen.
    • Wenn Sie dazu aufgefordert werden, geben Sie Ihr Kennwort ein, und wählen Sie Übermitteln, um Ihre App zu erstellen.
    • Nachdem Ihre App erstellt wurde, wechselt die Website zu einer Seite für Ihre App.
  5. Erweitern Sie Einstellungen, und wählen Sie Grundlegend.
    1. Kopieren und speichern Sie die App-ID und das App-Geheimnis.
  6. Wählen Sie unter Einstellungen die Option Erweitert.
    1. Scrollen Sie im resultierenden Bereich nach unten zu den Sicherheitseinstellungen und aktivieren Sie den API-Zugriff auf App-Einstellungen.
    2. Klicken Sie auf Save changes (Änderungen speichern).

Messenger aktivieren

  1. Wählen Sie Dashboard aus.
  2. Scrollen Sie im resultierenden Bereich nach unten zur Messenger-Kachel und wählen Sie Einrichten.
  3. Die Website fügt Ihrer App Messenger-Einstellungen hinzu und zeigt die Einstellungsseite an.

Hinzufügen von Seiten und Generieren von Tokens

  1. Wählen Sie unter MessengerEinstellungen.

  2. Scrollen Sie nach unten zu Zugriffstokens, und wählen Sie Seiten hinzufügen oder entfernen.

    1. Wenn Sie aufgefordert werden, die Identität zu Messenger zuzuordnen, fahren Sie entweder mit Ihrem aktuellen Konto fort, oder melden Sie sich bei einem anderen an.
    2. Wenn Sie zur Eingabe der Seiten aufgefordert werden, die Sie mit Ihrer App verwenden möchten, wählen Sie die Seiten aus, und wählen Sie dann Weiter.
    3. Wenn Sie aufgefordert werden, die Anforderung für die Anmeldeüberprüfung zu übermitteln, überprüfen Sie die Informationen, und wählen Sie Fertig.
    4. Bei Erfolg zeigt die Website eine Erfolgsseite an. Klicken Sie auf OK , um fortzufahren.

  3. Die Seite, die Sie jetzt hinzugefügt haben, wird in der Liste Seiten angezeigt.

    Kopieren Sie die Seiten-ID und speichern Sie es zur späteren Verwendung.

  4. Wählen Sie Token generieren für die Seite aus.

    1. Die Website zeigt Sicherheitsinformationen an und bietet Ihnen die Möglichkeit, das Token zu kopieren.
    2. Lesen und bestätigen Sie die Warnung.
    3. Kopieren Sie den Token und wählen Sie Fertig.

Sie verfügen jetzt über Ihre App-Informationen und ein Token für den nächsten Schritt. Lassen Sie die Facebook-Einstellungsschritte ausstehend. Sie aktualisieren sie später.

Konfigurieren Sie Ihren Bot in Azure

Damit Ihr Bot Nachrichten und andere Ereignisse an Facebook Messenger senden kann, müssen Sie die Webhook-Integration aktivieren.

  1. Öffnen Sie in einer neuen Registerkarte des Webbrowsers das Azure-Portal.
  2. Öffnen Sie das Azure Bot-Ressourcen-Blatt für Ihren Bot.
  3. Öffnen Sie Kanäle , und wählen Sie Facebook.
  4. Geben Sie in Facebook-Kanal konfigurieren die Facebook-Informationen ein, die Sie in den vorherigen Schritten kopiert haben.
    1. Geben Sie Ihre Facebook-App-ID und IhrFacebook-App-Geheimnis ein.
    2. Geben Sie Ihre Seiten-ID und Zugriffstoken ein.
    3. Kopieren Sie die generierte Rückruf-URL und verifizieren Sie die Token-Werte.
    4. Klicken Sie auf Hinzufügen.

Tipp

  • Wenn Sie über keine Kopie Ihrer Informationen aus den vorherigen Schritten verfügen, können Sie sie für die Website „Meta for Developers“ abrufen.
  • Erstellen Sie bei Bedarf ein neues Webtoken für die Seite. Anweisungen hierzu finden Sie unter Seiten hinzufügen und Tokens generieren.

Aktivieren von Webhooks

Wechseln Sie zurück zu den Facebook-Einstellungen, um den Konfigurationsprozess abzuschließen.

  1. Wechseln Sie auf der Website „Meta for Developers“ zur Seite Messenger-Einstellungen für Ihre App.
  2. Scrollen Sie im resultierenden Bereich nach unten zum Webhook-Abschnitt, und wählen Sie Rückruf-URL hinzufügen.
  3. Auf der Seite Rückruf-URL bearbeiten:
    1. Kopieren Sie die Rückruf-URL- und Token-Werte, die Sie aus dem Azure-Portal kopiert haben.
    2. Klicken Sie auf Verify and save.
  4. Die Seite, die Sie jetzt hinzugefügt haben, wird in der Liste Seiten unter Webhook angezeigt.
  5. Wählen Sie Abonnements hinzufügen für die Sete aus.
    1. Wählen Sie auf der Seite Seiten-Abonnements bearbeiten die folgenden Abonnementfelder:
      • messages
      • messaging_postbacks
      • messaging_options
      • message_deliveries
    2. Wählen Sie Speichern.
  6. Auf der Website werden die hinzugefügten Abonnementfelder neben der Seite für Ihren Bot angezeigt.

Veröffentlichen Sie Ihre App

Bis zu ihrer Veröffentlichung befindet sich eine App im Entwicklungsmodus. Die Funktionen von Plug-Ins und APIs sind nur für Administratoren, Entwickler und Tester aktiv.

Nur der Ersteller (das Facebook Dev-Konto, das die Seite und den Bot erstellt hat) kann eine Bot-Antwort erhalten. Normale Facebook-Benutzer können die Seite oder den Bot nicht sehen. Geben Sie Entwicklungs- oder Testrollen an Benutzer, damit sie auch mit dem Bot chatten können.

Benutzer, die zu Testerrollen hinzugefügt werden sollen, müssen sich zuerst auf der Seite „Meta for Developers“ registrieren. Die Testerrolle ist für Facebook-Benutzer, die kein Meta for Developers-Konto besitzen, nicht verfügbar. Weitere Informationen zu App-Rollen und Testbenutzern finden Sie in der Meta for Developers-Entwicklerdokumentation.

Zur Prüfung einreichen

Facebook erfordert eine Datenschutzrichtlinien-URL und eine Nutzungsbedingungen-URL auf der Seite mit den Grundeinstellungen der App. Die Seite mit dem Verhaltenskodex enthält Links zu Ressourcen von Drittanbietern, die Ihnen beim Erstellen einer Datenschutzrichtlinie helfen. Die Seite Nutzungsbedingungen enthält Beispielbedingungen zur Unterstützung beim Erstellen eines geeigneten Dokuments mit Nutzungsbedingungen.

Nachdem der Bot fertiggestellt wurde, führt Facebook einen eigenen Überprüfungsprozess für Apps durch, die für Messenger veröffentlicht werden. Der Bot wird getestet, um sicherzustellen, dass er mit den Plattformrichtlinien von Facebook konform ist.

App und Seite veröffentlichen

Nach der erfolgreichen Überprüfung legen Sie die App auf dem App-Dashboard unter „App-Prüfung“ als öffentlich fest. Stellen Sie sicher, dass die Facebook-Seite, der dieser Bot zugeordnet ist, öffentlich ist. Der Status wird in den Seiteneinstellungen angezeigt.

API-Version einstellen

Wenn Sie von Facebook eine Benachrichtigung zur Veraltung einer bestimmten Version der Graph-API erhalten:

  1. Wechseln Sie zu Meta for Developers.
  2. Wechseln Sie zu der App, die Sie für Ihren Bot erstellt haben.
  3. Wählen Sie unter Einstellungen die Option Erweitert.
  4. Wählen Sie API-Version upgraden und stellen Sie Alle Aufrufe aktualisieren auf Version 4.0.

Testen Sie die Verbindung, indem Sie die im Abschnitt Ihren Bot in Facebook testen beschriebenen Schritte ausführen.

Ihren Bot in Facebook testen

Sie können jetzt überprüfen, ob Ihr Bot ordnungsgemäß mit Facebook verbunden ist, indem Sie eine Nachricht über die Facebook-Seite senden, die Sie mit ihrer neuen Facebook-App zugeordnet haben.

  1. Wechseln Sie zu Facebook und zum Profil für Ihre Seite.
  2. Wählen Sie weitere Aktionen (...) dann Interaktive Schaltfläche hinzufügen.
    1. Wählen Sie im Dialogfeld Aktion anpassen die Option Testen aus und folgen Sie den Anweisungen.
    2. Wählen Sie auf der Seite Interaktive Schaltfläche unter Personen dazu bringen, Kontakt mit Ihnen aufzunehmen die Option Nachricht senden aus.
    3. Wählen Sie Weiter, schließen Sie das Dialogfeld ab, und speichern Sie Ihre Änderungen.
  3. Wechseln Sie zurück zu Ihrem persönlichen Profil.
  4. Wechseln Sie zu Ihrer Seite und wählen Sie Nachricht, um die Verbindung mit Ihrem Bot zu testen.

Sie können diese Funktion auch mit dem Beispiel-Bot für den Facebook-Adapter testen, indem Sie die Datei appSettings.json mit den gleichen Werten auffüllen, die in den obigen Schritten beschrieben werden.

Weitere Informationen

Sehen Sie sich Bot Framework-C#-Facebook-Beispiel-Ereignisse für einen Beispiel-Bot an, der die Facebook Messenger-Kommunikation unterstützt.

Eine Dokumentation zu Facebook Messenger finden Sie unter:

Eine Dokumentation zu Facebook Workplace finden Sie unter: