# WhatsApp

Verbinden Sie die WhatsApp-Nummer eines Kunden, damit sein KI-Agent WhatsApp-Nachrichten beantwortet

> Full REST + WebSocket API reference: https://api.happ.tools/reference

Mit der WhatsApp-Verbindung beantwortet der KI-Agent Ihres Kunden Nachrichten an dessen WhatsApp-Nummer. Es gibt drei Wege: ein **QR-Code**, der eine bestehende WhatsApp-Nummer verknüpft (diesen Weg bietet das Onboarding an), **WhatsApp Business** über Meta und **WhatsApp E-Chat** für Nummern, die bereits über E-Chat laufen.

<ChannelDetailDemo channel="whatsapp" />

## Per QR-Code verbinden [#connect-whatsapp-qr]

So wird WhatsApp im Onboarding verbunden: Happ verknüpft die Nummer als Gerät des WhatsApp-Kontos (über den Dienst WaSender). Dieser Weg steht nicht im Katalog **Integrationen** — er beginnt im Onboarding.

Sie brauchen das Telefon mit WhatsApp für die Nummer, an die Ihre Kunden schreiben.

1. Wenn Happ im Onboarding fragt, wo Ihnen Kunden schreiben, wählen Sie **WhatsApp**, bestätigen Sie und klicken Sie auf der WhatsApp-Karte auf **Connect**.
2. Geben Sie im Dialog **WhatsApp hinzufügen** die Telefonnummer im internationalen Format mit Ländervorwahl ein (z. B. `+380681234567`) und klicken Sie auf **QR-Code generieren**.
3. Öffnen Sie auf dem Telefon WhatsApp → **Einstellungen** → **Verknüpfte Geräte** → **Gerät verknüpfen** und scannen Sie den Code.
4. Der Dialog wartet auf den Scan und schließt sich, sobald WhatsApp verbunden ist. Weisen Sie ihm einen KI-Agenten zu.

## WhatsApp Business verbinden [#connect-whatsapp-business]

1. Klicken Sie unter **Integrationen** im Abschnitt **Messenger** auf die Kachel **WhatsApp Business**.
2. Klicken Sie auf **Connect** — Happ leitet Sie zu Facebook weiter.
3. Melden Sie sich bei dem Meta-Konto an, dem das WhatsApp-Business-Konto gehört, und gewähren Sie Happ Zugriff.
4. Meta leitet Sie automatisch zu Happ zurück; die Integration erscheint unter **Meine Integrationen**.
5. Weisen Sie ihr einen KI-Agenten zu.

Es gibt keine Felder auszufüllen: Alles, was Happ braucht, kommt aus der Meta-Autorisierung. Sie benötigen Administratorrechte im Meta-Business-Portfolio des Kunden.

## WhatsApp E-Chat verbinden [#connect-whatsapp-e-chat]

1. Klicken Sie unter **Integrationen** im Abschnitt **Messenger** auf die Kachel **WhatsApp E-chat**.
2. Geben Sie die Telefonnummer und den **API-Schlüssel** aus dem E-Chat-Dashboard ein.
3. Kopieren Sie die im Dialog angezeigte **Webhook-URL** und fügen Sie sie in das Webhook-Feld Ihrer E-Chat-Einstellungen ein. Ohne sie erreichen WhatsApp-Nachrichten Happ nie.
4. Klicken Sie auf **Connect** und weisen Sie einen KI-Agenten zu.

**API:** [api.happ.tools/reference](https://api.happ.tools/reference)

## Weiter [#next]

* [Kanäle](/docs/integrations/messengers) — alle Messenger
* [Agenten](/docs/agents) — festlegen, wer antwortet
* [KI-Steuerung](/docs/workspace/ai-control) — KI pro Gespräch umschalten