Как перенести номер WhatsApp API к другому провайдеру без потери номера и шаблонов

Обычно вы можете перенести подходящий номер WhatsApp Business Platform от одного провайдера к другому, сохранив номер и важные атрибуты учетной записи, но не следует предполагать, что каждый шаблон, сообщение или рабочий процесс будет перенесен. Безопасная миграция включает проверку владения Meta Business, готовности WABA назначения, утверждения отображаемого имени, требований к оплате и региону данных, доступа к номеру, двухэтапной проверки, квалифицирующих шаблонов, Webhooks, учетных данных приложений, резервного копирования истории и проверки после переноса перед отменой старого сервиса.

Поймите, что именно переносится

Миграция провайдера WhatsApp обычно изменяет провайдера или платформу, через которую подключается и управляется номер телефона. Это не перенос всего вашего приложения для обслуживания клиентов или маркетинга.

Разделите проект на три уровня:

1. Уровень учетной записи Meta: Портфолио Meta Business, аккаунт WhatsApp Business (WABA), номер телефона, отображаемое имя, рейтинг качества, лимит сообщений, статус Official Business Account, где применимо, и шаблоны сообщений.
2. Уровень подключения провайдера: отношения по подключению, учетные данные, конечные точки сообщений, конфигурация Webhooks, выставление счетов, логи и объекты, специфичные для провайдера.
3. Уровень бизнес-приложения: История входящих, назначения, заметки, поля контактов, записи согласия, сегменты, кампании, автоматизации, знания ИИ, интеграции, отчеты и внутренние идентификаторы сообщений.

Документация провайдеров от YCloud, Twilio, 360dialog и respond.io указывает, что важные атрибуты номера и квалифицирующие шаблоны могут быть сохранены или продублированы в поддерживаемых миграциях. Она также показывает, почему общие гарантии небезопасны: низкокачественные, отклоненные, ожидающие или иным образом не подходящие шаблоны могут не переноситься; качество шаблонов может быть сброшено или пересмотрено; исторические беседы и объекты рабочих процессов, специфичные для провайдера, могут следовать разным правилам.

Что обычно можно сохранить

Текущая документация провайдеров в целом идентифицирует следующее как сохраняемое в подходящей миграции от провайдера к провайдеру:

• номер телефона;
• утвержденное отображаемое имя;
• рейтинг качества номера телефона;
• уровень лимита сообщений;
• статус Official Business Account, если он есть у аккаунта; и
• квалифицирующие утвержденные шаблоны.

Точные правила различаются. Twilio говорит, что Meta дублирует высококачественные шаблоны в WABA назначения и пересматривает их снова; некоторые могут быть отклонены, а качество дублированных шаблонов начинается как неизвестное. YCloud утверждает, что утвержденные шаблоны среднего/высокого качества синхронизируются, тогда как низкокачественные или непригодные шаблоны не синхронизируются, и качество шаблонов начинается заново. Respond.io аналогично исключает низкокачественные, отклоненные или ожидающие шаблоны.

Рассматривайте эти источники как руководство для конкретного назначения, а не универсальное обещание. Попросите выбранного провайдера подтвердить текущие правила для вашего исходного WABA, WABA назначения, бизнес-портфолио и пути миграции в письменной форме.

Что обычно не переносится автоматически

Не предполагайте, что следующее будет перенесено с номером:

• историческое содержание бесед, хранящееся у старого провайдера;
• Назначения входящих, внутренние комментарии, теги или статус кейсов;
• записи контактов провайдера и пользовательские атрибуты;
• определения кампаний и аналитика прошлых кампаний;
• конфигурация рабочих процессов, ботов, Journeys или агентов ИИ;
• CRM-сопоставления и интеграции электронной коммерции;
• учетные данные API, URL-адреса конечных точек или секреты Webhooks;
• идентификаторы сообщений провайдера и история логов; или
• план, баланс, кредиты и договоренности о поддержке.

