Аккаунт WhatsApp Business и почему переопределения действуют на нём
Аккаунт WhatsApp Business хранит номера телефонов и шаблоны. Его роль важнее, чем кажется: маршрутизация вебхуков настраивается на этом уровне, а не для каждого номера. Поэтому при удалении подключения маршрутизация удаляется вместе с ним.
Переопределение вебхука задаётся для WABA, а не для номера.
Событие, которое одновременно удаляет приложение и переопределение.
Максимальное число шаблонов Meta для одного аккаунта.
Что именно хранит WABA?
Номера телефонов и шаблоны. Это сочетание важнее, чем кажется на первый взгляд.
Шаблоны принадлежат аккаунту, а не номеру, поэтому все номера в одной WABA используют одну библиотеку шаблонов. Создайте шаблон для обновлений по заказу, и его смогут отправлять все номера. Meta ограничивает число шаблонов в аккаунте. С этим ограничением могут столкнуться агентства, которые ведут много брендов в одном аккаунте.
У каждого номера есть собственные phone number id, отображаемое имя, рейтинг качества и уровень обмена сообщениями. Эти параметры относятся к отдельному номеру: один номер может работать хуже, пока другой в том же аккаунте остаётся в норме.
Почему переопределения вебхука действуют на этом уровне?
Потому что они меняют подписку приложения на аккаунт, а не на отдельный номер.
Когда вы задаёте адрес назначения, переопределяющий URI обратного вызова применяется к подписке нашего приложения на эту WABA. После этого события пути сообщений для каждого номера аккаунта доставляются туда. Маршрутизации для отдельных номеров нет, что часто удивляет тех, кто управляет несколькими номерами одного клиента.
Это важно учесть заранее. Когда подключение удаляется по правилу четырнадцати дней неактивности или по другой причине, приложение удаляется из аккаунта, и переопределение удаляется вместе с ним. После повторного подключения отправка сообщений и мониторинг возобновляются. Доставка на ваш сервер не восстановится, пока переопределение не будет задано снова.
Распространённые ошибки
- Ожидать отдельную маршрутизацию вебхука для каждого номера. Переопределение действует на уровне аккаунта.
- Считать, что повторное подключение восстановит адрес назначения. Он удаляется вместе с приложением, поэтому переопределение нужно задать снова.
- Забывать, что шаблоны общие. Все номера аккаунта используют одну библиотеку.
EasyCoexistence автоматически задаёт переопределение вебхука после каждого повторного подключения, потому что причина такой необходимости может лишить настоящий номер доставки сообщений.
Часто задаваемые вопросы
Могут ли два номера одной WABA направлять события на разные эндпоинты?
Нет. Переопределение действует на аккаунт, поэтому все его номера доставляют события в один и тот же адрес.
Переносятся ли шаблоны между аккаунтами?
Нет. Они принадлежат аккаунту, в котором были созданы.
Что происходит с переопределением при удалении номера?
Если приложение удаляется из аккаунта, переопределение удаляется вместе с ним. Повторное подключение восстанавливает отправку сообщений, но не адрес назначения.
Есть ли ограничение на число шаблонов?
Meta ограничивает число шаблонов для аккаунта. При превышении лимита возвращается отдельный код ошибки.
Читайте дальше
Готовы начать?
Настройте WhatsApp Coexistence за несколько минут, а не месяцев. Приложение продолжит работать на телефоне.
Начать бесплатный пробный периодПроверено по состоянию на