Перенос номера меняет не только запись в интерфейсе. В цепочке участвуют business account, WhatsApp Business Account, phone number ID, приложение Meta, системный пользователь, токен и подписка webhook. Если хотя бы один элемент остался привязан к старому контуру, входящие сообщения уходят не туда или не обрабатываются.
Не начинайте с повторной верификации номера и не передавайте коды подтверждения подрядчику в чате. Сначала выпишите идентификаторы старого и нового контура и проследите одно тестовое событие от платформы до вашего endpoint.
Маршрут входящего сообщения после миграции
- Пользователь отправляет сообщение на номер.
- Платформа связывает номер с актуальным phone number ID и WABA.
- Нужное приложение подписано на события этой WABA.
- Webhook доставляется на текущий callback URL и проходит verification/подпись.
- Ваш обработчик распознаёт новый 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` до надёжного сохранения события, если после этого его уже невозможно восстановить.
Контрольный прогон без сообщений клиентов
- Отправить тестовое входящее сообщение с разрешённого номера.
- Найти событие в delivery log и на endpoint.
- Проверить WABA ID, phone number ID и message ID.
- Убедиться, что диалог создан один раз и оператор видит правильный номер.
- Отправить тестовый ответ и проверить статус доставки.
Для технического разбора нужны маскированные ID, время теста, HTTP-статус webhook и схема маршрутизации. Токены, PIN двухэтапной проверки и verification code отправлять нельзя.