Выберите способ подключения вашего номера
Выберите один из трех путей в зависимости от того, где сейчас зарегистрирован номер. «Новый» означает в настоящее время не зарегистрирован в WhatsApp, а не обязательно только что купленную SIM-карту.1. Зарегистрировать новый номер
Убедитесь, что вы контролируете номер и можете получить код подтверждения по SMS или голосовому звонку. Завершите процесс подключения YCloud, выберите нужный бизнес-портфель и WABA, а затем зарегистрируйте номер. Вам не требуется предварительно создавать аккаунт в WhatsApp Messenger или приложении WhatsApp Business. Если WABA уже подключен к YCloud, используйте Add numbers.2. Перенести существующий номер API от другого BSP
Используйте процедуру миграции провайдера, а не удаление аккаунта приложения. Перед началом проверьте бизнес-портфель владельца, исходный и целевой WABA, доступ к номеру и предварительные требования миграции у текущего провайдера и в YCloud. Спланируйте переключение отправки сообщений, шаблонов, Webhook и зависимых автоматизаций. Не рассчитывайте на то, что Inbox, контакты, данные кампаний или история переписок предыдущего провайдера будут скопированы в YCloud. Экспортируйте необходимые данные до прекращения доступа к старому провайдеру. В руководстве по миграции номеров описаны шаги подготовки и действия в YCloud. «Миграция аккаунта API» — распространенное сокращение; переносимым ресурсом является сам номер, а не все рабочее пространство вашего провайдера.3. Полный перенос номера из приложения на Platform
Этот путь предназначен для номера, который вы больше не планируете использовать в WhatsApp Messenger или приложении WhatsApp Business.- Убедитесь, что вы хотите прекратить использование аккаунта приложения на этом номере и что все условия для подключения YCloud выполнены.
- Сохраните нужные данные вне приложения. Не полагайтесь на облачную резервную копию чатов для последующего импорта на Platform.
- На основном телефоне откройте соответствующее приложение WhatsApp и перейдите в раздел Настройки → Аккаунт → Удалить мой аккаунт. Подтвердите точный номер и следуйте инструкциям по удалению.
- Дождитесь освобождения номера. В руководстве по миграции от Meta указано, что это может занять до трех минут; если регистрация по-прежнему не удается, выясните фактическую ошибку, а не пытайтесь многократно удалять или пересоздавать ресурсы.
- Завершите процесс подключения YCloud и верификации номера. Протестируйте входящие сообщения и разрешенный исходящий ответ перед тем, как перенаправлять клиентов на новую конфигурацию.
Хотите продолжить использовать приложение WhatsApp Business на том же номере? Ознакомьтесь с отдельным руководством по сосуществованию с Business app перед удалением аккаунта приложения. Сосуществование — это альтернативный режим подключения для подходящих номеров Business app, а не другой тип аккаунта или процедура миграции провайдера, описанная выше.
Требования к номерам и верификация
Вам необходим контроль над номером и доступ к методу верификации, требуемому выбранным процессом подключения. Стандартная верификация номера выполняется с помощью кода из SMS или голосового звонка. Если номер находится за автоматическим голосовым меню или IVR, убедитесь, что человек может принять проверочный звонок. WhatsApp не может автоматически перемещаться по голосовому меню. См. требования к рабочим телефонным номерам от Meta. Разделяйте следующие проверки:
Подтверждение владения номером — это не то же самое, что завершение регистрации в Cloud API. Выполните процесс подключения в YCloud полностью, не останавливаясь после получения кода. Meta описывает это различие в статье Register a business phone number.
Лимиты на регистрацию телефонных номеров
Лимит на регистрацию номеров определяет, сколько рабочих номеров телефонов можно зарегистрировать в одном бизнес-портфолио. Он отличается от лимита на отправку сообщений, который ограничивает охват клиентов исходящими рассылками. В настоящее время Meta указывает начальный лимит в два зарегистрированных рабочих телефонных номера для новых бизнес-портфолио. Документированный способ увеличить лимит до 20 — пройти подтверждение компании или достичь лимита сообщений в 2 000. Прежде чем планировать добавление новых номеров, уточните лимит, доступный вашей компании. См. Registered number cap. Не следует рассматривать более высокий лимит на количество номеров как отдельную квоту сообщений для каждого номера.Отображаемое имя
Отображаемое имя — это название компании, связанное с вашим номером. Клиенты видят его в профиле компании. Его видимость в других разделах WhatsApp зависит от правил отображения Meta. Выберите имя, которое клиенты смогут однозначно соотнести с вашей компанией или брендом. Обеспечьте его соответствие названию на вашем сайте и в других материалах для клиентов. Например, если ваш бренд называется Example Store, использование этого узнаваемого названия будет более понятным, чем имя, не связанное с бизнесом. Этот пример служит рекомендацией по оформлению, а не гарантией одобрения. Перед отправкой имени на проверку:- Убедитесь, что связь с компанией или брендом понятна и очевидна.
- Проверьте правописание и соответствие публичному названию вашей компании.
- Ознакомьтесь с руководством Meta по отображаемым именам.
- Если запрошенное имя отклонено, используйте указанную причину для исправления вместо повторной отправки того же имени.
Проверка отображаемого имени перед отправкой
В случае отклонения имени проверьте точную причину. Подтверждение компании не отменяет требований к отображаемому имени.
В ответах API поле
verifiedName является полем имени номера; оно не означает, что номер является официальным бизнес-аккаунтом (Official Business Account). Для проверки используйте фактический статус OBA.
Бизнес-профиль
Редактирование профиля в YCloud
Откройте WhatsApp accounts, перейдите в Settings нужного номера и откройте Profile. Обновите необходимую информацию и нажмите Save. Затем проверьте отображение профиля в клиенте WhatsApp. Изменение внутреннего примечания не меняет данные этого профиля. Текущий API профилей YCloud определяет следующие ограничения:
Корректность поля профиля не означает, что предложенное изменение отображаемого имени одобрено. Разделяйте обновление профиля и результат проверки имени.
Профиль дает клиентам больше информации, когда они открывают сведения о вашей компании.
Для просмотра доступных полей и ограничений по формату используйте Управление телефонными номерами WhatsApp. Инструкции по работе в консоли см. в разделе Настройки профиля телефонного номера.
Open Business Profile to review the number identity and customer-facing preview. Status and limits shown belong to this demo number.
Внутренний псевдоним
Псевдоним номера в YCloud помогает вашей команде идентифицировать номер. Он не отображается клиентам и не меняет отображаемое имя в WhatsApp. Например, ваша команда может использовать внутренний псевдоним, такой как Служба поддержки , в то время как клиенты будут видеть отображаемое имя вашего бренда. См. раздел Настройки псевдонима телефонного номера.Имя пользователя компании
Имя пользователя компании существует отдельно от отображаемого имени и внутреннего псевдонима. Где применимо, оно связывается с номером телефона. Ресурс телефонного номера в YCloud разграничивает активное имя пользователя и запрошенное имя пользователя, находящееся на рассмотрении. Запрос в статусе ожидания не следует считать активным именем пользователя. Проверьте текущий статус и доступность, прежде чем использовать имя пользователя в клиентских материалах.Статус телефонного номера
Статус регистрации, проверка отображаемого имени, верификация компании и рейтинг качества описывают разные аспекты одного и того же номера. Не используйте один из них как подтверждение остальных. Если отправка сообщения завершилась ошибкой, изучите сведения об ошибке и статус доставки сообщений, а не полагайтесь на то, что одобренное отображаемое имя гарантирует доставку.Рейтинг качества
Отзывы клиентов могут влиять на качество номера. Отправляйте релевантные сообщения клиентам, которые ожидают их получения, и соблюдайте запросы на отказ от рассылки. Контроль качества и рассылок не связан с лимитом на количество зарегистрированных номеров. Полное описание см. в разделе Контроль качества и доставки.Лимиты на отправку сообщений
Лимиты на отправку сообщений действуют на уровне портфеля компании и распределяются между всеми его бизнес-номерами. Они не определяют, сколько номеров вы можете зарегистрировать или сколько сообщений API может обработать в секунду. При планировании проактивных рассылок проверяйте текущий доступный лимит для соответствующего портфеля. Сведения об уровнях, масштабировании и различиях в скорости отправки см. в разделе Лимиты сообщений и пропускная способность.Следующие шаги
- Добавить еще один номер.
- Отредактировать профиль компании.
- Ознакомиться с совместным использованием приложения WhatsApp Business.
- Перенести номер.
Часто задаваемые вопросы
Я удалил приложение WhatsApp, но номер все еще зарегистрирован. Почему?
Я удалил приложение WhatsApp, но номер все еще зарегистрирован. Почему?
Удаление приложения удаляет его с телефона, но не отвязывает аккаунт WhatsApp. Сначала определите, привязан ли номер к аккаунту в приложении или к существующему подключению к Platform. При переходе из приложения на Platform следуйте описанной выше процедуре явного удаления аккаунта. Для существующего номера API используйте миграцию провайдера. Не удаляйте WABA для исправления ошибки регистрации в приложении.
Появятся ли мои предыдущие чаты в YCloud после подключения номера?
Появятся ли мои предыдущие чаты в YCloud после подключения номера?
Не автоматически. Стандартное удаление аккаунта в приложении не переносит историю приложения во «Входящие», а миграция BSP не копирует базу диалогов старого провайдера. Сохраните необходимые данные перед изменением или прекращением доступа. Отдельный сценарий совместного использования имеет собственные правила синхронизации; не распространяйте эти гарантии на полный переход из приложения на Platform.
Код подтверждения не приходит. Что проверить?
Код подтверждения не приходит. Что проверить?
Убедитесь в правильности полного международного формата номера и в том, что вы можете принять выбранное SMS или голосовой вызов. Для городского номера или IVR настройте доступ к проверочному звонку. Используйте другой метод, если он предлагается на экране подключения, и дождитесь окончания таймера повторной попытки. Если ошибка сохраняется, отправьте в службу поддержки номер, выбранный метод, время попытки и точный текст ошибки — но не код подтверждения или PIN-код регистрации.
Мое отображаемое имя одобрено. Почему отправка все равно завершается ошибкой?
Мое отображаемое имя одобрено. Почему отправка все равно завершается ошибкой?
Одобрение имени относится только к запрошенному отображаемому имени компании, а не ко всем требованиям к отправке. Убедитесь, что регистрация завершена, затем проверьте ошибку сообщения на наличие ограничений, связанных с шаблонами, 24-часовым окном, биллингом, получателями или аккаунтом. Внутренний псевдоним в YCloud также не влияет на одобрение публичного имени или доставку.