Руководство по миграции номеров YCloud явно говорит, что исторические записи чатов не переносятся, и рекомендует их резервировать у исходного провайдера. Respond.io описывает защиту своих существующих Workflows и Broadcasts при переносе уже подключенного канала на предложение провайдера respond.io; это не следует обобщать на произвольные рабочие процессы, хранящиеся в системе другого вендора.

Создайте инвентаризацию по артефактам и назначьте владельца для экспорта, восстановления, проверки или намеренного отказа от каждого элемента.

Шаг 1: Зафиксируйте объем и выберите окно изменений

Задокументируйте исходные и целевые аккаунты, идентификаторы WABA, Meta Business Portfolio, номер телефона, отображаемое имя, регион данных, активные шаблоны, приложения для отправки и вебхуков, операционные зависимости и ответственных лиц.

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

Шаг 2: Подтвердите готовность бизнеса и WABA

Руководства по миграции провайдеров обычно требуют исправной и правильно настроенной системы. Убедитесь, что Business Portfolio и исходный WABA активны и доступны, целевой WABA готов, платежи или счета соответствуют требованиям, отображаемое имя утверждено без ожидающих изменений, регионы данных совместимы (где это важно), администраторы имеют доступ к WhatsApp Manager, и в целевом WABA есть место для номера.

В текущем руководстве Twilio указано, что исходный WABA и новый целевой WABA должны использовать один и тот же регион локализации данных во время регистрации. YCloud описывает переход между WABA в рамках одного аккаунта Business Manager. Поскольку процессы onboarding различаются, следуйте актуальным инструкциям целевого провайдера, а не копируйте шаги другого вендора.

Шаг 3: Обеспечьте доступ к номеру телефона

Процесс миграции обычно требует верификации номера с помощью SMS или голосового одноразового пароля. Убедитесь, что ваша команда сможет его получить до начала изменения, включая виртуальные номера или номера за IVR.

Зафиксируйте, кто контролирует номер, кто может получить код, работают ли международные SMS или звонки, настройки IVR и запасной метод. Не повторяйте попытки без понимания причины сбоя.

Шаг 4: Отключите двухэтапную проверку в нужное время

Инструкции по миграции YCloud, Twilio, 360dialog и respond.io указывают на отключение двухэтапной проверки WhatsApp для номера как на подготовительный шаг. Если ваша команда не может изменить это напрямую, может потребоваться помощь текущего провайдера или администратора аккаунта Meta.

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

Шаг 5: Создайте резервные копии шаблонов и оцените их риски

Экспортируйте или запишите каждый шаблон, используемый вашими приложениями, включая:

• название и язык шаблона;
• категорию;
• компоненты, переменные, медиа и кнопки;
• текущий статус утверждения и качества;
• владельца бизнеса и сценарий использования;
• код приложения или workflow, который его вызывает; и
• объем отправки и критичность.

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

После перехода сравните список шаблонов в целевом WABA с инвентаризацией. Twilio предупреждает, что дублированные шаблоны проходят проверку, и некоторые могут быть отклонены. Идентификаторы шаблонов также могут измениться, поэтому обновите маппинги в приложениях, а не рассчитывайте на работу старых идентификаторов.

Шаг 6: Экспортируйте бизнес-уровень приложений

Сохраните записи, необходимые для операций и соответствия: контакты и согласия, списки исключений, открытые кейсы, атрибуты клиентов, разрешенную историю, записи кампаний, логику автоматизации, конфигурацию ИИ, интеграции и базовые отчеты. Проверьте формат, полноту, временные метки, идентификаторы, шифрование и хранение. CSV с контактами — это не полная резервная копия, если workflow зависят от контекста сообщений или кейсов.

Шаг 7: Подготовьте цель перед переходом

