> For the complete documentation index, see [llms.txt](https://doc.nextbot.ru/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.nextbot.ru/functional/integrations/waba/rezhim-coexistence.md).

# Режим Coexistence

Пошаговое руководство по настройке режима Coexistence (сосуществование мобильного приложения и API)

### Зачем нужен режим Coexistence <a href="#id-1-----coexistence" id="id-1-----coexistence"></a>

Переход на официальный **WhatsApp Business API (WABA)** требовал полного удаления аккаунта из мобильного приложения на смартфоне. Для малого и среднего бизнеса это создавало серьезный барьер:

* требовалось покупать отдельный номер под ИИ-агента;
* менеджеры лишались возможности оперативно отвечать клиентам со своих смартфонов «в полях» или вне рабочего места.

**Режим Coexistence от Meta решает эту проблему.**&#x20;

* Он позволяет использовать один и тот же номер телефона одновременно в мобильном приложении **WhatsApp Business** на смартфоне и через **WhatsApp Business API (Cloud API)** на **одном телефонном номере**.
* Сотрудники могут отвечать клиентам вручную с телефона, а чат-боты, рассылки и автоматические триггеры работают через API.

### Системные требования Meta к номеру Coexistence <a href="#id-4---meta---coexistence" id="id-4---meta---coexistence"></a>

Перед запуском убедитесь, что ваш номер удовлетворяет требованиям Meta:

1. На смартфоне установлено официальное приложение **WhatsApp Business версии 2.24.17 или новее**.
2. Номер зарегистрирован в приложении более **3 месяцев** и имеет активную переписку.
3. В приложении WhatsApp Business **отвязаны все способы оплаты** (настройки платежей).
4. Номер не принадлежит операторам Нигерии или ЮАР (в этих странах режим ограничен).

### Ограничения Coexistence: <a href="#coexistence" id="coexistence"></a>

* **Лимит пропускной способности:** ограничение отправки сообщений через API — до 20 сообщений в секунду.
* **Недоступна «синяя галочка» Meta:** верифицированный статус официального бизнес-аккаунта (Official Business Account) можно получить только на чистом API-номере.
* **Отвязка WhatsApp Web:** при интеграции Meta принудительно отвязывает сторонние связанные веб-браузеры.
* **Требование к активности устройства:** если смартфон выключен или не выходит в интернет длительное время, Meta может приостановить связь между приложением и облаком.
* **Специфические функции:** Группы, исчезающие сообщения, сообщения с однократным просмотром, рассылки и каталог в диалоги не попадают.

### Пошаговый алгоритм прохождения мастера подключений в Nextbot <a href="#id-6------nextbot" id="id-6------nextbot"></a>

### Шаг 1. Откройте мастер подключений <a href="#id-1" id="id-1"></a>

1. В интерфейсе Nextbot откройте раздел **Интеграции** → вкладку **WABA: WhatsApp Business API**.
2. В появившемся окне мастера нажмите **Далее**.

### Шаг 2. Выбор способа подключения <a href="#id-2" id="id-2"></a>

1. Отметьте вариант **«Существующий номер приложения WhatsApp Business»** это и есть Режим Coexistence.
2. Ознакомьтесь с условиями и нажмите **Далее**.

### Шаг 3. Подтверждение VPN <a href="#id-3--vpn" id="id-3--vpn"></a>

1. Убедитесь, что сетевое VPN-соединение активно.
2. Нажмите кнопку **Далее**.

### Шаг 4. Системная подготовка <a href="#id-4-----gupshup" id="id-4-----gupshup"></a>

1. Система автоматически сгенерирует токен партнера, приложение и callback-сервисы.
2. В появившемся фрейме Gupshup нажмите синюю кнопку **Continue with Facebook**.\
   *(Если всплывающее окно заблокировано, откройте персональную ссылку `https://gs.tc.im/...` в новой вкладке).*
3. В мастере Nextbot нажмите **Далее**.

   > **Пояснение:** компании **Gupshup**, **OneDirect** и **ODCEM Technologies Pvt. Ltd.** — официальные технологические провайдеры (BSP) платформы Nextbot. Не удаляйте их из списка партнеров Meta Business Manager.

### Шаг 5. Авторизация в Facebook <a href="#id-5---facebook" id="id-5---facebook"></a>

1. Во всплывающем окне Meta войдите под вашим личным аккаунтом Facebook.
2. В мастере Nextbot нажмите **Далее**.

### Шаг 6. Предоставление разрешений <a href="#id-6" id="id-6"></a>

1. В окне Meta на экране *«Легко подключите аккаунт к ODCEM Technologies Pvt. Ltd. и Nextbot»* нажмите **Продолжить**.
2. В мастере Nextbot нажмите **Далее**.

### Шаг 7. Выбор существующего номера в Meta <a href="#id-7-----meta" id="id-7-----meta"></a>

1. В выпадающем списке поля «Номер телефона» переключитесь с варианта по умолчанию на ваш **существующий номер приложения WhatsApp Business**.
2. Выберите код страны (например, **RU +7**) и введите номер телефона, работающий на вашем телефоне.
3. Нажмите **Далее** в Meta и **Далее** в мастере Nextbot.

### Шаг 8. Выбор бизнес-портфолио (Развилка) <a href="#id-8" id="id-8"></a>

### Сценарий А: «если есть бизнес-портфолио» <a href="#undefined" id="undefined"></a>

1. Выберите вашу действующую компанию из списка в окне Meta.
2. В мастере Nextbot нажмите кнопку **У меня есть бизнес-портфолио**.
3. В форме Meta *«Заполните профиль компании»* укажите название, страну и адрес сайта (или отметьте его отсутствие). Нажмите **Далее**.
4. В мастере Nextbot нажмите **Далее**.

### Сценарий Б: «если нужно создать бизнес-портфолио» <a href="#undefined" id="undefined"></a>

1. Выберите создание компании в окне Meta.
2. В мастере Nextbot нажмите кнопку **Создать бизнес-портфолио**.
3. В форме Meta *«Укажите информацию о компании...»* укажите название, рабочий Email компании, страну и сайт. Нажмите **Далее**.
4. В мастере Nextbot нажмите **Далее**.

### Шаг 9. Синхронизация смартфона по QR-коду <a href="#id-9----qr" id="id-9----qr"></a>

1. В окне Meta откроется экран *«Импорт контактов и истории чатов»* с QR-кодом.
2. Возьмите смартфон:
   * Откройте приложение **WhatsApp Business**.
   * Перейдите: **Меню** (три точки или шестеренка) → **Настройки** → **Аккаунт** → **Платформа WhatsApp Business**.
   * Подтвердите доступ к истории сообщений.
   * Наведите камеру телефона на монитор и отсканируйте QR-код.
3. В мастере Nextbot нажмите кнопку **Далее**.

### Шаг 10. Подтверждение часового пояса <a href="#id-10" id="id-10"></a>

1. Проверьте подставившееся имя пользователя аккаунта.
2. Выберите ваш местный **Часовой пояс** (для корректной фиксации времени сообщений и рассылок).
3. Нажмите **Далее** в окне Meta и **Далее** в мастере Nextbot.

### Шаг 11. Завершение работы во всплывающем окне Meta <a href="#id-11------meta" id="id-11------meta"></a>

1. В окне Meta отобразится сообщение: *«Ваш аккаунт подключен к ODCEM Technologies Pvt. Ltd.»*.
2. Нажмите кнопку **Завершить** (*Finish*). Окно Meta закроется.
3. В мастере Nextbot нажмите **Далее**.

### Шаг 12. Привязка номера <a href="#id-12" id="id-12"></a>

1. На вкладке мастера обновится форма провайдера: *«Please select a phone number you want to associate with your App»*.
2. Появится ваш номер телефона.
3. Отметьте подтверждающий чекбокс (*«I understand that by proceeding...»*).
4. Нажмите кнопку **Next** в форме, а затем кнопку **Далее** в мастере Nextbot.

### Шаг 13. Финал настройки <a href="#id-13" id="id-13"></a>

1. На экране мастера появится поздравительное сообщение *«Congratulations! You have been successfully onboarded»*.
2. Отобразятся зарегистрированный **Phone Number** и ваш постоянный **WABA ID**.
3. Нажмите кнопку **Завершить**.

Канал настроен. Теперь ваш номер работает одновременно в мобильном приложении WhatsApp Business и в облачной платформе Nextbot.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://doc.nextbot.ru/functional/integrations/waba/rezhim-coexistence.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.