WhatsApp Business Cloud API mit AssistFlow verbinden: Schritt-für-Schritt-Anleitung

Zeit: ~10 Minuten · Schwierigkeitsgrad: Mittelstufe · Kosten: Kostenlos mit der von Meta bereitgestellten Testnummer

In dieser Anleitung erstellen wir eine WhatsApp Business Cloud API-App auf Meta for Developers, verbinden sie mit AssistFlow und aktivieren KI-Antworten für eingehende Nachrichten. Jeder Schritt wurde live getestet.

Voraussetzungen

• Ein Meta (Facebook) Konto mit einem aktiven Meta Business-Konto
• Eine Telefonnummer, die nicht derzeit bei WhatsApp registriert ist (Meta stellt Ihnen auch eine kostenlose Testnummer zur Verfügung)
• Ein AssistFlow-Konto mit Zugriff auf das Entwickler-Dashboard (/dashboard/whatsapp-settings)

1. Erstellen Sie eine Meta for Developers-App

1. Gehen Sie zu developers.facebook.com/apps und klicken Sie auf App erstellen.
2. Wählen Sie den Anwendungsfall "Sonstiges" und den App-Typ "Business".
3. Geben Sie einen App-Namen ein (z.B. "AssistFlow WhatsApp") und Ihre Kontakt-E-Mail-Adresse, dann wählen Sie Ihr Business-Konto aus.

2. Fügen Sie das WhatsApp-Produkt hinzu

1. Klicken Sie in der App-Dashboard-Seitenleiste auf "Produkt hinzufügen" und klicken Sie auf "Einrichten" auf der WhatsApp-Karte.
2. Wählen Sie ein Business-Portfolio aus (oder erstellen Sie eines).
3. Meta wird automatisch eine Testtelefonnummer und ein WhatsApp Business-Konto (WABA) bereitstellen — Sie können damit während der Entwicklung kostenlose Nachrichten senden.

3. Holen Sie sich Ihre Telefon-ID, WABA-ID und Anzeigetelefonnummer

Öffnen Sie in der Seitenleiste WhatsApp → API-Einrichtung:

• Telefonnummer-ID — lange Ziffernfolge unter "Von" (z.B. 527144740475098)
• WhatsApp Business-Konto-ID — oben, neben dem Dropdown-Menü
• Anzeigetelefonnummer — Ihre Test- oder verifizierte Nummer im E.164-Format (z.B. +90 555 724 22 44)
• Verifizierter Unternehmensname — Ihr Firmenname im Business Manager

Kopieren Sie diese vier Werte an einen sicheren Ort — wir werden sie als nächstes in AssistFlow einfügen.

4. Generieren Sie ein permanentes Zugriffstoken

Das "Temporäre Zugriffstoken" auf der API-Einrichtungsseite läuft in 24 Stunden ab. Für die Produktion erstellen Sie einen Systembenutzer in Meta Business und erteilen ihm ein permanentes Token:

1. business.facebook.com → Einstellungen → Benutzer → Systembenutzer
2. Hinzufügen → benennen Sie es (z.B. "AssistFlow Token"), setzen Sie die Rolle auf Admin.
3. Wählen Sie den neuen Benutzer aus → Assets hinzufügen → Apps → wählen Sie Ihre AssistFlow-App → gewähren Sie App verwalten.
4. Fügen Sie auch WhatsApp-Konten als Asset hinzu → gewähren Sie WhatsApp-Konto verwalten.
5. Neues Token generieren → wählen Sie Ihre App → aktivieren Sie mindestens:
   • whatsapp_business_management
   • whatsapp_business_messaging
   • business_management
6. Aktivieren Sie "Läuft nie ab" → Generieren → kopieren Sie das Token sofort (Meta zeigt es nicht erneut an).

5. Anmeldedaten in AssistFlow einfügen

1. Melden Sie sich im AssistFlow-Entwickler-Dashboard an → WhatsApp AI → WhatsApp-Einstellungen.
2. Fügen Sie in der Meta Cloud API-Anmeldedaten-Karte ein:
   • Telefonnummer-ID
   • WhatsApp Business-Konto-ID
   • Permanentes Zugriffstoken
   • Anzeigetelefonnummer
   • Verifizierter Unternehmensname
