Dokumentation / Kanal WhatsApp
WhatsApp verbinden
Kurz gesagt: Du verbindest eine WhatsApp-Business-Nummer über die Seite Organisation > Kanäle > WhatsApp mit einer Organisation. Du wählst zuerst einen Verbindungsmodus (Vollständig über die Cloud API oder Coexistence: Business-App + aishaa), klickst auf WhatsApp verbinden und durchläufst das Meta-Pop-up. Danach empfängst und beantwortest du WhatsApp-Nachrichten in aishaa als Tickets.
Wo du das findest
Gehe zu Organisation > Kanäle > WhatsApp. Die Seite heißt WhatsApp-Einstellungen, mit dem Untertitel Verbinden Sie eine bestehende Nummer der WhatsApp-Business-App und importieren Sie so viel aktuellen 1:1-Verlauf, wie Meta zulässt.
Wer: ab der Rolle Organisationsadministrator. Die Verbindung gilt pro Organisation: Jede Organisation hat ihre eigene WhatsApp-Nummer. Arbeitest du mit mehreren Organisationen, wähle zuerst die richtige Organisation mit der Organisationsauswahl oben auf der Seite.
Der Block WhatsApp verbinden unter Organisation > Kanäle > WhatsApp mit der Auswahl Vollständig über die Cloud API oder Coexistence: Business-App + aishaa und der Schaltfläche WhatsApp verbinden.
Was du bei Meta brauchst
Die Verbindung läuft über Meta (das Mutterunternehmen von WhatsApp). Sorge dafür, dass du Folgendes hast, bevor du beginnst:
- Ein Meta-Business-Konto (Unternehmensportfolio), in dem du dich mit einem Facebook-Konto mit Administratorrechten anmelden kannst.
- Ein WhatsApp-Business-Konto (WABA) innerhalb dieses Meta-Business-Kontos.
- Eine Telefonnummer für WhatsApp. Wählst du Coexistence, ist das die Nummer, die gerade in der WhatsApp-Business-App auf deinem Telefon verwendet wird.
Während des Verbindens bittet aishaa Meta um die Erlaubnis, dein WhatsApp-Business-Konto zu verwalten und Nachrichten zu senden und zu empfangen. Ohne diese Erlaubnis kann die Verbindung nicht abgeschlossen werden.
Mit der Schaltfläche Meta Business öffnen auf der Seite öffnest du direkt die WhatsApp-Business-Konten in deinen Meta-Business-Einstellungen.
Verbindungsmodus wählen
Unter WhatsApp verbinden steht die Erläuterung Wähle, wie diese Nummer verbunden wird. Nur API hat keine Abhängigkeit von der App; Coexistence behält die WhatsApp-Business-App neben aishaa. Du siehst die Auswahl nur, solange noch keine Verbindung besteht.
| Option | Bedeutung |
|---|---|
| Vollständig über die Cloud API | Die Nummer wird vollständig von aishaa abgewickelt. Die WhatsApp-Business-App wird nicht mehr benötigt und es gelten keine Abhängigkeiten von der App. |
| Coexistence: Business-App + aishaa (Standard) | Die WhatsApp-Business-App auf dem primären Telefon bleibt neben aishaa in Gebrauch. Nachrichten kommen an beiden Stellen an. Dafür gelten Einschränkungen von Meta; sobald du diese Option wählst, erscheint der Block Wichtig bei WhatsApp Coexistence mit allen Bedingungen. |
Lies für Coexistence zuerst Coexistence: WhatsApp-Business-App und aishaa zusammen. Einige Entscheidungen (Anzeigename, Profilbild) sind nach dem Verbinden festgelegt.
Schritt für Schritt verbinden
- Gehe zu Organisation > Kanäle > WhatsApp und prüfe, ob die richtige Organisation gewählt ist.
- Wähle den Verbindungsmodus Vollständig über die Cloud API oder Coexistence: Business-App + aishaa.
- Klicke auf WhatsApp verbinden. Es öffnet sich ein Pop-up von Meta (Embedded Signup). Erlaube Pop-ups für aishaa, wenn dein Browser sie blockiert.
- Melde dich im Pop-up bei Facebook an, wähle dein Meta-Business-Konto, das WhatsApp-Business-Konto und die Telefonnummer und schließe die Schritte von Meta ab.
- Am Ende zeigt das Pop-up die Seite WhatsApp-Verbindung wird abgeschlossen mit Sie können dieses Fenster schließen. aishaa fährt im ursprünglichen Tab fort. Das Pop-up schließt sich und aishaa schließt die Verbindung in dem Tab ab, in dem du begonnen hast. Du siehst die Meldung WhatsApp wurde erfolgreich verbunden. oder WhatsApp ist verbunden, aber das Webhook-Abonnement erfordert Aufmerksamkeit.
Unter dem Block WhatsApp verbinden erscheint der Block Letztes Verbindungsergebnis mit dem Ergebnis dieser Verbindung: WhatsApp ist verbunden und das Webhook-Abonnement war erfolgreich. oder WhatsApp ist verbunden, aber das Webhook-Abonnement war nicht vollständig erfolgreich., darunter die Felder Webhook-Status, Telefonregistrierung, Kontaktsynchronisierung und Verlaufssynchronisierung.
Die Statuskarte Verbindungsstatus
Oben auf der Seite steht der Block Verbindungsstatus mit dem Text Aktuelle WhatsApp-Business-Verbindung für diese Organisation. Mit Aktualisieren rufst du den aktuellen Status ab.
Solange keine Verbindung besteht, steht dort WhatsApp ist noch nicht verbunden. Verbinden Sie ein WhatsApp-Business-Konto, um diesen Kanal zu aktivieren. Nach einer erfolgreichen Verbindung steht dort WhatsApp ist verbunden. mit diesen Feldern:
| Feld | Bedeutung |
|---|---|
| Angezeigte Telefonnummer | Die verbundene Telefonnummer, so wie Kunden sie sehen. |
| Telefonnummer-ID | Die Kennung der Nummer bei Meta. |
| WABA-ID | Die Kennung des WhatsApp-Business-Kontos bei Meta. Vorlagen gehören zu diesem Konto. |
| Webhook-Abonnement | Ob aishaa bei Meta angemeldet ist, um Nachrichten zu empfangen. |
| Telefonregistrierung | Ob die Nummer bei Meta für das Senden über aishaa registriert ist. |
| Token läuft ab am | Bis wann der Zugriff von aishaa bei Meta gültig ist. aishaa erneuert ihn automatisch. |
| Aktualisiert am | Wann die Verbindung zuletzt aktualisiert wurde. |
| Kontaktsynchronisierung | Status und Anfragezeitpunkt des Kontaktimports aus der WhatsApp-Business-App. |
| Verlaufssynchronisierung | Status und Anfragezeitpunkt des Imports früherer Unterhaltungen. |
| Letzter Webhook Kontaktsynchronisierung | Wann Meta zuletzt Kontakte übermittelt hat. |
| Letzter Webhook Verlaufssynchronisierung | Wann Meta zuletzt Gesprächsverlauf übermittelt hat. |
| Zuletzt aus der Business-App gesendet | Wann zuletzt eine Nachricht aus der WhatsApp-Business-App gesendet wurde (nur bei Coexistence). |
Ein Feld, das noch nicht bekannt ist, zeigt einen Strich.
Warnungen unter den Feldern beginnen mit Warnung Webhook-Abonnement, Warnung Telefonregistrierung, Warnung Kontaktsynchronisierung oder Warnung Verlaufssynchronisierung, gefolgt von der Meldung von Meta. Steht dort Diese Verbindung muss erneut authentifiziert werden., muss die Verbindung bei Meta erneut bestätigt werden: Klicke bei einer Cloud-API-Verbindung erneut auf WhatsApp verbinden, bei Coexistence auf Verbindung neu verbinden.
Unter der Statuskarte stehen außerdem die Schaltflächen WhatsApp trennen (siehe WhatsApp trennen) und Meta Business öffnen.
Der Block Verbindungsstatus nach einer erfolgreichen Verbindung, mit der Meldung WhatsApp ist verbunden. und den Feldern Angezeigte Telefonnummer, Webhook-Abonnement, Telefonregistrierung, Kontaktsynchronisierung und Verlaufssynchronisierung.
Was nach dem Verbinden passiert
- Neue WhatsApp-Nachrichten von Kunden kommen als Tickets in Tickets an. Wie Nachrichten in Tickets landen und wie du antwortest, liest du in WhatsApp im Posteingang.
- Bei einer Coexistence-Verbindung importiert aishaa die Kontakte aus der WhatsApp-Business-App (mit ihrem Profilnamen) in Kontakte und so viel aktuellen Einzelgesprächsverlauf, wie Meta erlaubt. Importierter Verlauf landet pro Kontakt in einem separaten, geschlossenen Ticket. Ein solches Verlaufsticket bleibt geschlossen, zählt nicht als Arbeit und wird von aishaa nicht analysiert; es ist nur dafür da, dass die Zeitleiste des Kunden vollständig ist.
- Möchtest du Kunden außerhalb des 24-Stunden-Fensters anschreiben können, erstelle Vorlagen über Konto > WhatsApp-Vorlagen (siehe WhatsApp-Vorlagen). Kontoadministratoren sehen unten auf der WhatsApp-Seite auch eine Schaltfläche WhatsApp-Vorlagen.
Fehlermeldungen beim Verbinden
| Meldung | Bedeutung und Lösung |
|---|---|
| Das Meta-Fenster konnte nicht geöffnet werden. Erlauben Sie Pop-ups für aishaa und versuchen Sie es erneut. | Dein Browser hat das Pop-up blockiert. Erlaube Pop-ups für aishaa und starte erneut mit WhatsApp verbinden. |
| Das Meta-Fenster konnte nicht geöffnet oder abgeschlossen werden. Prüfen Sie, ob Pop-ups für aishaa erlaubt sind, und versuchen Sie es erneut. | Dasselbe, aber aishaa konnte nicht feststellen, wo es genau schiefging. |
| Das Meta-Fenster wurde geschlossen, bevor die WhatsApp-Verbindung abgeschlossen war. oder Meta Embedded Signup wurde vor dem Abschluss abgebrochen. | Das Pop-up wurde geschlossen oder abgebrochen, bevor alle Schritte fertig waren. Starte erneut. |
| Das Meta-Fenster wurde nicht rechtzeitig abgeschlossen. Starten Sie die Verbindung erneut. | Das Pop-up blieb zu lange offen. Beginne erneut. |
| Diese Nummer war bereits verbunden. Verwenden Sie „Verbindung neu verbinden“ für den bestehenden Kanal. | Diese Nummer hat in aishaa schon eine Verbindung. Nutze Verbindung neu verbinden statt einer neuen Verbindung (siehe Coexistence: WhatsApp-Business-App und aishaa zusammen). |
| Die Meta-Anmeldung konnte nicht gestartet werden. Prüfen Sie, ob Ihr Browser Facebook-Skripte oder Pop-ups blockiert, und versuchen Sie es erneut. | Eine Blockierung in deinem Browser oder eine Erweiterung hält die Anmeldung auf. Versuche es ohne Blocker oder in einem anderen Browserprofil. |
| Meta hat keinen Anmeldecode zurückgegeben. Starten Sie die Verbindung erneut., Meta hat keinen gültigen Code und Status zurückgegeben. oder Meta hat einen ungültigen OAuth-Status zurückgegeben. | Das Pop-up hat ein unvollständiges oder unerwartetes Ergebnis zurückgegeben, zum Beispiel weil die Seite inzwischen neu geladen wurde. Starte die Verbindung erneut von dieser Seite aus. |
| Meta Embedded Signup hat einen Fehler zurückgegeben. (oder die Fehlermeldung von Meta selbst) | Meta konnte die Verbindung nicht abschließen. Lies die Meldung von Meta, behebe das Problem in deinem Meta-Business-Konto und versuche es erneut. |
| Meta hat einen Facebook-Anmeldecode zurückgegeben, aber kein WhatsApp-Embedded-Signup-Ereignis. | Das Pop-up war zwar eine Facebook-Anmeldung, aber keine WhatsApp-Verbindung. Versuche es erneut. Kommt das immer wieder, wende dich an das aishaa-Team. |
| Die WhatsApp-Verbindung konnte nicht abgeschlossen werden. Durchlaufen Sie den Meta-Ablauf erneut und prüfen Sie, ob Sie das richtige Unternehmenskonto und die richtige Telefonnummer auswählen. Die Debug-Details unten helfen dem Support, falls es weiterhin fehlschlägt. | Durchlaufe die Meta-Schritte erneut und achte darauf, welches Unternehmenskonto und welche Nummer du wählst. |
| Die WhatsApp-Verbindung konnte nicht gestartet werden. oder Die WhatsApp-Verbindung konnte nicht abgeschlossen werden. | aishaa konnte die Verbindung nicht starten oder abschließen. Klicke auf Aktualisieren, versuche es erneut und wende dich an das aishaa-Team, wenn es weiterhin schiefgeht. |
| WhatsApp ist verbunden, aber das Webhook-Abonnement erfordert Aufmerksamkeit. | Die Nummer ist verbunden, aber Meta hat die Anmeldung für eingehende Nachrichten nicht vollständig bestätigt. Sieh dir die Warnung im Block Letztes Verbindungsergebnis an und klicke auf Aktualisieren. Bleibt die Warnung bestehen, wende dich an das aishaa-Team. |
| Der WhatsApp-Status konnte nicht geladen werden. | Die Seite konnte den Status nicht abrufen. Klicke auf Aktualisieren. |
Gelingt der Abschluss im Zwischenfenster nicht, siehst du dort WhatsApp-Verbindung konnte nicht abgeschlossen werden mit einer dieser Meldungen: Meta hat weder einen Code noch einen Fehler zurückgegeben., Diese Seite wurde nicht über das WhatsApp-Verbindungsfenster geöffnet. Kehren Sie zum ursprünglichen aishaa-Tab zurück und versuchen Sie es erneut. oder Das Ergebnis konnte nicht an den ursprünglichen aishaa-Tab übergeben werden. Kehren Sie zu diesem Tab zurück und versuchen Sie es erneut.
Schlägt eine Verbindung weiterhin fehl, wende dich an das aishaa-Team über den aishaa-Support-Chat in aishaa (Menü Chat, Unterhaltung aishaa support) oder per E-Mail an support@aishaa.nl.
Debug-Details bei einer Meldung mitschicken
Unten auf der Seite steht das ausklappbare Feld Debug-Details mit der Erläuterung Technische Details des letzten Verbindungsversuchs, hilfreich bei Kontakt mit dem Support. Klappe es aus, wenn du ein Problem meldest, und schicke den Inhalt mit; das erspart Rückfragen. Du musst selbst nichts damit tun. Im Block Letztes Verbindungsergebnis stehen außerdem die Felder Verbindungs-ID, Endpunkt-ID und Transport-ID; die darfst du ebenfalls mitschicken.
Gut zu wissen
- Den Verbindungsmodus kannst du nach dem Verbinden auf dieser Seite nicht mehr ändern. Möchtest du von Coexistence zu Vollständig über die Cloud API wechseln oder umgekehrt, trenne die Nummer zuerst (siehe WhatsApp trennen) und verbinde sie erneut.
- Bei einer bestehenden Cloud-API-Verbindung bleibt WhatsApp verbinden verfügbar. Mit dieser Schaltfläche bestätigst du dieselbe Verbindung erneut, zum Beispiel nach Diese Verbindung muss erneut authentifiziert werden.
- Die WhatsApp-Seite zeigt eine Verbindung pro Organisation. Früher verbundene Coexistence-Nummern bleiben in der Auswahlliste Coexistence-Kanal verwalten oder neu verbinden sichtbar, mit dem Hinweis Zuvor verbundene Coexistence-Kanäle bleiben hier für Statusprüfungen und das Neuverbinden verfügbar. Mit Zurück zum Standardkanal gehst du zurück zur aktiven Nummer.
- Eine neue Verbindung herstellen und eine Verbindung trennen kann nur, wer Kanäle verwalten darf. Der festgelegte Telefonverwalter darf nur neu verbinden (siehe Telefonverwalter und Standardagent).
- Nur E-Mail, WhatsApp und Telefonie sind in aishaa verfügbare Kanäle. Instagram, X, SMS und ein Chat-Widget kannst du nicht verbinden.