> For the complete documentation index, see [llms.txt](https://help.1msg.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.1msg.io/docs/russkii/registraciya/waba-coexistence.md).
# WABA Coexistence
Coexistence - это режим работы, при котором ваш номер телефона остается активным в мобильном приложении WhatsApp Business, но при этом подключен к платформе 1MSG.
**Главная «фишка»:** Теперь, если сотрудник напишет клиенту прямо с телефона (из приложения), это сообщение моментально придет на ваш Webhook как обычное исходящее сообщение от компании. Ваша система всегда будет в курсе того, о чем идет переписка, даже если она ведется «в поле» с мобильного.
{% hint style="info" %}
Работает только сценарий: **WhatsApp Business App → API (Coexistence)**
Т.е. подключение номера WABA к WhatsApp Business App невозможно.
{% endhint %}
### Возможности и преимущества
* Полная синхронизация: Исходящие сообщения из приложения отображаются в вашей интеграции.
* Гибкость работы: Менеджеры могут отвечать на бегу с телефона, а сложные рассылки и чат-боты будут работать через API.
* Единая история: Все диалоги сохраняются в вашей базе данных без пробелов.
### Условия и важные нюансы
Режим Coexistence накладывает ряд правил, которые необходимо соблюсти для стабильной работы:
1. **«Выдержка»** номера: Телефонный номер должен быть активен в приложении WhatsApp Business **не менее 7 дней** до момента активации режима.
2. **Выбор аккаунта:** При настройке нужно сразу выбрать конкретный WhatsApp Business Account (WABA).
3. Нужно открывать WhatsApp Business App хотя бы **раз в 14 дней**, иначе связь может отвалиться
4. **Актуальное приложение.** У вас должна быть установлена последняя версия WhatsApp Business App на смартфоне с камерой. Камера потребуется для сканирования QR-кода при подключении
### Ограничения WhatsApp Business App в режиме Coexistence
После включения Coexistence приложение продолжает работать, но часть функций ограничивается или меняет поведение.
**Broadcast-рассылки.** Нельзя создавать новые рассылки. Старые списки становятся только для просмотра. Отправка массовых сообщений возможна только через API (шаблоны)
**Отключённые типы сообщений.** Следующие типы сообщений становятся недоступны:
* disappearing messages
* view-once сообщения (одноразовый просмотр)
* live location (геолокация в реальном времени)
**Ограничения на редактирование и удаление.** Редактирование и удаление сообщений не удаляет в API WABA.
**Ограничения устройств.**
* все linked devices при подключении сбросятся и необходимо авторизоваться снова.
* cосуществование работает только с WhatsApp Business App, но не с обычной персональной версией WhatsApp.
* сообщения с них могут не попадать в API
### Ограничения Business Manager и WABA (Meta)
**Business Manager (Meta).** После подключения нельзя сменить Business Manager. Также рн должен принадлежать именно той компании, которая будет отправлять сообщения. Добавление посторонних пользователей (не из вашей компании) может привести к блокировке Business Manager.
**Окно поддержки 24 часа.** Ограничение в 24 часа для окна обслуживания клиента действует для сообщений, отправленных через Cloud API. На сообщения, отправленные из приложения WhatsApp Business, не распространяется окно обслуживания клиента. Они не создают и не продлевают окна переписки Cloud API, а также не влияют на них и на цену Cloud API.
**Расценки**. После подключения к Cloud API сообщения, отправленные компанией через приложение WhatsApp Business, **останутся бесплатными**, однако на сообщения, отправленные через API, будут распространяться расценки для Cloud API.
* App: не тарифицируется
* Cloud API: тарифицируется по правилам WABA
**Зеленая галочка (Official Business Account).** Получить статус официального бизнес-аккаунта (OBA) с заветной галочкой в режиме Coexistence **невозможно**.
**Ограничения.** География: Функция доступна не во всех регионах. Номер не должен относиться к запрещённым регионам Meta (список стран динамически обновляется Meta):
* Нигерия
* Южная Африка
***
### Как подключить через Embedded Signup
Процесс подключения интегрирован прямо в интерфейс 1MSG и занимает несколько минут.
1. Запуск Embedded Signup. Используйте стандартный процесс Embedded Signup. В процессе выберите:
* **Нет, этот номер не подключен к WhatsApp Business API.**
* **Да, этот номер подключен к приложению WhatsApp Business.**
2. Подключение приложения WhatsApp Business. Продолжите с опцией: **«Подключить существующее приложение WhatsApp Business»**
Введите номер телефона повторно и пройдите верификацию.
3. **Откройте приложение WhatsApp Business на телефоне.**
Следуйте инструкциям внутри приложения:
* Появится новое сообщение WhatsApp с предложением отсканировать QR-код
* Нажмите на сообщение и отсканируйте QR-код, отображаемый на экране
4. **Подтверждение миграции и синхронизации истории.**
Далее следуйте инструкции. Нажмите на кнопку **«Сканировать QR-код»** и выберите не синхронизировать историю сообщений и контакты (если вам нужна синхронизации истории сообщений за прошлые периоды, отпишите в поддержку).
После нажатия произойдёт подключение к платформе WhatsApp Business Platform
5. **Завершение Embedded Signup.**
Подтвердите или отредактируйте информацию о вашем WhatsApp Business Account.
После завершения номер будет готов к использованию в WhatsApp Business Platform (Cloud API). Вебхуки будут логироваться и станут доступны
***
### Как удалить связку с WABA
Вам необходимо отключить режим Coexistence через настройки WhatsApp Business.
#### Пошаговая инструкция
1. Откройте приложение **WhatsApp Business**
2. Перейдите в **Settings (Настройки)**
3. Откройте раздел **Account (Аккаунт)**
4. Выберите **Business Platform**
5. Нажмите **Disconnect (Отключить)**
#### Что произойдёт после отключения
* ❌ API WABA будет отключён
* ✅ приложение продолжит работать как обычный WhatsApp Business
* ❌ webhook перестанет получать события
* ❌ интеграции (CRM, боты) перестанут работать