Einrichtungshandbuch für Meta (Instagram & Messenger)

Die Verbindung Ihres Bots mit dem Facebook Messenger und Instagram Direct Messages erfordert die Konfiguration einer App im Meta Developer Portal.

Dieser Prozess umfasst mehrere Schritte, da Meta ausdrückliche Berechtigungen und Webhooks benötigt, um Nachrichten von deren Plattformen an Ihre FRENZY.BOT-Instanz weiterzuleiten.

Voraussetzungen

Bevor Sie beginnen, stellen Sie sicher, dass Sie Folgendes haben: 1. Eine Facebook-Seite für Ihr Unternehmen. 2. Ein Instagram-Professional-Konto (Business oder Creator), das mit dieser Facebook-Seite verknüpft ist. 3. Zugriff auf Ihr FRENZY.BOT-Dashboard, um Ihre Webhook-URL zu erhalten.

Schritt 1: Erstellen einer Meta-App

Gehen Sie zum Meta Developer Portal und loggen Sie sich ein.
Klicken Sie oben rechts auf Meine Apps und dann auf App erstellen.
Wählen Sie Sonstiges als App-Typ und klicken Sie auf Weiter.
Wählen Sie Unternehmen und klicken Sie auf Weiter.
Geben Sie einen App-Anzeigenamen ein (z. B. „Mein Business-Bot“) sowie Ihre Kontakt-E-Mail-Adresse.
Wählen Sie Ihr Business-Konto aus (optional, aber empfohlen) und klicken Sie auf App erstellen.

Schritt 2: Produkte zur App hinzufügen

In Ihrem App-Dashboard: 1. Scrollen Sie nach unten zu Produkte zu deiner App hinzufügen. 2. Suchen Sie Messenger und klicken Sie auf Einrichten. 3. Klicken Sie in der linken Seitenleiste auf Messenger → Instagram-Einstellungen (wenn Sie Instagram möchten) oder bleiben Sie bei Messenger → Einstellungen (für Facebook Messenger).

Schritt 3: Zugriffstoken generieren

Sie benötigen ein Seiten-Zugriffstoken (Page Access Token), um FRENZY.BOT zu erlauben, Nachrichten in Ihrem Namen zu senden.

Suchen Sie unter Messenger → Einstellungen den Abschnitt Zugriffstoken.
Klicken Sie auf Seiten hinzufügen oder entfernen und authentifizieren Sie sich mit Ihrem Facebook-Konto.
Wählen Sie die Facebook-Seite(n) aus, die Sie verbinden möchten, und erteilen Sie die angeforderten Berechtigungen.
Sobald die Seite verknüpft ist, klicken Sie daneben auf Token generieren.
Kopieren Sie dieses Token sofort und speichern Sie es. Sie werden es später in das FRENZY.BOT-Dashboard einfügen.

Schritt 4: Webhook konfigurieren

Dies teilt Meta mit, wohin eingehende Nachrichten gesendet werden sollen.

Gehen Sie in Ihrem FRENZY.BOT-Dashboard zu Kanäle → Messenger (oder Instagram).
Suchen Sie auf dieser Seite nach Ihrer eindeutigen Webhook-URL und dem Bestätigungstoken (Verify Token).
Scrollen Sie im Meta Developer Portal zurück zum Abschnitt Webhooks (unter Messenger-Einstellungen).
Klicken Sie auf Rückruf-URL hinzufügen.
Fügen Sie die Webhook-URL und das Bestätigungstoken aus Ihrem FRENZY.BOT-Dashboard ein.
Klicken Sie auf Bestätigen und speichern.

Schritt 5: Events abonnieren

Sie müssen Meta mitteilen, welche Ereignisse an Ihren Webhook gesendet werden sollen.

Klicken Sie im Webhooks-Abschnitt auf Verwalten neben Ihrem Seitennamen.
Abonniere die folgenden Felder:
messages (Erforderlich für Textnachrichten)
messaging_postbacks (Erforderlich für Klicks auf Schaltflächen/Schnellantworten)
messaging_optins (Optional, für „Erste Schritte“-Buttons)
Klicken Sie auf Speichern.

Schritt 6: IDs finden

Wenn Sie Instagram einrichten, benötigen Sie spezifische IDs:

Instagram Account ID:
Gehen Sie zu Facebook-Seiten-Einstellungen → Verknüpfte Konten → Instagram.
Oder nutzen Sie den Graph API Explorer: GET /v18.0/me?fields=instagram_business_account
Empfänger-IGID:
Dies ist die Instagram-spezifische ID der Person, die Benachrichtigungen erhalten soll (falls Instagram als Integration genutzt wird). Für die Kanaleinrichtung ist dies normalerweise nicht erforderlich, sofern im Dashboard nicht anders angegeben.

Schritt 7: Abschluss in FRENZY.BOT

Gehen Sie zurück zu Ihrem FRENZY.BOT-Dashboard (Kanäle → Messenger oder Instagram).
Fügen Sie das Seiten-Zugriffstoken ein, das Sie in Schritt 3 generiert haben.
Fügen Sie alle erforderlichen IDs ein (wie die Instagram Account ID).
Schalten Sie den Schalter auf Aktivieren, um den Kanal einzuschalten.
Klicken Sie auf Einstellungen speichern.

⚠️ Wichtig: App-Überprüfung (Live-Schaltung)

Wenn Sie eine Meta-App zum ersten Mal erstellen, befindet sie sich im Entwicklungsmodus.

Im Entwicklungsmodus antwortet Ihr Bot nur Ihnen und anderen Entwicklern/Testern, die im Meta-Portal (unter App-Rollen) zur App hinzugefügt wurden.

Damit Ihr Bot der breiten Öffentlichkeit antwortet, müssen Sie: 1. Die Unternehmensverifizierung im Meta Developer Portal abschließen. 2. Erweiterten Zugriff (Advanced Access) für spezifische Berechtigungen beantragen (normalerweise pages_messaging und instagram_manage_messages). 3. Ein Screencast einreichen, das zeigt, wie Ihr Bot funktioniert. 4. Sobald dies genehmigt ist, legen Sie den App-Schalter oben auf dem Bildschirm von In Entwicklung auf Live um.

Hinweis: Der Überprüfungsprozess von Meta kann mehrere Tage dauern.