Перенос номера меняет не только запись в интерфейсе. В цепочке участвуют business account, WhatsApp Business Account, phone number ID, приложение Meta, системный пользователь, токен и подписка webhook. Если хотя бы один элемент остался привязан к старому контуру, входящие сообщения уходят не туда или не обрабатываются.

Не начинайте с повторной верификации номера и не передавайте коды подтверждения подрядчику в чате. Сначала выпишите идентификаторы старого и нового контура и проследите одно тестовое событие от платформы до вашего endpoint.

Маршрут входящего сообщения после миграции

  1. Пользователь отправляет сообщение на номер.
  2. Платформа связывает номер с актуальным phone number ID и WABA.
  3. Нужное приложение подписано на события этой WABA.
  4. Webhook доставляется на текущий callback URL и проходит verification/подпись.
  5. Ваш обработчик распознаёт новый ID, сохраняет событие один раз и передаёт его в диалог.

Проверяйте каждый переход отдельно. Статус номера «Connected» подтверждает не всю цепочку, а только часть. Успешная исходящая отправка также не доказывает, что webhook подписан правильно.

Таблица идентификаторов быстро находит старую привязку

ОбъектСтарое значениеНовое значениеГде используется
WABA IDзафиксироватьзафиксироватьподписка приложения и управление номером
Phone number IDзафиксироватьзафиксироватьAPI URL и входящий payload
App IDзафиксироватьзафиксироватьwebhook subscription
Token ownerстарый system userактуальный system userправа API

Не включайте access token в такую таблицу. Нужны только владелец, срок, scopes и последние четыре символа для различения секретов.

Если webhook не появляется вообще

  • Проверьте, подписано ли приложение на новую WABA, а не только настроен ли callback URL.
  • Убедитесь, что endpoint публично доступен по HTTPS и отвечает в допустимое время.
  • Сопоставьте delivery log платформы с access-log по времени и request ID.
  • Проверьте, не фильтрует ли WAF запросы после смены адресов или payload.
  • Уточните текущую официальную процедуру миграции для вашего варианта подключения.

Если webhook пришёл, но диалога нет

Сохраните минимальный сырой event в защищённом журнале на короткий срок и сравните phone number ID с routing table. Частая ошибка — обработчик признаёт только старый ID и тихо отбрасывает новое событие. Другая — уникальный ключ сообщения пересекается между контурами или consumer читает не ту очередь.

Повторная доставка webhook нормальна для устойчивой интеграции, поэтому обработчик должен быть идемпотентным. Но нельзя отвечать `200 OK` до надёжного сохранения события, если после этого его уже невозможно восстановить.

Контрольный прогон без сообщений клиентов

  1. Отправить тестовое входящее сообщение с разрешённого номера.
  2. Найти событие в delivery log и на endpoint.
  3. Проверить WABA ID, phone number ID и message ID.
  4. Убедиться, что диалог создан один раз и оператор видит правильный номер.
  5. Отправить тестовый ответ и проверить статус доставки.

Для технического разбора нужны маскированные ID, время теста, HTTP-статус webhook и схема маршрутизации. Токены, PIN двухэтапной проверки и verification code отправлять нельзя.

Проверенные источники