Перенос номеров телефонов между аккаунтами WhatsApp Business с помощью регистрации на сайте поставщика
В этом документе рассказывается, как перенести номера телефонов компании из одного аккаунта WhatsApp Business в другой с помощью регистрации на сайте поставщика.
Клиенты могут переносить номера телефонов своих компаний между аккаунтами WhatsApp Business, сохраняя их отображаемые имена, показатели качества, ограничения на отправку сообщений с шаблонами, статусы официального бизнес-аккаунта и утвержденные шаблоны высокого качества. Обычно перенос выполняется, если клиент хочет перенести номера телефонов своей компании от одного партнера по решениям к другому.
Вы можете выполнить перенос для клиента двумя способами: с помощью регистрации на сайте поставщика или программным путем.
Перенос с помощью регистрации на сайте поставщика проще. Это предпочтительное решение, потому что такой перенос могут инициировать клиенты, при этом автоматически генерируются и предоставляются права владения на все необходимые объекты, вашему приложению предоставляется доступ к этим объектам и используется меньше вызовов API.
Перенос программным путем должен инициироваться вами и подразумевает больше вызовов API, поскольку вам нужно будет подтвердить, что зависимые объекты сконфигурированы правильно, самостоятельно сгенерировать новые необходимые объекты и связать их с другими объектами. Поэтому перенос программным путем рекомендуется, только если вы будете работать с клиентом по модели "от его лица" (т. е. вы создадите целевой аккаунт WhatsApp Business и его объекты, будете их владельцем и поделитесь ими с клиентом).
Если вы хотите перенести номера телефонов клиента программным путем, ознакомьтесь с этим документом.
Принцип работы
Клиенты могут начать процесс переноса с помощью вашей реализации регистрации на сайте поставщика (версия 2). При регистрации на сайте поставщика у клиента запрашивается номер телефона его компании и новый целевой аккаунт WhatsApp Business.
Когда клиент завершит этот процесс, будет сгенерирован новый аккаунт WhatsApp Business, который будет связан с его бизнес-аккаунтом Meta. Ваше приложение получит права доступа к этому аккаунту, после чего будет возвращен ID этого аккаунта WhatsApp Business и ID номера телефона компании.
Эти ID необходимо сохранить и использовать их в вызовах API, чтобы поделиться своей кредитной линией, подписаться на Webhooks и зарегистрировать номер телефона для использования с облачным API. Как только вы пройдете финальный шаг (регистрацию), номер телефона компании будет связан с целевым аккаунтом WhatsApp Business и его вновь можно будет использовать для отправки и получения сообщений.
Поскольку номер телефона компании клиента не меняется, его отображаемое имя, показатель качества, ограничение на число сообщений и статус официального бизнес-аккаунта сохранятся.
Кроме того, все допустимые шаблоны автоматически дублируются в целевом аккаунте WhatsApp Business и получают те же статусы, что и их исходные версии, и все медиафайлы, загруженные для номера телефона компании клиента, можно будет продолжать использовать.
Аккаунты WhatsApp Business
При регистрации на сайте поставщика для клиента автоматически генерируется новый аккаунт WhatsApp Business, который связывается с его бизнес-аккаунтом Meta, и ваше приложение получает доступ к этому аккаунту WhatsApp Business.
Шаблоны
Шаблоны автоматически дублируются в целевой аккаунт WhatsApp Business и получают те же показатели качества и статусы, которые они имели в исходном аккаунте.
Дублируются только шаблоны, которые имеют statusAPPROVED и quality_scoreGREEN. Если в конечном аккаунте WhatsApp Business невозможно разместить все новые шаблоны, будет продублировано максимально возможное количество шаблонов, которое допускается в соответствии с ограничением количества шаблонов сообщений, установленным для конечного аккаунта WhatsApp Business. Если шаблоны сообщений, которые не были продублированы, планируется использовать в новом аккаунте WhatsApp Business, их необходимо создать повторно и отправить на проверку.
Биллинг
Плата за сообщения, отправленные до завершения переноса, взимается со старого поставщика решений. Если недоставленные сообщения, отправленные до завершения переноса, будут доставлены после ее завершения, плата за них взимается со старого поставщика решений.
Плата за сообщения, отправленные после завершения переноса, взимается с нового поставщика решений.
Время простоя
Время простоя не начинается, пока вы не выполните последний этап (регистрацию). До этого номер телефона компании можно использовать для отправки и получения сообщений без перебоев.
После выполнения последнего шага (регистрации) начинается время простоя, которое продлится, пока мы не завершим дублирование шаблонов.
После этого номер телефона компании вновь можно использовать для отправки и получения сообщений, которые будут связаны с новым аккаунтом WhatsApp Business клиента.
Ограничения числа обращений
Дублирование шаблонов запускается автоматически в рамках процесса переноса и не учитывается в ограничении числа обращений. Выполняемые вами вызовы API учитываются.
Ограничения
- Тестовые номера телефонов, которые компании получили от WhatsApp, не переносятся.
- Перенесенные номера телефонов компаний можно регистрировать только для использования с облачным API.
- История сообщений и загруженные медиафайлы не переносятся, если исходный аккаунт WhatsApp Business использует локальный API.
- Номера телефонов компаний должны иметь одобренное отображаемое имя (
name_statusимеет значениеAPPROVED). - С номерами телефонов компаний не должно быть связано никаких ожидающих подтверждения запросов на изменение имени.
Требования
Клиенты
Узнайте у клиента, которому принадлежит номер телефона, удовлетворяет ли он перечисленным далее требованиям. Если он владеет своим аккаунтом WhatsApp Business, он может сделать это в Meta Business Manager. Для этого нужно перейти в Аккаунты WhatsApp > (имя их аккаунта WhatsApp Business) > Настройки. Если клиент не владеет своим аккаунтом WhatsApp Business, он должен попросить своего поставщика бизнес-решений проверить эту информацию.
- Его бизнес-аккаунт Meta должен быть подтвержден.
- Существующий аккаунт WhatsApp Business должен быть подтвержден.
- С существующим аккаунтом WhatsApp Business должен быть связан действительный способ оплаты (в настройках платежей).
- Для номера телефона компании должна быть отключена двухшаговая проверка. Клиенты, которые владеют своими аккаунтами WhatsApp Business, могут отключить двухшаговую проверку для своего номера в WhatsApp Manager. В противном случае им нужно будет попросить поставщика решений сделать это.
Поставщики решений
По меньшей мере одно приложение уже должно быть подписано на Webhooks целевого аккаунта WhatsApp Business (см. раздел Webhooks), и вы должны использовать регистрацию на сайте поставщика версии 2 с включенной регистрацией сеансов.
Этапы переноса
Этап 1. Попросите клиента отключить двухшаговую проверку
Если вы ещё этого не сделали, попросите клиента перейти в WhatsApp Manager и отключить двухшаговую проверку для номера телефона его компании (или попросить своего текущего поставщика решений сделать это).
Вы не сможете пройти дальнейшие этапы, пока двухшаговая проверка не будет отключена.
Этап 2. Регистрация на сайте поставщика
Попросите клиента перейти к вашей реализации регистрации на сайте поставщика (версия 2) и в ответ на запрос указать номер телефона его компании и отображаемое имя.
Этап 3. Получение ID объектов
Когда клиент завершит процесс, получите ID номера телефона компании и нового аккаунта WhatsApp Business, возвращенные в полезных данных.
Этап 4. Поделитесь своей кредитной линией
Поделитесь с этим аккаунтом WhatsApp Business своей кредитной линией, как вы это обычно делаете после подключения клиента в процессе регистрации на сайте поставщика.
Этап 5. Подпишитесь на Webhooks
Подпишите свое приложение на Webhooks в новом аккаунте WhatsApp Business клиента.
Этап 6. Зарегистрируйте номер телефона для использования облачного API
Зарегистрируйте номер телефона компании для использования облачного API (зарегистрировать перенесенный номер телефона компании для использования локального API невозможно).