> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ycloud.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Подключение приложения WhatsApp Business
> Откройте расширенные возможности обмена сообщениями через API, продолжая использовать приложение WhatsApp Business
## Что такое сосуществование WhatsApp
**Это значит, что ваш WhatsApp Business API и приложение WhatsApp Business теперь могут работать одновременно!**
Подключение к API номера, уже используемого в приложении WhatsApp Business, позволяет API и приложению работать на одном и том же телефонном номере. Вы можете использовать такие функции, как массовые рассылки, ответы AI Agent, сценарии на основе правил и Journeys, продолжая отправлять сообщения из приложения WhatsApp Business.
Эта функция идеально подходит для команд, которые хотят перейти на рабочие процессы на базе API, продолжая использовать существующее приложение.
## Зачем использовать сосуществование WhatsApp
**Сценарий 1:** Если вашим сотрудникам необходимо общаться с клиентами с рабочего компьютера днем и беспрепятственно продолжать диалог через приложение вечером.
**✅ Преимущества:** Сообщения будут зеркально отображаться между мобильным приложением и API. А именно:
1. Сообщения, отправленные через API, появятся в приложении WhatsApp Business.
2. Сообщения, отправленные через приложение, появятся в истории переписки Cloud API, которую можно просматривать на компьютерах.
**Сценарий 2:** Если вы хотите использовать такие возможности, как массовые маркетинговые рассылки, интеллектуальные автоответы AI Agent, взаимодействие с клиентами на основе Journey и другие расширенные функции, сохраняя при этом доступ через мобильное приложение.
**✅ Преимущества:** Сосуществование WhatsApp позволяет использовать все эти расширенные функции API, сохраняя при этом личную переписку в приложении.
**Сценарий 3:** Если у вас уже есть активный номер в приложении WhatsApp Business и вы хотите избежать сложностей с регистрацией нового номера для API.
**✅ Преимущества:** Легко подключите номер своего приложения WhatsApp Business и используйте функционал API без удаления исходного аккаунта WhatsApp Business.
## Важная информация
#### **Пропускная способность**
1. Для обеспечения совместимости с приложением WhatsApp Business телефонные номера компаний, используемые одновременно в приложении WhatsApp Business и Cloud API, имеют фиксированную пропускную способность 5 mps (сообщений в секунду).
#### **Требования**
Для использования этой функции необходимо использовать приложение WhatsApp Business версии 2.24.17 или выше.
#### **Цены**
Сообщения, отправленные из приложения WhatsApp Business, остаются бесплатными, а сообщения, отправленные через партнерскую платформу API, тарифицируются в соответствии с действующей [моделью ценообразования API](https://www.ycloud.com/price).
#### **Сравнение функций после привязки**
В следующей таблице описаны функции, доступные бизнес-клиентам, подключенным к Cloud API, а также любые изменения в функционале приложения WhatsApp Business после подключения. Примечание: медиасообщения (например, содержащие изображения, видео и аудио) старше 14 дней не могут быть синхронизированы.
## Как это работает
Откройте **WhatsApp accounts**, нажмите **Create Channel** и найдите **WhatsApp Business APP Coexistence**.
Сосуществование приложения WhatsApp Business можно настроить двумя способами. Выберите способ, соответствующий тому, как ваша компания управляет ресурсами Meta.
| Способ подключения | Когда использовать | Что потребуется |
| - | - | - |
| **Подключение через Facebook** | Используйте этот метод, если хотите, чтобы номер приложения WhatsApp Business принадлежал вашему бизнес-портфолио Meta и управлялся в нем. | Аккаунт Facebook, регистрационные документы компании и веб-сайт компании для подтверждения компании (Business Verification). |
| **Подключение по QR-коду** | Используйте этот более быстрый способ, если вы не хотите входить через Facebook или создавать бизнес-портфолио в процессе подключения. | Информация о вашей компании и доступ к приложению WhatsApp Business на подключаемом телефоне. |
Оба способа сохраняют доступность телефонного номера в приложении WhatsApp Business при подключении его к YCloud.
## Вариант 1: Подключение через Facebook
Этот метод привязывает номер приложения WhatsApp Business к бизнес-портфолио Meta. В дальнейшем вы сможете обслуживать и управлять связанными бизнес-ресурсами в Meta Business Portfolio.
Перед началом подготовьте аккаунт Facebook, регистрационные документы вашей компании и ее веб-сайт. Эти материалы необходимы для подтверждения компании (Business Verification).
1. Войдите в свой аккаунт Facebook.
2. Создайте бизнес-портфолио или выберите существующее.
3. На шаге WhatsApp Business Account выберите **Connect a WhatsApp Business App**.
4. Введите номер телефона, используемый в вашем приложении WhatsApp Business.
5. Когда появится QR-код, откройте WhatsApp Business App на телефоне и отсканируйте его, чтобы авторизовать подключение.
6. На телефоне выберите, нужно ли синхронизировать историю чатов. Можно синхронизировать историю максимум за последние шесть месяцев.
## Вариант 2. Подключение по QR-коду
Это более быстрый способ подключения. Он не требует входа через Facebook или создания бизнес-портфолио в процессе подключения.
1. Выберите способ подключения по QR-коду.
2. Введите название компании и информацию о веб-сайте.
Для сосуществования WhatsApp Business App по-прежнему требуется Business Verification. Поле **Business name** , введенное при подключении, должно в точности совпадать с юридическим названием компании в регистрационных документах, которые вы планируете предоставить. Несоответствие может повлиять на последующую процедуру Business Verification.
Укажите поле **Website** корректно. Если у вашей компании нет сайта, выберите **My business does not have a website or profile page** вместо того, чтобы оставлять поле пустым.
3. Введите номер телефона WhatsApp Business App, который хотите подключить.
4. Откройте WhatsApp Business App на телефоне и отсканируйте QR-код, чтобы авторизовать подключение.
5. На телефоне выберите, нужно ли синхронизировать историю чатов. Можно синхронизировать историю максимум за последние шесть месяцев.
## Синхронизация истории чатов
После завершения авторизации YCloud немедленно начнет синхронизацию чатов, если вы решили поделиться историей переписки.
Не закрывайте WhatsApp Business App во время синхронизации. Новые сообщения появятся во входящих YCloud только после завершения синхронизации.
## Посмотреть видеоинструкцию
[Посмотреть обучающее видео по сосуществованию WhatsApp Business App](https://youtu.be/gIJx2XGC3gA)
## Часто задаваемые вопросы
Нет. Вы можете продолжать отправлять и получать сообщения, а также управлять контактами в приложении WhatsApp Business App.
Нет. Сосуществование WhatsApp Business App должно подключаться через платформу YCloud. YCloud не предоставляет API для этой операции подключения.
Обычно это означает, что авторизация прошла успешно, но окончательная привязка не удалась. Возможные причины включают в себя:
* **Ранее был подключен к другой платформе:** Аккаунт все еще может быть связан с другим провайдером. Выполните процесс миграции аккаунта в режиме сосуществования, прежде чем пытаться привязать его к YCloud.
* **Временный сбой привязки:** Если интерфейс привязки был временно нестабилен, отвяжите YCloud от WhatsApp Business App на телефоне, а затем запустите подключение заново.
* **Неполные сведения о сайте:** Если не был указан действительный веб-сайт и не был выбран вариант **My business does not have a website or profile page** , аккаунт может остаться в состоянии ожидания. Отвяжите его на телефоне и повторите подключение, указав полную информацию о бизнесе.
| Ошибка | Значение и рекомендуемое действие |
| - | - |
| `#2655093: already shared with another partner` | Аккаунт ранее был связан с другим провайдером. Попросите предыдущего провайдера полностью удалить партнерский доступ, затем повторите попытку. Успешное повторное подключение не гарантируется. |
| `#2655121: Restricted WhatsApp Business Account` | Аккаунт заблокирован или ранее блокировался в мобильном приложении и может считаться высокорисковым. Используйте другой номер или подождите несколько дней перед повторной попыткой. |
| `#3441061: phone number linked to automated events` | Отключите автоматические события, указанные Meta, дождитесь синхронизации изменений со стороны Meta и повторите попытку. |
| `Your phone number isn't eligible to connect to the WhatsApp Business platform. More activity on the WhatsApp Business app is needed to help determine eligibility.` | У Meta пока недостаточно недавней активности, чтобы определить соответствие номера требованиям. Это может произойти, если аккаунт новый, в нем мало недавних диалогов или он не был активен в последнее время. Продолжайте использовать приложение WhatsApp Business для реального общения, а затем попробуйте подключить его позже. |
Meta может автоматически отвязать аккаунт, если WhatsApp Business App было неактивно или если выполнен вход в приложение на другом устройстве. Подключите аккаунт заново в YCloud.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.