# WhatsApp

Подключите номер WhatsApp клиента, чтобы его AI-агент отвечал на сообщения в WhatsApp

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

Подключение WhatsApp позволяет AI-агенту вашего клиента отвечать покупателям на его номере WhatsApp. Есть три пути: **QR-код**, который привязывает существующий номер WhatsApp (этот путь предлагает онбординг), **WhatsApp Business** через Meta и **WhatsApp E-Chat** для номеров, которые уже обслуживает E-Chat.

<ChannelDetailDemo channel="whatsapp" />

## Подключение по QR-коду [#connect-whatsapp-qr]

Так WhatsApp подключается во время онбординга: Happ привязывает номер как устройство аккаунта WhatsApp (через сервис WaSender). Этого пути нет в каталоге **Интеграций** — он начинается с онбординга.

Нужен телефон с WhatsApp на номере, в который пишут клиенты.

1. В онбординге, когда Happ спросит, куда вам пишут клиенты, отметьте **WhatsApp**, подтвердите выбор и нажмите **Подключить** на карточке WhatsApp.
2. В окне **Добавить WhatsApp** введите **номер телефона** в международном формате с кодом страны (например, `+380681234567`) и нажмите **Сгенерировать QR-код**.
3. На телефоне откройте WhatsApp → **Настройки** → **Связанные устройства** → **Привязать устройство** и отсканируйте код.
4. Окно ждёт сканирования и закрывается, как только WhatsApp подключён. Назначьте ему AI-агента.

## Подключение WhatsApp Business [#connect-whatsapp-business]

1. В **Интеграциях** в разделе **Мессенджеры** нажмите плитку **WhatsApp Business**.
2. Нажмите **Подключить** — Happ перенаправит вас в Facebook.
3. Войдите в аккаунт Meta, которому принадлежит аккаунт WhatsApp Business, и выдайте Happ доступ.
4. Meta автоматически вернёт вас в Happ; интеграция появится в разделе **Мои интеграции**.
5. Назначьте ей AI-агента.

Заполнять ничего не нужно: всё необходимое Happ получает из авторизации Meta. Нужны права администратора в бизнес-портфолио Meta клиента.

## Подключение WhatsApp E-Chat [#connect-whatsapp-e-chat]

1. В **Интеграциях** в разделе **Мессенджеры** нажмите плитку **WhatsApp E-chat**.
2. Введите **номер телефона** и **API ключ** из кабинета E-Chat.
3. Скопируйте **адрес вебхука** из окна и вставьте его в поле вебхука в настройках E-Chat. Без этого сообщения из WhatsApp не попадут в Happ.
4. Нажмите **Подключить** и назначьте AI-агента.

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

## Дальше [#next]

* [Каналы](/docs/integrations/messengers) — все мессенджеры
* [Агенты](/docs/agents) — настройте, кто отвечает
* [Контроль AI](/docs/workspace/ai-control) — включение и выключение AI в отдельном разговоре