ВойтиНачать бесплатный пробный период
Meta Tech Provider

Смена номера телефона в подключении Coexistence

Подключение Coexistence привязано к одному номеру телефона. Когда бизнес меняет номер в приложении WhatsApp Business, Meta отключает подключение с причиной CHANGE_NUMBER. Новый номер является отдельным бизнес-номером на платформе, и его нужно подключить через процесс Coexistence как новое подключение.

CHANGE_NUMBER

Причина отключения, которую Meta сообщает, когда бизнес сменил номер телефона.

2 numbers

Начальный лимит зарегистрированных бизнес-номеров для нового Business Portfolio, позднее увеличивается до 20.

30 days

Номер, с которого за этот период отправлялись платные сообщения, нельзя удалить с платформы.

Что происходит с подключением при смене номера?

Оно завершается. Meta относит смену номера телефона к причинам отключения подключения Coexistence и сообщает об этом в поле disconnection_info вебхука account_update с причиной CHANGE_NUMBER.

Это не строгость, а последовательность платформы. Всё, что известно на стороне API, привязано к бизнес-номеру: его phone number ID, отображаемое имя, рейтинг качества и подписки на вебхуки. Другой номер является другим активом, поэтому ничто из связанного со старым номером не переносится само, а старое подключение перестаёт работать в момент смены.

Как подключить новый номер?

Как первое подключение. Новый номер должен соответствовать тем же условиям, что и любой номер, подключаемый к Coexistence, а затем пройти процесс подключения с самого начала. Ничего из старого подключения не используется повторно, поэтому переход удобно рассматривать как небольшой проект с датой.

  • Номер активен в приложении WhatsApp Business версии 2.24.17 или новее.
  • Номер находится в Business Portfolio, которым вы управляете.
  • Номер не привязан к другому провайдеру.
  • Отображаемое имя указывается при регистрации, как и для любого бизнес-номера.

Что нужно обновить на стороне API?

Все места, где хранится старый номер или его ID. Интеграции, которые отправляют сообщения через Cloud API, обращаются к phone number ID, поэтому CRM, автоматизация или ИИ-агент, всё ещё указывающие на старый ID, будут выдавать ошибки, а не переключатся сами.

Новое подключение снова задаёт собственные вопросы при подключении, в том числе о передаче истории чатов и 24 часах на её синхронизацию. Адрес вебхука, заданный для старого подключения, нужно применить к новому. Стоит проверить и ёмкость Business Portfolio: Meta ограничивает новый Business Portfolio двумя зарегистрированными бизнес-номерами, пока он не пройдёт верификацию или не достигнет лимита 2 000 сообщений.

Что происходит со старым номером на платформе?

Он остаётся активом в WhatsApp Business Account, пока кто-то его не удалит. Meta разрешает удалять бизнес-номера только администраторам Business Portfolio и отказывает в удалении номера, с которого за последние 30 дней отправлялись платные сообщения.

Удаление остаётся необязательной уборкой, а не условием для подключения нового номера. Но устаревшие номера в аккаунте облегчают системе задачу продолжать обращаться не к тому номеру. Если удалить его после того, как пройдут 30 дней, аккаунт останется понятным.

Распространённые ошибки

  • Смена номера в приложении до того, как спланировано повторное подключение. Старое подключение завершается в этот момент.
  • Старый phone number ID остаётся в интеграциях. Отправка завершается ошибкой, а не переходит на новый номер.
  • Попытка удалить старый номер сразу после переключения. Meta блокирует удаление, если с номера отправлялись платные сообщения за 30 дней.
Настройка с EasyCoexistence

EasyCoexistence показывает отключение CHANGE_NUMBER на временной шкале подключения в том виде, в каком его сообщает Meta, а новый номер подключается через тот же самостоятельный Embedded Signup примерно за две минуты.

Часто задаваемые вопросы

Переходит ли подключение на мой новый номер?

Нет. Meta отключает его с причиной CHANGE_NUMBER, а новый номер подключается как новое подключение.

Нужен ли новый phone number ID?

Да. Новый номер является отдельным бизнес-номером на платформе с собственным ID.

Можно ли сразу удалить старый номер?

Только если с него не отправлялись платные сообщения за последние 30 дней, и удалить его может только администратор Business Portfolio.

Нужно ли снова выбирать отображаемое имя?

Да. Meta требует данные об отображаемом имени при регистрации бизнес-номера.

Читайте дальше

How to disconnect Coexistence and go back to the app onlyTurning Coexistence off from the WhatsApp Business app, what the API side receives, why the Deregister endpoint refuses, and how to connect again later.Linked devices and Coexistence: what gets unlinkedCoexistence onboarding unlinks every companion device. Which ones can be linked again, which two are unsupported, and the inactivity rules for each.Display names on a WhatsApp business numberThe name customers see above a conversation. How approval works, what gets rejected, and which webhook reports the decision.Which numbers are eligible for CoexistenceThe app version, the account type, the portfolio access, and what actually makes Meta refuse a number during Coexistence onboarding.Connecting a number, step by stepWhat happens when you connect a number through Coexistence, what the business owner has to do, and what is decided once and cannot be changed.The account_update webhook, and every disconnection reasonaccount_update reports connection state changes. The full list of disconnection reasons Meta sends, what each means, and which ones are recoverable.

Готовы начать?

Настройте WhatsApp Coexistence за несколько минут, а не месяцев. Приложение продолжит работать на телефоне.

Начать бесплатный пробный период

Проверено по состоянию на

Смена номера в подключении Coexistence