Глоссарий WhatsApp Coexistence
Термины WhatsApp Coexistence легко перепутать. На практике путаница обычно возникает, когда два человека используют одно слово для разных вещей. Ниже приведены определения, принятые на этом сайте, со ссылками на подробные страницы.
EasyCoexistence подключает номер через собственный процесс Meta и следит за подключением.
- Coexistence
Официальный режим Meta, в котором приложение WhatsApp Business и Cloud API одновременно работают на одном номере. Это не отдельный API: тот же Cloud API, подключённый так, чтобы приложение продолжало работать.
WhatsApp Coexistence- Cloud API
API платформы WhatsApp Business, размещённый на серверах Meta. Каждая отправка, каждый шаблон и каждый вебхук на этом сайте проходят через него.
Cloud API или Coexistence- Приложение WhatsApp BusinessWhatsApp Business app
Приложение, которым компания пользуется на телефоне. Это не обычное приложение WhatsApp, и номер должен быть в нём, прежде чем Coexistence сможет его подключить.
- WhatsApp Business AccountWABA
Объект Meta, в котором находятся номера телефонов и шаблоны. Располагается внутри Business Portfolio. Переопределения вебхука задаются на этом уровне, а не для каждого номера.
- Business Portfolio
Контейнер уровня компании в Meta Business Manager. Содержит один или несколько WhatsApp Business Account. Номер клиента остаётся в его портфолио, а не в портфолио провайдера.
Meta Tech Provider- Phone number id
Идентификатор Meta для одного подключённого номера. Отправка адресуется ему, а не самому номеру, и он есть в каждом payload входящего вебхука.
- Embedded Signup
Собственное всплывающее окно подключения Meta. В нём выбираются портфолио, аккаунт и номер, а для Coexistence оно включает код, который сканируют в приложении WhatsApp Business.
Как подключается номер- Tech Provider
Статус Meta, позволяющий компании подключать номера других компаний через собственное одобренное приложение. Получается бесплатно, но требует верификации компании и App Review. Не означает одобрения со стороны Meta.
Что это значит- BSPBusiness Solution Provider
Компания, продающая платформу для переписки, обычно общий почтовый ящик для команды. Пересекается с Tech Provider, но описывает продукт, а не статус в Meta.
Coexistence или BSP- Адрес назначения вебхукаWebhook destination, webhook override
Куда Meta доставляет события WhatsApp Business Account. Задаётся как переопределение в подписке приложения, поэтому удаление подключения его снимает.
Вебхуки WhatsApp- hub.challenge
Значение, которое Meta отправляет в проверочном GET-запросе. Endpoint должен вернуть его как тело ответа без обработки. Возврат JSON вместо него чаще всего объясняет, почему вебхук ничего не получает.
Проверка вебхука- messages
Поле вебхука с тем, что присылают клиенты. Часть пути сообщений, который переопределение вебхука уводит от провайдера.
- smb_message_echoes
Поле вебхука с тем, что команда отправляет из приложения WhatsApp Business. Есть только у номеров Coexistence, и именно через него программа видит ответы человека.
- Окно обслуживания клиентовCustomer service window, 24-часовое окно
Двадцать четыре часа с последнего сообщения клиента, в течение которых доставляется свободный текст. Вне окна доставляется только одобренный шаблон.
Ошибка 131047- ШаблонTemplate
Сообщение, заранее отправленное в Meta на проверку. Единственное, что доставляется вне окна обслуживания клиентов, а на номере Coexistence его можно отправить только через API.
Ошибка 132001- Рейтинг качестваQuality rating
Зелёный, жёлтый или красный, присваивается Meta по реакции получателей. Падает раньше, чем это начинает вам чего-то стоить, и о падении ничто не сообщает.
Ошибка 131048- Уровень рассылкиMessaging tier
Со сколькими уникальными клиентами номер может начать разговор за сутки. Меняется в обе стороны. Не то же самое, что пропускная способность, которая является скоростью.
- Пропускная способностьThroughput
Сколько сообщений в секунду может отправлять номер. На номере Coexistence фиксируется Meta и не растёт вместе с качеством и уровнем.
Ошибка 130429- Подключённое устройствоLinked device
Обычный клиент WhatsApp, авторизованный где-то ещё, как WhatsApp Web. Именно его автоматизируют неофициальные инструменты, именно это запрещают условия WhatsApp, и именно из-за этого номера блокируют.
Риски неофициальных API- MCPModel Context Protocol
Способ, которым ИИ-ассистент обращается к инструменту, который ему не принадлежит. Только запрос и ответ: входящее сообщение не может разбудить MCP-сервер.
MCP-сервер для WhatsApp
Почему терминология вызывает столько проблем?
Потому что несколько терминов обозначают объекты разных уровней, хотя все они кажутся объектами одного уровня.
Business Portfolio содержит WhatsApp Business Account, который содержит номера телефонов, у каждого из которых есть идентификатор номера телефона. В разговоре все четыре объекта называют аккаунтом, поэтому фраза «проверьте, работает ли аккаунт» может означать четыре разные проверки. То же происходит с двумя окнами длительностью 24 часа на этой платформе: они измеряют разные процессы, но их постоянно путают.
Кроме того, Meta и провайдеры используют разные слова для одного и того же, а провайдеры не всегда согласны друг с другом. На этой странице используется терминология Meta, если она существует, и прямо указано, когда термин принадлежит нам.
Какие различия действительно важны на практике?
Три различия, и каждое уже стоило кому-то целого дня.
Окно обслуживания клиентов и окно синхронизации длятся по 24 часа, но никак не связаны. Первое определяет, доставится ли свободный текст, отсчитываясь от последнего сообщения клиента. Второе определяет, можно ли ещё перенести историю чата, отсчитываясь от подключения.
Подключённое устройство не является API. Это клиент WhatsApp для обычного использования, авторизованный где-то ещё. Именно это автоматизируют неофициальные инструменты, из-за чего номера блокируют.
А адрес назначения вебхука не является настройкой номера. Это переопределение подписки приложения на аккаунт. Поэтому он исчезает при удалении подключения, и его нужно указать заново после повторного подключения.
Часто задаваемые вопросы
Coexistence использует другой API, а не Cloud API?
Нет. Coexistence подключает номер к Cloud API, сохраняя работу приложения WhatsApp Business на этом номере. Эндпоинты, формат сообщений и правила одинаковы.
Чем отличаются Business Portfolio и WABA?
Business Portfolio является контейнером уровня компании в Meta Business Manager. WhatsApp Business Account находится внутри него и содержит номера телефонов. Один портфель может содержать несколько WABA.
BSP и Tech Provider это одно и то же?
Эти понятия пересекаются, но обозначают разное. Tech Provider это статус Meta, который позволяет компании подключать номера других компаний через своё приложение. BSP обычно означает компанию, продающую платформу для обмена сообщениями. Такой статус у неё может быть, а может и не быть.
Как MCP связан с WhatsApp?
Никак напрямую. MCP это протокол, который даёт AI-ассистенту доступ к инструменту, а сервер WhatsApp MCP предоставляет номер как один из таких инструментов. Он не может получать сообщения, а только выполнять действия по запросу.
Готовы начать?
Настройте WhatsApp Coexistence за несколько минут, а не месяцев. Приложение продолжит работать на телефоне.
Начать бесплатный пробный периодВ течение 3 дней ничего не списывается. Отмена в любое время.