Один номер.Приложение и API одновременно.
Coexistence это официальный режим Meta для одновременной работы приложения WhatsApp Business и Cloud API на одном номере. Команда продолжает отвечать с телефона, с теми же чатами и той же историей, а программа отправляет и принимает сообщения через ту же линию.
EasyCoexistence подключает номер и следит за соединением.
Выбор, который раньше был неизбежен, а теперь его нет
Coexistence не новый API. Это устранение развилки, из-за которой почти любой малый бизнес не мог ничего автоматизировать.
Команда отвечает с телефона. Ничего нельзя автоматизировать, подключить к системам или измерить.
Без APIПрограммы получают доступ к номеру. Приложение Business перестаёт на нём работать, и команда переходит на другие инструменты.
Без приложенияMeta подключает Cloud API к номеру, который по-прежнему используется в приложении WhatsApp Business. Обе стороны работают на одной линии, и каждая видит, что отправляет другая.
Кто работает с номером таким образом
Две группы, которые хотят от одной функции противоположного, и поэтому само подключение важнее любой панели управления поверх него.
Небольшая команда, номер на фургоне или витрине и вечера, потраченные на ответы на одни и те же четыре вопроса. Они никого не заменяют. Им нужно, чтобы подтверждения, напоминания и первый ответ в нерабочее время отправлялись без участия человека, а телефон по-прежнему работал для всего остального.
Много клиентов, у каждого номер, который нельзя переносить или трогать. Им нужно, чтобы эти номера были доступны для создаваемых ими систем, и нужно добавлять следующий номер без звонка в отдел продаж. Coexistence единственный официальный путь к номеру, на который сотрудники клиента по-прежнему отвечают вручную.
Как номер работает в обоих местах и куда идут события сообщений
Четыре шага. Телефон нужен только для сканирования, а архитектуру определяет первый шаг.
Подготовьте эндпоинт до начала подключения
Meta проверяет адрес доставки, прежде чем что-либо на него отправлять. Она вызывает ваш URL запросом GET с параметрами hub.mode=subscribe, вашим hub.verify_token и hub.challenge, и ваш эндпоинт должен вернуть challenge в исходном виде.
Адрес доставки должен использовать HTTPS, а verify token обязателен. Мы проверяем и то и другое ещё до вызова, поэтому некорректный URL отсеивается у нас, а не выглядит подключённым, ничего при этом не доставляя.
Пока ничего не подключено. Здесь решается, куда будут приходить сообщения. Провайдер на пути сообщенийХранятся на его серверахПлатформа провайдераПринимает и хранит сообщенияВыКопия, по его расписаниюEasyCoexistenceТолько настройкаВаш эндпоинтЕщё не проверенМыЗадаём маршрут, но не стоим на нёмПройдите Embedded Signup от Meta и отсканируйте код в приложении
Открывается собственное окно Meta. Вы выбираете Business Portfolio, WhatsApp Business Account и номер, уже зарегистрированный в приложении WhatsApp Business, а затем подтверждаете подключение на телефоне, отсканировав код.
Здесь же вы решаете, делиться ли существующей историей чатов. Это разовое решение при подключении, изменить его потом нельзя. Приложение Business продолжает работать сразу после сканирования.
Появляется вторая сторона. Первая никуда не исчезает. После миграцииОдна сторонаТолько Cloud APIПриложение Business на этом номере не работаетПосле CoexistenceДве стороныПриложение WhatsApp BusinessТе же чаты и историяCloud APIНа той же линииНаправьте события сообщений в собственную систему
Meta позволяет приложению переопределить, куда доставляются вебхуки конкретного WhatsApp Business Account. Мы направляем это переопределение на ваш URL, и два поля пути сообщений, messages и smb_message_echoes, идут напрямую от Meta к вам.
Служебные поля мы оставляем себе, потому что из них и состоит мониторинг: account_update, phone_number_quality_update, account_alerts, account_review_update, business_capability_update и phone_number_name_update. Так панель управления остаётся полезной, а содержимое переписки никогда к нам не попадает.
Куда идут события, когда переопределение активно. Служебные событияДоставляются намПуть сообщенийДоставляются вамmessagesВсё, что отправляет клиентsmb_message_echoesТо, что команда отправляет из приложенияВаш серверНапрямую, никогда через насПоддерживайте подключение и переживите переподключение
Meta отключает номер Coexistence примерно через четырнадцать дней без активности на основном устройстве. Такое отключение можно восстановить, и мы записываем его как отдельное состояние, а не считаем клиента ушедшим.
Подвох в том, что отключение делает с маршрутом. Meta хранит адрес доставки как переопределение в подписке нашего приложения на аккаунт, поэтому PARTNER_REMOVED удаляет приложение, и переопределение исчезает вместе с ним. Повторное подключение возвращает отправку и мониторинг, но не ваш адрес доставки. Мы восстанавливаем его автоматически, потому что первый номер, попавший под это правило, чисто переподключился и молча перестал доставлять сообщения на сервер клиента.
Что переподключение восстанавливает само, а что нужно вернуть. Восстанавливает MetaАвтоматическиОтправкаCloud API снова работаетСлужебные событияМониторинг возобновляетсяПропадает вместе с приложениемНужно применить зановоПереопределение вашего вебхукаУдаляется вместе с приложениемДоставка сообщений вамМолча прекращаетсяМы применяем его зановоПри каждом переподключении
Почему команды работают с номером таким образом
- Сохранить номер, который уже напечатан на фургонах, чеках и сайте, и привычную работу с телефона вокруг него.
- Добавить отправку через API, обработку вебхуков и шаблоны, не переводя никого в новый инструмент.
- Не пропускать сообщения через общий почтовый ящик провайдера, чтобы переписка не хранилась на чужой платформе.
- Дать агентству возможность держать номера многих клиентов в одном аккаунте, каждый подключён в собственном Business Portfolio клиента.
Требования и практические ограничения
- Номер уже должен быть активен в приложении WhatsApp Business. Номер из обычного приложения WhatsApp сначала нужно перенести туда.
- Решение о передаче существующей истории чатов принимается один раз при подключении и потом не меняется.
- Групповые чаты исключены из API на номерах Coexistence, у любого провайдера.
- Основному устройству нужна регулярная активность. Meta отключает подключение примерно через четырнадцать дней без неё.
- Порядок верификации и получения значка Meta для номеров Coexistence отличается, а доступность по регионам меняется вместе с политикой Meta.
Что мы направляем вам, а что оставляем себе
Meta позволяет приложению переопределить, куда WhatsApp Business Account доставляет свои вебхуки. Мы направляем это переопределение на ваш URL, и события делятся на две части.
messagesВсё, что клиент отправляет на номерsmb_message_echoesТо, что ваша команда отправляет из приложения WhatsApp Business
account_updateСостояние подключения: удалено, отключено, переподключено, ограниченоphone_number_quality_updateИзменения рейтинга качества и пропускной способностиaccount_alertsОповещения, которые Meta выставляет аккаунтуaccount_review_updateРезультаты проверки Metabusiness_capability_updateИзменения лимита сообщений и возможностейphone_number_name_updateОдобрения и отклонения отображаемого имени
Если для номера переопределение не задано, его события сообщений попадают на наш адрес обратного вызова по умолчанию, где обработчик отбрасывает их, ничего не сохраняя. Это обеспечено кодом, а не обещано в политике: у содержимого переписки просто нет пути в хранилище.
Правило четырнадцати дней и то, что оно ломает, о чём никто не говорит
Meta отключает подключение Coexistence примерно через четырнадцать дней без активности на основном устройстве. Его можно подключить снова, поэтому мы храним это как отдельное состояние, а не считаем клиента ушедшим.
Дорого обходится последствие, которое проявляется позже. Адрес доставки ваших сообщений не является настройкой номера: это переопределение в подписке нашего приложения на WhatsApp Business Account. Отключение удаляет приложение, и переопределение исчезает вместе с ним. После повторного подключения отправка работает, мониторинг работает, а сообщения перестают приходить на ваш сервер, и никакой ошибки нигде не видно.
Мы заново применяем переопределение при каждом повторном подключении. Это поведение появилось потому, что так уже было: номер попал под это правило, чисто переподключился и молча перестал доставлять сообщения.
Если проверка связи в этот момент не проходит, потому что ваш сервер был недоступен или токен изменился, это записывается в хронологию подключения, а адрес доставки сохраняется, а не удаляется, так что достаточно сохранить его ещё раз.
Что ломается незаметно и как мы это узнаём
Приложение WhatsApp Business продолжает работать почти при любом из сбоев ниже, поэтому их никто не замечает. Вот что мы проверяем и как.
Определяется по вебхуку account_update от Meta, а именно по PARTNER_REMOVED, а не по полю, которое стало false. Мы намеренно не опираемся здесь на is_on_biz_app, потому что на номерах без Coexistence оно законно равно false и вызывало ложные отключения.
Правило Meta о неактивности основного устройства. Подключение можно восстановить, поэтому оно записывается как отдельное состояние, а не как ушедший клиент, и повторное подключение возвращает отправку и мониторинг.
Адрес доставки хранится как переопределение в подписке нашего приложения на аккаунт, поэтому отключение его удаляет. После переподключения отправка возвращается, а доставка на ваш сервер нет. Мы применяем переопределение заново каждый раз, потому что номер, с которым это случилось, чисто переподключился и молча перестал доставлять сообщения.
Мы храним токен клиента и наш собственный System User token для одного и того же аккаунта. Когда один отклоняется, другой читает аккаунт и выясняет, какой из двух на самом деле сломался, поэтому отозванный токен больше не выглядит как потерянный номер.
Запрашивается у Meta по расписанию. Рейтинг RED помечает подключение как ухудшенное, а качество, уровень лимита сообщений и пропускная способность сохраняются при каждой проверке, так что спад виден до того, как он будет стоить отправки.
Подключить номер и следить за номером это разные продукты. Второй и есть причина, по которой существует этот.
Обычно номер подключается после сканирования кода в приложении WhatsApp Business.
Сколько времени ответ клиента держит открытым окно для ответов свободным текстом.
Пропускная способность номера Coexistence, заданная Meta и не подлежащая увеличению.
Сколько истории чатов Meta синхронизирует с API при первом подключении номера.
Часто задаваемые вопросы
Нужно ли команде перестать пользоваться телефоном?
Нет. В этом весь смысл Coexistence. Приложение WhatsApp Business продолжает работать на том же номере, с теми же переписками, а API работает параллельно.
Потеряются ли существующие переписки?
Нет. Они остаются в приложении, а при подключении номера Meta синхронизирует с API около шести месяцев истории. Программа получает контекст, а не начинает с пустого места.
Можно ли отменить подключение?
Да. Номер можно отключить, после чего приложение продолжит работать как раньше. Сам номер не меняется навсегда из-за подключения.
Это то же самое, что неофициальные API WhatsApp?
Нет. Это другой продукт: Coexistence это официальная функция Meta в Cloud API. Неофициальные шлюзы работают через WhatsApp Web как связанное устройство, что нарушает условия и может привести к блокировке номеров. Стоимость таких шлюзов зависит от провайдера.
Готовы начать?
Настройте WhatsApp Coexistence за несколько минут, а не месяцев. Приложение продолжит работать на телефоне.
Начать бесплатный пробный период3 дня бесплатно. Ничего не списывается до окончания пробного периода.