WhatsApp

Агент отвечает клиентам в WhatsApp. В кабинете откройте Каналы → WhatsApp. Для номера в приложении WhatsApp Business используйте официальное подключение через Meta: номер остаётся в телефоне, а ReplAI получает доступ к перепискам через Cloud API. Этот режим Meta называет Coexistence.

	Meta Cloud API	Личный номер (QR)
Подключение	через окно Meta из кабинета	для ранее подключённых каналов
Номер	действующий WhatsApp Business или отдельный номер	ваш рабочий номер WhatsApp
Приложение на телефоне	сохраняется при Coexistence	сохраняется
Ответы владельца с телефона	видны в ReplAI при Coexistence	видны в ReplAI
Сообщения через API	по правилам Meta и её тарифам	массовые рассылки запрещены

Два провайдера взаимоисключающие: у агента работает тот способ, который вы подключили. При переходе между способами существующие диалоги в ReplAI сохраняются.

Способ 1. Личный номер по QR-коду

Этот способ использует связанное устройство WhatsApp. Новые подключения по QR сейчас в кабинете не предлагаются. Уже подключённые номера продолжают работать. Для нового подключения используйте Meta Cloud API ниже.

Телефон должен оставаться на связи. Если устройство надолго потеряло сеть, может потребоваться повторная привязка.

Используйте рабочий номер. Агент обрабатывает личные сообщения, адресованные этому номеру. Групповые чаты и статусы он не читает.

Ответили сами с телефона — агент встаёт на паузу в этом диалоге. Сообщение появляется в ReplAI как ответ оператора. Вернуть диалог агенту можно в разделе Диалоги.

Отключение не удаляет переписку. Если номер не привязан больше трёх суток, канал освобождается. Перед отключением старого QR-канала обратитесь в поддержку, чтобы согласовать переход на официальное подключение.

Способ 2. Meta Cloud API

Нажмите Подключить на странице канала. Окно Meta откроется поверх кабинета. Владельцу не нужно создавать приложение разработчика, копировать токен или настраивать вебхук: всё нужное ReplAI получает из окна Meta. Других способов подключить номер через Meta в кабинете нет.

Что нужно подготовить

• Доступ к аккаунту Facebook, который управляет бизнесом в Meta.
• Телефон с актуальным приложением WhatsApp Business, если вы хотите сохранить существующий номер и приложение.
• Доступ к номеру для подтверждения владения.

Удалять существующий аккаунт WhatsApp Business для Coexistence не нужно. Доступность подключения конкретного номера проверяет Meta в процессе регистрации. Обычный WhatsApp Messenger не является приложением WhatsApp Business.

Подключение с сохранением приложения на телефоне

1. В ReplAI откройте Каналы → WhatsApp → Подключить.
2. Войдите в Meta и введите номер, который уже работает в WhatsApp Business. В новом сценарии Meta определяет его автоматически: отдельного пункта «Coexistence» перед вводом номера может не быть.
3. Проверьте показанный Meta профиль существующего бизнеса. Затем выберите или создайте бизнес-портфолио, если Meta предлагает этот шаг.
4. Следуйте подтверждению в WhatsApp Business: Meta может показать QR-код или прислать сообщение с переходом к подключению Business Platform.
5. Решите, хотите ли вы поделиться прежней перепиской. Это отдельное согласие: отказ от импорта не мешает новым сообщениям работать.
6. Завершите окно Meta и дождитесь подтверждения подключения в ReplAI. Во время первоначальной синхронизации держите приложение на телефоне открытым.

Владелец и агент работают на одном номере. Входящие и ответы через API отображаются в приложении WhatsApp Business. Ответы с телефона появляются в ReplAI как сообщения оператора и ставят AI на паузу в соответствующем диалоге. Вернуть его в AI-режим можно из раздела Диалоги.

Прежняя переписка импортируется отдельно. Если вы разрешили доступ, Meta может передать личные сообщения за последние шесть месяцев. ReplAI добавляет последние реплики в контекст активного диалога; сам импорт истории не запускает ответы агента и не создаёт список всех старых чатов. Групповые переписки не импортируются.

Карточка канала показывает состояние импорта. Если история не передана или импорт не завершился, новые сообщения могут продолжать работать. Повторный импорт зависит от ограничений Meta: простое обновление страницы не запускает его заново. Обратитесь в поддержку ReplAI, прежде чем отключать номер.

Отдельный номер Cloud API. Через то же окно можно подключить номер для работы через API. Такой номер не сохраняет приложение WhatsApp Business: в карточке канала он отображается без пометки о работе с телефоном.

Ограничения Coexistence

• Групповые чаты остаются в телефоне и не синхронизируются через API.
• В личных чатах отключаются исчезающие сообщения, «просмотр один раз» и трансляция геопозиции. Списки рассылки в приложении становятся доступны только для чтения.
• После подключения связанные устройства нужно привязать заново. WhatsApp для Windows и WearOS не поддерживаются в этом режиме.
• Открывайте WhatsApp Business на основном телефоне регулярно: примерно после двух недель неактивности Meta может отключить подключение.

Условия и ограничения Meta.

Отключение

Чтобы полностью отключить Cloud API от приложения, в WhatsApp Business откройте Настройки → Аккаунт → Business Platform → Отключить аккаунт. Название пункта зависит от языка приложения. Удаление канала в ReplAI само по себе не выполняет это действие в телефоне.

Проверка

Напишите на подключённый номер с другого телефона. Входящее и ответ агента должны появиться в ReplAI. При Coexistence проверьте их также в приложении, а затем ответьте с телефона: сообщение должно появиться как ответ оператора, и AI должен встать на паузу в этом диалоге.

Полезно знать

Окно 24 часов относится к API. Свободный ответ через Cloud API доступен в течение 24 часов после сообщения клиента. За пределами окна нужны одобренные шаблоны. Сообщения из приложения WhatsApp Business не открывают и не продлевают это окно.

Тарифы Meta. Сообщения из приложения остаются бесплатными со стороны Meta. К сообщениям через API применяются правила и тарифы Cloud API.

Оператор из кабинета отвечает из раздела Диалоги, как и в других каналах. Ответ позже 24 часов через Cloud API не дойдёт: под сообщением появится строка «Не доставлено» с причиной — см. Если сообщение не дошло.

Фото от покупателя. Агент смотрит на снимок, который прислал покупатель: описывает, что на фото, и ищет похожее в каталоге. В Диалогах фото видно миниатюрой. Расход токенов и срок хранения те же, что в чате на сайте. Так же работает Instagram.

Включено по умолчанию. Выключить можно на странице канала, строка «Фото от покупателей», отдельно для WhatsApp и для Instagram. Тогда покупатель получит ответ, что агент понимает только текст.

Если модель агента не видит картинки (DeepSeek), снимок увидит оператор, а покупатель получит просьбу описать его словами. Видео и документы агент не разбирает.

Если сообщения не приходят

Ранее подключённый личный номер: проверьте Связанные устройства в телефоне. Если связь потеряна, обратитесь в поддержку ReplAI.

Meta: проверьте состояние канала в ReplAI. Если приложение на телефоне было неактивно или номер отключили от Business Platform, потребуется повторное подключение. Номер, подключённый раньше вручную токеном, продолжает работать, но сменить токен в кабинете нельзя — если он истёк, подключите номер заново кнопкой или обратитесь в поддержку.

Для обоих способов проверьте баланс в разделе Биллинг — см. Тарифы и токены. Если причина неясна, обратитесь в поддержку ReplAI и укажите, какой номер и способ подключения используются.