WhatsApp Integration
Die WhatsApp Integration ermöglicht es Ihren KI-Assistenten, über die WhatsApp Business API mit Kunden zu kommunizieren. Ihr Assistent kann Nachrichten senden und empfangen, Konversationen verwalten und automatisierten Support über WhatsApp bereitstellen.
Was ist die WhatsApp Integration?
Die WhatsApp Business API ist eine leistungsstarke Messaging-Plattform, die es Unternehmen ermöglicht, mit Kunden in großem Umfang zu kommunizieren. Durch die Integration von WhatsApp mit Ihrem KI-Assistenten können Sie automatisierten Kundensupport bereitstellen und mit Kunden auf ihrer bevorzugten Messaging-Plattform interagieren.
Hauptfunktionen
- Bidirektionale Kommunikation: Ihr Assistent kann WhatsApp-Nachrichten in Echtzeit senden und empfangen
- Konversationsverwaltung: Automatisches Verfolgen und Verwalten von Kundengesprächen
- Telefonnummer-Registrierung: Registrierung von WhatsApp-Telefonnummern für geschäftliche Nutzung
- Assistenten-Verknüpfung: Verbindung von WhatsApp-Nummern mit bestimmten KI-Assistenten
- 24/7 Verfügbarkeit: Automatisierten Support rund um die Uhr bereitstellen
- Konversations-Ablauf: Konversationen laufen automatisch nach 24 Stunden Inaktivität ab, um die Privatsphäre zu schützen
Wie es funktioniert
- Kunde sendet Nachricht: Ein Kunde sendet eine WhatsApp-Nachricht an Ihre Geschäftsnummer
- Nachricht empfangen: Die Plattform empfängt die Nachricht über Metas Webhook
- Assistent verarbeitet: Ihr KI-Assistent analysiert die Nachricht und generiert eine Antwort
- Antwort gesendet: Die Antwort des Assistenten wird über WhatsApp an den Kunden zurückgesendet
- Konversation verfolgt: Alle Nachrichten werden für Kontext in einer Konversation verfolgt
- Automatischer Ablauf: Konversationen laufen nach 24 Stunden Inaktivität ab, um die Privatsphäre zu wahren
WhatsApp Integration einrichten
Voraussetzungen
- Meta Business Account
- WhatsApp Business Account (WABA)
- Mit Meta verifizierte Telefonnummer
- KI-Assistent in Ihrer KI Agency Plattform konfiguriert
- Meta App ID, App Secret und Zugriffstoken (Systemebene-Konfiguration)
Schritt-für-Schritt Einrichtung
1. WhatsApp Business Account verbinden
Die WhatsApp Business Account (WABA) Verbindung wird normalerweise auf Systemebene von Administratoren eingerichtet. Dies umfasst:
- Verbindung zu Metas Plattform über OAuth
- Austausch von Autorisierungscodes gegen Zugriffstoken
- Speicherung sicherer Anmeldedaten für API-Zugriff
Wenn Sie ein neues WABA verbinden müssen, kontaktieren Sie Ihren Systemadministrator.
2. Telefonnummer registrieren und verifizieren
Sobald Ihr WABA verbunden ist, müssen Sie Telefonnummern für WhatsApp-Messaging registrieren und verifizieren. Der Verifizierungsprozess hängt davon ab, ob die Telefonnummer bereits mit einem Assistenten verknüpft ist:
Zur WhatsApp-Verwaltung navigieren
- Gehen Sie zum Integrationen-Bereich
- Wählen Sie WhatsApp Integration
Verfügbare Telefonnummern anzeigen
- Das System zeigt Telefonnummern an, die registriert werden können
- Dies können Nummern von Ihrem bestehenden Telefonanbieter oder Nummern sein, die bereits mit Ihrem WABA verknüpft sind
Auf Verifizieren-Button klicken
- Wählen Sie die Telefonnummer aus, die Sie verifizieren möchten
- Klicken Sie auf den "Verifizieren"-Button neben der Telefonnummer
Verifizierungspfad auswählen
Das System bestimmt automatisch, welcher Verifizierungspfad verwendet wird:
Pfad A: Telefonnummer bereits einem Assistenten zugewiesen
- Wenn die Telefonnummer bereits mit einem Assistenten verknüpft ist, ruft Meta direkt die Telefonnummer dieses Assistenten an
- Warten Sie einfach auf den Verifizierungsanruf, notieren Sie die 6-stellige PIN und geben Sie sie ein, wenn Sie dazu aufgefordert werden
- Dies ist der einfachere Pfad, wenn Sie die Telefonnummer Ihres Assistenten bereits konfiguriert haben
Pfad B: Telefonnummer nicht zugewiesen (Anrufweiterleitung)
- Wenn die Telefonnummer noch nicht mit einem Assistenten verknüpft ist, müssen Sie eine Weiterleitungsnummer angeben
- Geben Sie Ihre persönliche Telefonnummer (im internationalen Format, z.B. +491234567890) ein, unter der Sie den Verifizierungsanruf erhalten möchten
- Das System konfiguriert vorübergehend eine Anrufweiterleitung für den Verifizierungsprozess
- Meta ruft die WhatsApp-Geschäftsnummer an, die dann an Ihr Telefon weitergeleitet wird
- Nachdem Sie den Anruf und die 6-stellige PIN erhalten haben, geben Sie diese ein, um die Verifizierung abzuschließen
- Die Anrufweiterleitung wird nach der Verifizierung automatisch entfernt
Verifizierungs-PIN eingeben
- Hören Sie den automatisierten Verifizierungsanruf ab
- Notieren Sie die 6-stellige PIN, die Sie hören
- Geben Sie die PIN im Verifizierungsdialog ein
- Klicken Sie auf "Verifizieren", um den Vorgang abzuschließen
Verifizierung abgeschlossen
- Bei Erfolg wird der Status der Telefonnummer auf "verifiziert" aktualisiert
- Die Telefonnummer ist nun bereit, mit einem Assistenten verknüpft zu werden
- Wenn Sie Pfad B verwendet haben, wurde die temporäre Anrufweiterleitung automatisch entfernt
3. Telefonnummer mit Assistent verknüpfen
Nachdem Sie eine Telefonnummer registriert haben, verbinden Sie sie mit einem KI-Assistenten:
Verfügbare Nummer auswählen
- Zeigen Sie die Liste der registrierten WhatsApp-Nummern an
- Wählen Sie die Nummer aus, die Sie verwenden möchten
Assistent auswählen
- Wählen Sie aus, welcher KI-Assistent Nachrichten von dieser Nummer bearbeiten soll
- Jede Telefonnummer kann jeweils nur mit einem Assistenten verknüpft werden
Nummer verknüpfen
- Klicken Sie auf "Verknüpfen", um die Nummer mit dem Assistenten zu verbinden
- Das System konfiguriert automatisch das Webhook-Routing
Verbindung überprüfen
- Senden Sie eine Testnachricht an die WhatsApp-Nummer
- Überprüfen Sie, ob Ihr Assistent korrekt antwortet
Konfigurationsoptionen
Telefonnummer-Verwaltung
Verifizierung: Telefonnummern bei Meta für die WhatsApp Business API-Nutzung verifizieren
- Erfordert einen Sprachanruf mit einer 6-stelligen PIN
- Zwei Verifizierungspfade verfügbar:
- Pfad A: Telefonnummer bereits einem Assistenten zugewiesen (Anruf geht direkt an die Nummer des Assistenten)
- Pfad B: Telefonnummer nicht zugewiesen (Sie geben eine Weiterleitungsnummer an, um den Anruf zu erhalten)
- Die Verifizierung muss abgeschlossen sein, bevor die Telefonnummer voll funktionsfähig ist
- Das System handhabt automatisch die Einrichtung und Bereinigung der Anrufweiterleitung für Pfad B
Verknüpfung: Verbindung registrierter Nummern mit bestimmten KI-Assistenten
- Jede Nummer kann jeweils mit einem Assistenten verknüpft werden
- Das Trennen einer Nummer ermöglicht die Neuzuweisung zu einem anderen Assistenten
- Verknüpfte Nummern werden in der Assistentenliste angezeigt
Abmeldung: Entfernung von Telefonnummern von der WhatsApp Business API
- Trennen Sie die Nummer zuerst von jedem Assistenten
- Melden Sie die Nummer über die Verwaltungsoberfläche ab
- Die Nummer kann bei Bedarf später erneut registriert werden
Konversationsverwaltung
Automatische Verfolgung: Alle WhatsApp-Konversationen werden automatisch verfolgt mit:
- Eindeutiger Konversations-ID
- Zugeordnetem Assistenten
- Kunden-WhatsApp-ID
- Nachrichtenverlauf
- Aktivitäts-Zeitstempel
Konversations-Ablauf: Zum Schutz der Privatsphäre der Kunden laufen Konversationen automatisch ab:
- Nach 24 Stunden ohne Aktivität vom Kunden
- Abgelaufene Konversationen werden im System als "abgelaufen" markiert
- Neue Nachrichten vom Kunden erstellen eine neue Konversation
Kontext-Kontinuität: Innerhalb des 24-Stunden-Fensters:
- Der Assistent behält den Konversationskontext bei
- Vorherige Nachrichten sind als Referenz verfügbar
- Antworten sind kontextbezogener und relevanter
Wie Kunden WhatsApp-Messaging erleben
Wenn ein Kunde Ihre WhatsApp-Geschäftsnummer anschreibt:
- Erste Nachricht: Kunde sendet ihre erste Nachricht (z.B. "Hallo, ich brauche Hilfe")
- Assistenten-Antwort: Ihr KI-Assistent analysiert die Nachricht und antwortet angemessen
- Natürliche Konversation: Kunde und Assistent tauschen natürlich Nachrichten aus
- Kontext-Bewusstsein: Innerhalb von 24 Stunden erinnert sich der Assistent an vorherige Nachrichten
- Automatische Bearbeitung: Kein manueller Eingriff erforderlich - der Assistent verwaltet die gesamte Konversation
- Konversations-Ende: Nach 24 Stunden Inaktivität läuft die Konversation aus Datenschutzgründen ab
Beispiel-Konversation:
Kunde: Hallo, ich würde gerne Ihre Geschäftszeiten wissen
Assistent: Hallo! Wir haben Montag bis Freitag von 9 bis 17 Uhr geöffnet. Wie kann ich Ihnen heute helfen?
Kunde: Bieten Sie auch Termine am Wochenende an?
Assistent: Derzeit bieten wir keine Wochenend-Termine an, aber wir können Sie für jeden Wochentag einplanen, der am besten für Sie passt. Möchten Sie einen Termin vereinbaren?Best Practices
Kundenerfahrung
- Trainieren Sie Ihren Assistenten mit freundlicher, gesprächiger Sprache
- Halten Sie Antworten prägnant und klar für das mobile Lesen
- Verwenden Sie Schnellantwort-Optionen, wenn verfügbar
- Antworten Sie zeitnah, um das Engagement aufrechtzuerhalten
Telefonnummer-Verwaltung
- Verwenden Sie dedizierte Geschäftsnummern für WhatsApp
- Halten Sie Telefonnummer-Registrierungen aktuell
- Überwachen Sie den Registrierungsstatus regelmäßig
- Dokumentieren Sie, welcher Assistent mit jeder Nummer verknüpft ist
Datenschutz und Compliance
- Respektieren Sie Konversations-Ablaufzeiten
- Speichern Sie keine sensiblen Kundeninformationen in Nachrichten
- Befolgen Sie die WhatsApp Business Policy Richtlinien
- Halten Sie sich an lokale Datenschutzbestimmungen
Nachrichtenqualität
- Testen Sie die Antworten Ihres Assistenten gründlich, bevor Sie live gehen
- Überwachen Sie Konversations-Logs zur Qualitätssicherung
- Aktualisieren Sie das Assistenten-Training basierend auf Kundenfeedback
- Behandeln Sie Grenzfälle und unerwartete Nachrichten elegant
Fehlerbehebung
Häufige Probleme
Telefonnummer-Verifizierung schlägt fehl
- Überprüfen Sie, dass die 6-stellige PIN korrekt ist (hören Sie dem Verifizierungsanruf aufmerksam zu)
- Für Pfad B (Anrufweiterleitung) stellen Sie sicher, dass Ihre Weiterleitungsnummer im korrekten internationalen Format ist (z.B. +491234567890)
- Stellen Sie sicher, dass Sie Anrufe auf Ihrer Weiterleitungsnummer empfangen können
- Stellen Sie sicher, dass die Telefonnummer ordnungsgemäß im Meta Business Manager konfiguriert ist
- Prüfen Sie, dass die Nummer nicht bereits mit einem anderen WABA verifiziert ist
- Versuchen Sie den Verifizierungsprozess erneut - das System räumt vorherige Versuche automatisch auf
- Kontaktieren Sie den Meta-Support, wenn die Verifizierung wiederholt fehlschlägt
Nachrichten werden nicht empfangen
- Überprüfen Sie, dass die Telefonnummer ordnungsgemäß verifiziert ist (Status zeigt "verifiziert")
- Prüfen Sie, dass die Nummer mit einem aktiven Assistenten verknüpft ist
- Stellen Sie sicher, dass Meta-Webhooks korrekt konfiguriert sind (Systemebene)
- Überprüfen Sie Webhook-Logs auf eingehende Nachrichtendaten
- Bestätigen Sie, dass die Telefonnummer-Verifizierung erfolgreich war (nicht nur "in Bearbeitung")
Assistent antwortet nicht
- Überprüfen Sie, dass der Assistent aktiv und ordnungsgemäß konfiguriert ist
- Prüfen Sie, dass die WhatsApp-Nummer korrekt verknüpft ist
- Testen Sie die Konfiguration des Assistenten außerhalb von WhatsApp
- Überprüfen Sie Konversations-Logs auf Fehlermeldungen
Konversations-Kontext verloren
- Denken Sie daran, dass Konversationen nach 24 Stunden ablaufen
- Neue Nachrichten nach Ablauf erstellen eine neue Konversation
- Dies ist erwartetes Verhalten zum Schutz der Privatsphäre
- Der Kontext wird innerhalb des 24-Stunden-Fensters beibehalten
Hilfe erhalten
Wenn Sie Probleme mit der WhatsApp Integration haben:
- Überprüfen Sie den Telefonnummer-Verifizierungsstatus (sollte "verifiziert" zeigen, nicht nur "registriert")
- Verifizieren Sie, dass die Assistenten-Verknüpfung aktiv ist
- Überprüfen Sie Konversations-Logs auf Fehler
- Testen Sie mit einer einfachen Nachricht wie "Hallo"
- Bei Verifizierungsproblemen versuchen Sie es erneut - das System räumt vorherige Versuche auf
- Kontaktieren Sie Ihren Systemadministrator, falls Probleme bestehen bleiben
Verwandte Dokumentation
- Assistenten Konfiguration - Erfahren Sie mehr über Assistenten-Einstellungen
- Integrationen Übersicht - Entdecken Sie andere verfügbare Integrationen
- Assistenten-Verwaltung - Allgemeine Assistenten-Verwaltungsanleitung
Die WhatsApp Integration bringt Ihre KI-Assistenten auf die weltweit beliebteste Messaging-Plattform und ermöglicht nahtlose Kundengespräche und automatisierten Support im großen Maßstab.