Подключение пользователей приложения WhatsApp Business (так называемое "сосуществование") | Документация для разработчиков
Внедрение приложения WhatsApp Business для новых пользователей (так называемое "сосуществование")
Обновлено: 20 марта 2026 г
Вы можете настроить встроенную регистрацию, чтобы бизнес-клиенты могли регистрироваться, используя свою существующую приложения WhatsApp Business . Клиенты, успешно прошедшие регистрацию после выбора этой опции, смогут использовать ваше приложение для массовой рассылки сообщений своим клиентам, но при этом сохранят возможность отправлять сообщения индивидуально через приложение WhatsApp Business, сохраняя при этом синхронизацию истории переписки между обоими приложениями.
Как это работает
При настройке встроенной регистрации телефонных номеров для приложения WhatsApp Business, корпоративному клиенту, прошедшему соответствующую процедуру, будет предоставлена возможность подключить свою существующую учетную запись приложения WhatsApp Business к Cloud API:
Если они выберут этот вариант и введут номер телефона, указанный в приложении WhatsApp Business, им будет предложен код подтверждения для ввода.
В сообщении компании предлагается скопировать код подтверждения и выполнить следующие действия:
Ожидайте сообщения от официального бизнес-аккаунта Facebook. Нажмите «Подключить»:
Нажмите кнопку «Подключиться к бизнес-платформе», чтобы продолжить процесс подключения.
Нажмите кнопку «Подтвердить» в приложении, чтобы разрешить компании поделиться с вами историей переписки.
Вставьте проверочный код.
Они могут завершить оставшуюся часть процесса встроенной регистрации. Это возвращает их идентификаторы активов и код обмениваемого токена в окно запуска, как обычно. Затем вы можете использовать эту информацию в вызовах API для (1) регистрации бизнес-клиента так же, как и любого другого бизнес-клиента, и (2) синхронизации его контактов и истории сообщений (если это разрешено компанией), чтобы вы могли заполнить ее в своем приложении.
Требования
Ограничения
Неподдерживаемые страны
Номера телефонов учетных записей WhatsApp Business со странами, имеющими коды следующих стран, не поддерживаются:
НигерияЮАР
Цены
После подключения бизнес-клиента к Cloud API сообщения, отправляемые компанией через приложение WhatsApp Business, по-прежнему будут бесплатными, но сообщения, отправляемые через API, будут облагаться тарифами Cloud API .
Ознакомьтесь с нашим API-решения для пользователей приложения WhatsApp Business, где представлены распространенные сценарии ценообразования.
окно обслуживания клиентов
Окна службы поддержки клиентов будут открываться только тогда, когда пользователь WhatsApp отправит сообщение бизнес-клиенту, уже подключенному к Cloud API. Если пользователь WhatsApp отправит сообщение компании непосредственно перед ее подключением к Cloud API, компания сможет ответить только шаблонным сообщением, поскольку окно службы поддержки клиентов еще не было открыто. Если пользователь отправит сообщение компании после ее подключения к Cloud API, окно службы поддержки клиентов откроется в обычном режиме, и компания сможет ответить обычным сообщением.
Ограничение на 24-часовой срок обслуживания клиентов распространяется на сообщения, отправленные через Cloud API. Сообщения, отправленные из приложения WhatsApp Business, не подпадают под действие этого ограничения и не создают, не продлевают и не влияют на сроки обработки сообщений в Cloud API или на цены Cloud API.
Сравнение характеристик
В таблице ниже описаны функции, доступные корпоративным клиентам, подключившимся к Cloud API, а также любые изменения в функциональности приложения WhatsApp Business после подключения.
| Существующая функция в приложении WhatsApp Business | Изменения в функциональности приложения WhatsApp Business ПОСЛЕ подключения к облачному API | Поддерживается ли функция приложения WhatsApp Business в облачном API? |
|---|---|---|
|
Индивидуальные (1:1) чаты |
Теперь поддерживается редактирование/отмена сообщений. |
Поддерживается.
Все сообщения чата за последние 6 месяцев можно синхронизировать.
Сообщения, отправленные и полученные, дублируются между облачным API и приложением WhatsApp Business. |
|
Контакты |
Без изменений. |
Поддерживается.
Все контакты, имеющие номер WhatsApp, могут быть синхронизированы. |
|
Групповые чаты |
Без изменений. |
Не поддерживается.
Групповые чаты синхронизироваться не будут. |
|
Исчезающие сообщения |
Функция исчезающих сообщений будет отключена для всех индивидуальных (1:1) чатов |
Не поддерживается. |
|
Функция просмотра сообщений один раз будет отключена для всех индивидуальных (1:1) чатов |
Не поддерживается. | |
|
Сообщение о местоположении в реальном времени |
Сообщения о местоположении в реальном времени будут отключены для всех индивидуальных (1:1) чатов |
Не поддерживается. |
|
Списки рассылки |
Список рассылок будет отключен.
Предприятия не смогут создавать новые списки рассылки.
Существующие списки рассылки станут доступны только для чтения. |
Не поддерживается. |
|
Голосовые и видеозвонки |
Без изменений. |
Не поддерживается. |
|
Инструменты для бизнеса (например, каталог, заказы, статус) |
Без изменений. |
Не поддерживается. |
|
Инструменты обмена сообщениями (например, маркетинговые сообщения, приветственные сообщения, сообщения об отсутствии, быстрые ответы, метки) |
Без изменений. |
Не поддерживается. |
|
Профиль компании (например, название компании, адрес, веб-сайт) |
Без изменений. |
Не поддерживается. |
|
Каналы |
Без изменений. |
Не поддерживается. |
Связанные устройства
Компании могут подключить до четырех дополнительных клиентов WhatsApp к своей учетной записи WhatsApp Business на других устройствах ( в нашем Справочном центре подключенными устройствами »
Поддерживаются все сопутствующие приложения, за исключением WhatsApp для Windows и WhatsApp для WearOS .
После того как корпоративный клиент подключится к Cloud API, используя существующую учетную запись и номер приложения WhatsApp Business, все сопутствующие приложения будут отвязаны от учетной записи, и компания сможет повторно подключить любые поддерживаемые сопутствующие приложения.
Пользователи WhatsApp, использующие неподдерживаемое приложение-компаньон для отправки сообщений подключенной компании, могут это сделать, но сообщение не будет запускать сообщений , поэтому компания не сможет отобразить это сообщение в своем собственном приложении.
Сообщения, отправленные зарегистрированной компанией (любым способом) и просмотренные на неподдерживаемом дополнительном устройстве, будут отображаться с текстом-заполнителем, указывающим пользователю WhatsApp на необходимость просмотра сообщения на основном устройстве.
Настройка вашего приложения
Шаг 1: Подпишитесь на веб-хуки
Перейдите в Панель управления приложениями > WhatsApp > конфигурации и подпишите ваше приложение на следующие поля темы веб-перехватчика учетной записи WhatsApp Business, а также убедитесь, что код обратного вызова вашего приложения может обрабатывать данные для каждого из них. Обратите внимание, что эти поля добавляются к любым полям, на которые вы уже подписаны как поставщик решения.
история — описывает сообщения, которые клиент отправлял/получал в прошлом.smb_app_state_sync — описывает текущие и новые контакты бизнес-клиента.smb_message_echoes — описывает все новые сообщения, которые бизнес-клиент отправляет с помощью приложения WhatsApp Business после подключения.
Шаг 2: Настройка встроенной формы регистрации
Добавьте
featureType со значением whatsapp_business_app_onboarding к extras в части кода реализации встроенной регистрации метода launch и обратного Чтобы убедиться, что функция включена правильно, получите доступ к вашей реализации встроенной регистрации. Если экран выбора WABA заменен экраном, предоставляющим возможность подключения существующего аккаунта WhatsApp Business, значит, функция включена.
Шаг 3: Регистрация клиентов в Surface Embedded
После подтверждения включения этой функции, предоставьте встроенную форму регистрации вашим бизнес-клиентам.
Обратите внимание, что после завершения процесса компанией и подключения клиента у вас есть 24 часа на синхронизацию истории его сообщений , в противном случае его необходимо будет отключить и повторно подключить. По этой причине мы рекомендуем вам:
Внедрить и синхронизировать, как только бизнес завершит процессСообщите компании, что вы синхронизируете данные их приложения WhatsApp BusinessПосоветуйте им держать приложение WhatsApp Business открытым, чтобы упростить процесс синхронизации
Процесс подключения и синхронизации может занять несколько минут, в зависимости от ряда факторов, таких как размер истории сообщений компании, скорость интернет-соединения, скорость обработки веб-хуков и т. д.
После завершения подключения приложение WhatsApp Business автоматически обновится и сообщит компании, что ее номер теперь подключен к API:
После завершения синхронизации истории сообщений компании мы рекомендуем сообщить клиенту о завершении процесса.
Привлечение корпоративных клиентов
Когда корпоративный клиент успешно завершит встроенную процедуру регистрации, его идентификаторы активов и обмениваемый токен будут возвращены в окно, запустившее эту процедуру, как обычно, но в события сессии будет указано
событие FINISH_WHATSAPP_BUSINESS_APP_ONBOARDING :{ data: { waba_id: "<CUSTOMER_WABA_ID> " }, тип: "WA_EMBEDDED_SIGNUP", событие: "FINISH_WHATSAPP_BUSINESS_APP_ONBOARDING", версия: 3 }Получите идентификаторы активов клиента и коды обмениваемых токенов и используйте их для регистрации клиента, как обычно, но пропустите этап регистрации номера телефона , поскольку номер уже зарегистрирован.
Внедрение корпоративных клиентов в качестве поставщика решенийВнедрение ИТ-решений для корпоративных клиентов в качестве поставщика технологических услуг
После завершения этих этапов регистрации вы можете начать синхронизации истории сообщений .
Проверить статус регистрации (необязательно)
При желании вы можете проверить, зарегистрирован ли рабочий номер телефона клиента для использования как в Cloud API, так и в приложении WhatsApp Business, запросив
is_on_biz_app и platform_type в идентификаторе рабочего номера телефона:Пример запроса:
Пример ответа:
Если
is_on_biz_app имеет значение true , а platform_type — CLOUD_API , то номер телефона компании может использовать Cloud API и приложение WhatsApp Business:Синхронизация данных приложения WhatsApp Business
После регистрации бизнес-клиента у вас есть 24 часа на синхронизацию его контактов и истории сообщений, в противном случае его необходимо будет удалить из системы и пройти весь процесс заново. Поэтому мы рекомендуем начинать процесс синхронизации сразу после завершения регистрации бизнес-клиента.
Напоминаем, что при регистрации компании , а также на дополнительные поля веб-хуков , иначе вы пропустите важные веб-хуки.
Шаг 2: Инициировать синхронизацию истории сообщений
В случае успеха будет запущен один или несколько веб-хуков истории, в зависимости от того, решила ли компания поделиться с вами своей историей переписки.
Обратите внимание, что этот шаг можно выполнить только один раз. Если потребуется повторить его, клиент должен сначала выйти из системы, а затем снова пройти процедуру регистрации в рамках встроенной системы.
История сообщений, которыми поделились
Если компания решит поделиться с вами историей своих сообщений, будет запущена серия веб-хуков, описывающих каждое сообщение, отправленное пользователям WhatsApp или полученное от них за определенный период времени.
разделе «История» вы найдете описание содержимого этих веб-хуков и того, как они организованы.
История сообщений не передается
Если компания решила не делиться с вами историей переписки, вместо этого будет запущен истории с кодом ошибки
2593109 Шаг 3: Отобразите новые сообщения приложения WhatsApp Business
Подключенные компании по-прежнему могут использовать приложение WhatsApp Business и поддерживаемые сопутствующие устройства для отправки и получения сообщений. Каждый раз, когда компания отправляет сообщение с помощью одного из этих приложений, запускается smb_message_echoes , который необходимо обработать и отобразить в истории переписки контактов в вашем приложении.
Отчеты об активности конверсий
Подключенные бизнес-клиенты могут запускать рекламу Click to WhatsApp, поэтому мы рекомендуем вам сообщать о сигналах покупки/генерации лидов от имени компании, используя API конверсий. См. API конверсий для обмена сообщениями с бизнес-клиентами .
Прекращение обслуживания корпоративных клиентов
Вместо этого ваши корпоративные клиенты могут использовать приложение WhatsApp Business, чтобы отключиться от Cloud API, перейдя в Настройки > Учетная запись > Бизнес-платформа и нажав «Отключить учетную запись» . Когда корпоративный клиент отключается от Cloud API, срабатывает account_update с
PARTNER_REMOVED Ошибки
При подключении бизнес-клиента с использованием номера телефона приложения WhatsApp Business вы можете получить сообщение "Неподдерживаемый веб-перехватчик сообщений" с кодом
Первая отправка сообщения : Пользователь WhatsApp впервые отправляет сообщение вашей компании. Это особенно часто происходит, когда пользователи нажимают на одно из ваших рекламных объявлений, которое переходит в WhatsApp , и сразу же отправляют сообщение. Ошибка обычно устраняется в течение нескольких секунд, после чего сообщения доставляются в обычном режиме.Неподдерживаемое вспомогательное устройство : Пользователь WhatsApp, использующий неподдерживаемое вспомогательное устройство , отправляет или получает сообщение от вашей компании или в вашу компанию.
131060. Это ожидаемое явление, которое может возникнуть в следующих случаях:Если вы получили это сообщение через веб-перехватчик, попросите компанию проверить приложение WhatsApp Business на наличие этого сообщения.
Нужна помощь?
Для регистрации в выберите:
Тема вопроса: «WABiz: Адаптация новых сотрудников» и «TechProvider: Адаптация новых сотрудников»Тип запроса: «Встроенная регистрация — адаптация в рамках программы Coexistence»
проблем с API сосуществования выберите:
Тема вопроса: «WABiz: Облачный API»Тип запроса: «API и веб-хуки для синхронизации данных в условиях сосуществования»
Комментарии отсутствуют
Комментарии отсутствуют