Прежде чем трогать рабочий номер, подготовьте пользователей, роли, схему контактов, маршрутизацию Inbox, утвержденную автоматизацию, системные маппинги, аутентифицированный приемник вебхуков, мониторинг, безопасно хранимые учетные данные и тестовый план для каждого критического пути сообщений.

Если целевая платформа — YCloud, это может включать настройку Inbox, Contact, Campaign, Journey, Chatbot, AI Agent и API/Webhook соединений в соответствии с используемыми частями. Если целевая платформа API-centric, подготовьте свои операционные системы и слой интеграций.

Шаг 8: Выполните миграцию по инструкциям провайдера

Следуйте актуальному встроенному процессу регистрации или миграции целевого провайдера. Обычно процесс включает выбор существующего Meta Business Portfolio, использование или создание нужного целевого WABA, ввод существующего номера телефона и его проверку с помощью одноразового пароля.

Не импровизируйте с шагами из старой статьи. Требования к миграции меняются, и целевой провайдер отвечает за свой текущий процесс onboarding.

Шаг 9: Переподключите API, вебхуки и маппинги сообщений

Успешный перенос номера не переподключает ваше приложение автоматически. Обновите URL или SDK, учетные данные и scope, идентификаторы отправителя/WABA/шаблонов, верификацию вебхуков, обработку событий, логику повторов и идемпотентности, целевые системы и пороги мониторинга.

Прекратите отправку через старую интеграцию после перехода, но сохраните доступ только для чтения к историческим логам, пока правила хранения и контракт позволяют.

Шаг 10: Проведите многоуровневую проверку

Сначала проверьте номер и отображаемое имя, затем подходящие шаблоны, доставку исходящих сообщений и статусные события, входящие вебхуки и доставку в Inbox, ответ агента, одну утвержденную автоматизацию, управление согласиями/исключениями и сверку с CRM/отчетами.

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

Шаг 11: Стабилизируйте, затем отмените старый сервис

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

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

Выберите направление, соответствующее операционной модели

Миграция — хорошее время, чтобы решить, нужен ли вам только API-доступ или полный операционный уровень WhatsApp. Команды разработчиков с существующими системами могут предпочесть Twilio или API-провайдера, ориентированного на WhatsApp, такого как 360dialog. Командам, которым нужна поддержка, маркетинг, автоматизация, данные клиентов, ИИ и интеграции вместе, следует рассмотреть YCloud. Команды, работающие с многоканальными переписками, также могут оценить respond.io или аналогичные платформы.

Используйте короткий список API-провайдеров WhatsApp и руководство по выбору BSP перед выбором направления. Самая безопасная миграция начинается с соответствия покупателя, четкого владения и проверенного пути выхода, а не с последующего переноса номера.

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

Могу ли я сохранить свой номер WhatsApp при смене провайдера?

Соответствующий требованиям номер WhatsApp Business Platform обычно можно перенести, при условии соблюдения требований Meta и провайдера. Подтвердите право собственности на бизнес, готовность WABA, статус отображаемого имени, доступ к номеру, условия оплаты или выставления счетов, двухэтапную проверку и соответствие требованиям назначения.

Будут ли все мои шаблоны WhatsApp перенесены к новому провайдеру?

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

Переносится ли история чатов WhatsApp с номером?

Перенос номера от провайдера к провайдеру не следует рассматривать как перенос истории чатов. YCloud прямо заявляет, что исторические записи чатов не переносятся в рамках его процесса миграции номеров. Экспортируйте разрешенную историю отдельно и проверьте варианты импорта на месте назначения.

Гарантирована ли миграция провайдера WhatsApp без простоев?

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

Когда мне следует отменить старого провайдера?

Обычно после того, как номер назначения, шаблоны, API, веб-хуки, входящие сообщения и критически важные рабочие процессы прошли проверку, если только инструкции провайдера не требуют иного. Также оплатите счета, экспортируйте необходимые данные и подтвердите отмену, чтобы избежать дальнейшего выставления счетов.