3. Klicken Sie unten auf Speichern. Das System generiert automatisch ein Webhook-Verifizierungstoken für Sie.

6. Webhook auf Metas Seite einrichten

Nach dem Speichern zeigt die Webhook-Einstellungen-Karte zwei Werte an:

Callback-URL : https://<project>.supabase.co/functions/v1/whatsapp-webhook Verifizierungstoken : (automatisch generiert, klicken Sie auf "Kopieren")

Jetzt zurück zum Meta Developer Portal:

1. Seitenleiste → WhatsApp → Konfiguration → Webhook.
2. Fügen Sie Callback-URL und Verifizierungstoken ein → Verifizieren und speichern.
3. In "Webhook-Felder" Abonnieren von messages. (Optional: auch message_template_status_update und account_update abonnieren.)

7. KI-Antworten aktivieren

AssistFlow → WhatsApp-Einstellungen → Auto-Reply-Einstellungen-Karte:

• Integration aktivieren → an
• KI-Antworten aktiv → an
• Standard-Widget → wählen Sie, welche Wissensdatenbank + Persona die KI verwenden soll (Sie können Ihr bestehendes Chat-Widget auswählen).
• Tägliches Nachrichtenlimit → 1000 (oder was zu Ihrem Plan passt).
• Nachricht außerhalb der Arbeitszeiten → Text, der außerhalb Ihrer Arbeitszeiten automatisch gesendet wird.

Klicken Sie erneut auf Speichern.

8. Testen Sie es

1. Aus dem "Nachrichten senden und empfangen"-Panel der Testnummer senden Sie eine Nachricht — schreiben Sie von Ihrem eigenen WhatsApp an die Nummer.
2. Innerhalb von 30 Sekunden sollten Sie die Antwort der KI auf Ihrem WhatsApp sehen.
3. Öffnen Sie WhatsApp-Nachrichten in AssistFlow → bestätigen Sie, dass die Nachricht als eingehend + ausgehend protokolliert wurde.

9. In die Produktion gehen

1. Meta Developer Portal → App-Überprüfung → Berechtigungen und Funktionen → Erweiterter Zugriff anfordern für whatsapp_business_messaging und whatsapp_business_management.
2. WhatsApp → Telefonnummern → Telefonnummer hinzufügen → fügen Sie Ihre echte Geschäftsnummer hinzu, verifizieren Sie sie per SMS/Voice.
3. Aktualisieren Sie die neue Telefonnummer-ID in AssistFlow (ersetzen Sie die Testnummer).
4. Schalten Sie den App-Modus auf Live.

Häufige Probleme

"Webhook-Verifizierung fehlgeschlagen"

Verifizierungstoken stimmt nicht überein oder Sie haben AssistFlow nicht zuerst gespeichert. Speichern Sie die Einstellungen, dann fügen Sie sie in Meta ein.

Nachrichten kommen an, aber die KI antwortet nicht

"KI-Antworten aktiv" könnte ausgeschaltet sein. Auch wenn "Standard-Widget" nicht gesetzt ist, weiß die KI nicht, welche Persona sie verwenden soll.

"Re-Engagement" / 24-Stunden-Fenster-Fehler

WhatsApp-Richtlinie: Wenn ein Kunde Ihnen innerhalb von 24 Stunden keine Nachricht gesendet hat, können Sie ihn nur mit einer genehmigten Vorlage erreichen. Synchronisieren Sie Vorlagen von Meta im Vorlagen-Tab.

Token abgelaufen

Sie haben das temporäre (24h) Token verwendet. Verwenden Sie den Systembenutzer-Flow in Schritt 4, um ein permanentes Token zu erhalten.

Nächste Schritte

• WhatsApp-Vorlagen: Synchronisieren Sie Ihre genehmigten Marketingvorlagen im Vorlagen-Tab.
• WhatsApp-Kampagnen: Laden Sie eine Lead-Liste hoch und führen Sie Drip-Kampagnen durch.
• Konversationsanalysen: Verfolgen Sie tägliche Sendungen, Öffnungen und aktive Sitzungen im Analyse-Tab.

Brauchen Sie Hilfe? Schreiben Sie an support@assistflow.ai — Setup-Unterstützung ist in Ihrem Plan enthalten.