Преимущества перехода на WhatsApp Cloud API
WhatsApp Cloud API — это новая платформа, которая предлагает компаниям прямое подключение к инфраструктуре WhatsApp'и возможность самостоятельного обслуживания по сравнению с обращением к партнерам WhatsApp (BSP). Некоторые преимущества использования WhatsApp Cloud API:
более экономичный вариант.
более надежное и стабильное соединение с платформой.
возможность создания индивидуальных интеграций, соответствующих конкретным потребностям вашего бизнеса.
гибкое и масштабируемое решение для предприятий любого размера.
Узнайте больше о WhatsApp Cloud API здесь.
Что будет перенесено?
Обратите внимание, что следующие элементы можно перенести из WhatsApp BSP в WhatsApp Cloud API.
Может быть перенесен
Номер телефона, привязанный к аккаунту.
Любые ранее одобренные шаблоны сообщений высокого качества.
Отображаемое имя номера телефона.
Оценка качества телефонного номера.
Ограничения на отправку сообщений.
Официальный статус WABA.
Невозможно перенести
Шаблоны сообщений низкого качества, отклоненные или ожидающие рассмотрения.
Требования перед миграцией: что подготовить для настройки миграции
Обратите внимание на фразы, которые будут часто использоваться в этом документе:
- Источник WABA: WhatsApp BSP, с которого мы переходим.
-Место назначения WABA: API WhatsApp Cloud, на который мы переходим.
Контрольный список требований перед миграцией:
Существующее приложение Meta Developer: Если у вас нет созданного приложения разработчика, нажмите здесь, чтобы создать свое приложение в Meta Business Manager (MBM) и начать работу с WhatsApp Cloud API. Это приложение должно быть создано под тем же бизнес-аккаунтом (бизнес-идентификатором), что и исходный WABA.
Идентификатор компании: Исходные и конечные WABA должны быть связаны с одним и тем же MBM или иметь один и тот же идентификатор компании.
Проверка бизнеса: Необходимо подтвердить идентификатор бизнеса. Если ваш бизнес еще не подтвержден, выполните следующие действия, чтобы подтвердить его.
Статус проверки WABA: Статус проверки исходных и целевых WABA должен быть одобрен.
Оплата Метод: Метод оплаты должен быть настроен как для исходного, так и для целевого WABA. Убедитесь, что способ оплаты настроен как в пункте отправления, так и в пункте назначения.
Двухэтапная аутентификация: Двухэтапная аутентификация должна быть отключена на переносимом номере телефона.
После проверки и выполнения всех вышеперечисленных действий процесс миграции можно продолжить.
Настройка телефонных номеров и идентификаторов WABA
Компания Meta разработала идентификаторы WABA таким образом, чтобы их нельзя было переносить. В связи с определенными ограничениями в качестве решения был реализован обходной путь. Для переноса телефонных номеров исходные и конечные идентификаторы WABA должны относиться к одной и той же учетной записи Meta Business Manager. Это означает, что миграция номера телефона приведет только к переносу этого номера между WABA и не позволит вносить какие-либо другие изменения. Для успешного переноса номера телефона необходимо выполнить следующие шаги:
Добавьте новый номер в целевой WABA: Это сгенерирует новый идентификатор WABA для номера, на который вы хотите перейти. Вы можете пропустить этот шаг, если у вас уже есть WABA с номером, который больше не используется.
Узнайте больше о подключении телефонных номеров к WhatsApp Cloud API здесь.
Удалить новый номер из целевого WABA: Это освободит место для номера, который будет добавлен в целевой WABA. Либо, если у вас есть неиспользуемый номер, вы можете удалить его.
После удаления номера приступайте к переносу текущего номера клиента'в новый бизнес WhatsApp.
Документация API для процесса миграции
Важно отметить, что в настоящее время эти шаги миграции, описанные в документации API, могут быть выполнены только разработчиком или лицом с аналогичным техническим опытом. Однако мы понимаем, что для некоторых это может стать ограничением, и работаем над разработкой более удобного и доступного решения в будущем. Нужна помощь? Свяжитесь с намиздесь!
Шаг 1: Начните миграцию номера телефона
URL-адрес обратного вызова:
ПОСТ <https://graph.facebook.com/{version}/{wabaId}/phone\_numbers>
Имя | В | Необходимый | Тип | Описание |
|---|---|---|---|---|
версия | путь | Истинный | нить | Версия API. |
вабаид | путь | Истинный | нить | Идентификатор WABA API WhatsApp Cloud. |
Перейдите в Business Manager > Business Settings > Accounts > WhatsApp Business Accounts , чтобы найти идентификатор WhatsApp Business Account. Выберите учетную запись, которую вы хотите использовать. Появится панель с информацией об учетной записи, включая идентификатор.
Параметры
Заголовок
Авторизация: Предъявитель {Access Token}
Пользователь системы генерирует ваш токен доступа на вкладке «Учетные записи WhatsApp Business» в Business Manager. Прочитайте это руководство , чтобы узнать, как получить доступ к системному пользователю и создать или скопировать его.
Тело
Имя | Тип | Описание |
|---|---|---|
копий | число | Числовой код страны для регистрируемого номера телефона. Примечание: знак плюс (+) для кода страны не нужен. |
номер телефона | число | Номер телефона, который переносится, без кода страны или символа плюс (+). |
перенести_номер_телефона | булев | Установите значение true, чтобы перенести номер телефона. |
Статус
Имя | Описание |
|---|---|
200 ОК | Успех. |
Ответ
{
"id": "phoneNumberId"
}
Шаг 2: Запрос кода (PIN-кода) для подтверждения права собственности на телефон
URL-адрес обратного вызова
ПОСТ <https://graph.facebook.com/{version}/{phoneNumberId}/request\_code>
Имя | В | Необходимый | Тип | Описание |
|---|---|---|---|---|
версия | путь | Истинный | нить | Версия API. |
НомерТелефонаId | путь | Истинный | нить | Это ответ, возвращенный на шаге 1. Скопируйте и вставьте номер в URL-адрес обратного вызова на этом шаге. |
Параметры
Заголовок
Авторизация: Предъявитель {Access Token}
Тело
Имя | Тип | Описание |
|---|---|---|
код_метод | перечисление | Способ получения регистрационного кода. Поддерживаемые значения: SMS и голос. |
язык | перечисление | Язык, на котором вы хотите получить регистрационный код. См. коды языков. |
Статус
Имя | Описание |
|---|---|
200 ОК | Успех. |
Ответ
{
"успех": правда
}
Код был отправлен на номер телефона, который будет перенесен выбранным способом (SMS или голосом).
Шаг 3: Проверьте код
URL-адрес обратного вызова
ПОСТ: <https://graph.facebook.com/{version}/{phoneNumberId}/verify\_code>
Код (6-значный PIN-код), полученный на номер телефона на шаге 2, будет использоваться для подтверждения права собственности.
Параметры
Заголовок
Авторизация: Токен доступа {Access Token}.
Тело
Имя | Тип | Описание |
|---|---|---|
код | число | 6-значный регистрационный код, полученный после завершения Шага 2. |
Статус
Имя | Описание |
|---|---|
200 ОК | Успех. |
Ответ
{
"успех": правда
}
Подтверждает, что право собственности на телефон было подтверждено.
Шаг 4: Зарегистрируйте номер телефона
URL-адрес обратного вызова
ПОСТ <https://graph.facebook.com/{version}/{phoneNumberId}/register>
Параметры
Заголовок
Авторизация: Токен доступа {Access Token}.
Тело
Имя | Тип | Описание |
|---|---|---|
сообщение_продукт | перечисление | Использована служба обмена сообщениями. В этом случае используйте "whatsapp". |
PIN | число | 6-значный регистрационный код, полученный после Шага 2. |
Статус
Имя | Описание |
|---|---|
200 ОК | Успех. |
Ответ
{
"успех": правда
}
Номер телефона успешно зарегистрирован в WhatsApp Cloud API WABA. Теперь вы можете отправлять сообщения в пункт назначения WABA.
Идентификатор WABA не переносится. Новый перенесенный номер будет связан с идентификатором WABA ранее удаленного номера.
Шаг 5: Проверьте перенесенный номер телефона в приложении Meta Developer
Успешность миграции можно проверить с помощью приложения Meta Developer. Для этого выполните следующие действия:
Перейдите к WhatsApp > Начало работы
В раскрывающемся списке номеров телефонов убедитесь, что номер присутствует и отображается правильно.
