> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ycloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Рабочие телефонные номера

> Выберите рабочий телефонный номер и узнайте о его регистрации, отображаемом имени, бизнес-профиле и идентификаторах.

Рабочий телефонный номер — это ресурс WhatsApp, который вы используете для отправки и получения сообщений. Он принадлежит WhatsApp Business Account (WABA) и имеет собственное отображаемое имя и бизнес-профиль.

## Выберите способ подключения вашего номера

Выберите один из трех путей в зависимости от того, где сейчас зарегистрирован номер. «Новый» означает **в настоящее время не зарегистрирован в WhatsApp**, а не обязательно только что купленную SIM-карту.

| Исходное состояние | Что меняется | Путь подключения |
| - | - | - |
| **Новый номер, не зарегистрированный в WhatsApp** | Зарегистрируйте номер в WhatsApp Business Platform и подключите его к YCloud. | [Подключить новый номер](/ru/documentation/channels/whatsapp-accounts-management/business-accounts/create-waba-via-embedded-sign-up). |
| **Существующий номер API у другого BSP** | Сохраните рабочий телефонный номер и перенесите его подключение к Platform от текущего провайдера в YCloud. | [Перенести номер API в YCloud](/ru/documentation/channels/whatsapp-accounts-management/business-accounts/number-migration). |
| **Номер в WhatsApp Messenger или приложении WhatsApp Business** | Удалите существующий аккаунт приложения, затем зарегистрируйте освободившийся номер на Platform. Аккаунт приложения и история его чатов не переносятся в аккаунт Platform и историю Inbox. | Выполните указанные ниже проверки для перехода из приложения на Platform, затем [подключите номер](/ru/documentation/channels/whatsapp-accounts-management/business-accounts/create-waba-via-embedded-sign-up). |

### 1. Зарегистрировать новый номер

Убедитесь, что вы контролируете номер и можете получить код подтверждения по SMS или голосовому звонку. Завершите процесс подключения YCloud, выберите нужный бизнес-портфель и WABA, а затем зарегистрируйте номер. Вам не требуется предварительно создавать аккаунт в WhatsApp Messenger или приложении WhatsApp Business.

Если WABA уже подключен к YCloud, используйте [Add numbers](/ru/documentation/channels/whatsapp-accounts-management/business-accounts/add-numbers).

### 2. Перенести существующий номер API от другого BSP

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

Спланируйте переключение отправки сообщений, шаблонов, Webhook и зависимых автоматизаций. Не рассчитывайте на то, что Inbox, контакты, данные кампаний или история переписок предыдущего провайдера будут скопированы в YCloud. Экспортируйте необходимые данные до прекращения доступа к старому провайдеру.

В [руководстве по миграции номеров](/ru/documentation/channels/whatsapp-accounts-management/business-accounts/number-migration) описаны шаги подготовки и действия в YCloud. «Миграция аккаунта API» — распространенное сокращение; переносимым ресурсом является сам номер, а не все рабочее пространство вашего провайдера.

### 3. Полный перенос номера из приложения на Platform

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

<Warning>
  **Удаление аккаунта приложения необратимо.** Оно удаляет аккаунт и влияет на сообщения, участие в группах и резервные копии. Удаление самого приложения не является удалением аккаунта. Историю чатов приложения невозможно восстановить в YCloud Inbox путем регистрации номера на Platform. Оцените последствия и экспортируйте нужные данные перед удалением.
</Warning>

1. Убедитесь, что вы хотите прекратить использование аккаунта приложения на этом номере и что все условия для подключения YCloud выполнены.
2. Сохраните нужные данные вне приложения. Не полагайтесь на облачную резервную копию чатов для последующего импорта на Platform.
3. На основном телефоне откройте соответствующее приложение WhatsApp и перейдите в раздел **Настройки → Аккаунт → Удалить мой аккаунт**. Подтвердите точный номер и следуйте инструкциям по удалению.
4. Дождитесь освобождения номера. В руководстве по миграции от Meta указано, что это может занять до трех минут; если регистрация по-прежнему не удается, выясните фактическую ошибку, а не пытайтесь многократно удалять или пересоздавать ресурсы.
5. Завершите процесс подключения YCloud и верификации номера. Протестируйте входящие сообщения и разрешенный исходящий ответ перед тем, как перенаправлять клиентов на новую конфигурацию.

Источники: [руководство Meta по миграции номеров из приложения](https://developers.facebook.com/documentation/business-messaging/whatsapp/solution-providers/migrate-existing-whatsapp-number-to-a-business-account) и [инструкция WhatsApp по удалению аккаунта](https://faq.whatsapp.com/2138577903196467/?cms_platform=android\&locale=en_US).

<Note>
  Хотите продолжить использовать **приложение WhatsApp Business** на том же номере? Ознакомьтесь с отдельным [руководством по сосуществованию с Business app](/ru/documentation/whatsapp-business-platform/accounts-and-business-identity/whatsapp-business-app-coexistence) перед удалением аккаунта приложения. Сосуществование — это альтернативный режим подключения для подходящих номеров Business app, а не другой тип аккаунта или процедура миграции провайдера, описанная выше.
</Note>

## Требования к номерам и верификация

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

Если номер находится за автоматическим голосовым меню или IVR, убедитесь, что человек может принять проверочный звонок. WhatsApp не может автоматически перемещаться по голосовому меню. См. [требования к рабочим телефонным номерам](https://developers.facebook.com/docs/whatsapp/business-management-api/manage-phone-numbers/) от Meta.

Разделяйте следующие проверки:

| Проверка | Что подтверждает |
| - | - |
| Подтверждение владения номером | Вы можете получить код подтверждения для этого номера. |
| Регистрация на платформе | Номер зарегистрирован для использования с Business Platform. |
| Двухшаговая проверка | PIN-код защищает регистрацию номера. Это не код подтверждения из SMS или голосового вызова. |
| Проверка отображаемого имени | Meta проверила запрошенное бизнес-имя, отображаемое клиентам. |
| Подтверждение компании | Meta проверила компанию, представленную в бизнес-портфолио. |

Подтверждение владения номером — это не то же самое, что завершение регистрации в Cloud API. Выполните процесс подключения в YCloud полностью, не останавливаясь после получения кода. Meta описывает это различие в статье [Register a business phone number](https://developers.facebook.com/docs/whatsapp/cloud-api/reference/registration/).

## Лимиты на регистрацию телефонных номеров

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

В настоящее время Meta указывает начальный лимит в два зарегистрированных рабочих телефонных номера для новых бизнес-портфолио. Документированный способ увеличить лимит до 20 — пройти подтверждение компании или достичь лимита сообщений в 2 000. Прежде чем планировать добавление новых номеров, уточните лимит, доступный вашей компании. См. [Registered number cap](https://developers.facebook.com/docs/whatsapp/business-management-api/manage-phone-numbers/#registered-number-cap).

Не следует рассматривать более высокий лимит на количество номеров как отдельную квоту сообщений для каждого номера.

## Отображаемое имя

Отображаемое имя — это название компании, связанное с вашим номером. Клиенты видят его в профиле компании. Его видимость в других разделах WhatsApp зависит от правил отображения Meta.

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

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

Перед отправкой имени на проверку:

* Убедитесь, что связь с компанией или брендом понятна и очевидна.
* Проверьте правописание и соответствие публичному названию вашей компании.
* Ознакомьтесь с [руководством Meta по отображаемым именам](https://www.facebook.com/business/help/757569725593362).
* Если запрошенное имя отклонено, используйте указанную причину для исправления вместо повторной отправки того же имени.

Запрошенное отображаемое имя может находиться на рассмотрении, быть одобрено или отклонено. Это статусы проверки имени, а не полное описание состояния обмена сообщениями для номера. Отправленное изменение может вступить в силу не сразу.

Актуальный процесс проверки описан в статье [About WhatsApp Business display names](https://en-gb.facebook.com/business/help/338047025165344). Для настройки в YCloud откройте бизнес-профиль номера через [Phone number profile settings](/ru/documentation/channels/whatsapp-accounts-management/phone-number-management/phone-number-profile-settings).

### Проверка отображаемого имени перед отправкой

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

В случае отклонения имени проверьте точную причину. Подтверждение компании не отменяет требований к отображаемому имени.

В ответах API поле `verifiedName` является полем имени номера; оно **не** означает, что номер является официальным бизнес-аккаунтом (Official Business Account). Для проверки используйте фактический статус OBA.

## Бизнес-профиль

### Редактирование профиля в YCloud

Откройте **WhatsApp accounts**, перейдите в **Settings** нужного номера и откройте **Profile**. Обновите необходимую информацию и нажмите **Save**. Затем проверьте отображение профиля в клиенте WhatsApp. Изменение внутреннего примечания не меняет данные этого профиля.

Текущий API профилей YCloud определяет следующие ограничения:

| Поле | Ограничение |
| - | - |
| About | 1–139 символов; обычный текст без форматирования Markdown. |
| Description | 512 символов. |
| Адрес | 256 символов. |
| Email | 128 символов и корректный формат email. |
| Веб-сайты | До 2 URL, каждый до 255 символов и должен содержать `http://` или `https://`. |

Корректность поля профиля не означает, что предложенное изменение отображаемого имени одобрено. Разделяйте обновление профиля и результат проверки имени.

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

| Сведения профиля | Что предоставить |
| - | - |
| Фотография профиля | Узнаваемое изображение компании или бренда. |
| Текст раздела «О себе» и описание | Краткое описание деятельности вашей компании. |
| Категория бизнеса | Категория, описывающая вашу деятельность. |
| Адрес | Актуальный адрес вашей компании. |
| Email | Контактный адрес, отслеживаемый вашей командой. |
| Веб-сайты | Актуальные, полные URL-адреса веб-сайтов. |

Для просмотра доступных полей и ограничений по формату используйте [Управление телефонными номерами WhatsApp](/ru/api-reference/guides/whatsapp-platform/manage-whatsapp-phone-numbers). Инструкции по работе в консоли см. в разделе [Настройки профиля телефонного номера](/ru/documentation/channels/whatsapp-accounts-management/phone-number-management/phone-number-profile-settings).

<Frame caption="Open Business Profile to review the number identity and customer-facing preview. Status and limits shown belong to this demo number.">
  <img src="https://mintcdn.com/lchnan/gXEJIQXV2JH2VUQJ/product-assets/english-help-2026-09-22/profile-annotated.svg?fit=max&auto=format&n=gXEJIQXV2JH2VUQJ&q=85&s=1cfffa0d6f0355604b40180a3f6b2487" alt="Настройки бизнес-профиля и предварительный просмотр для клиентов для демонстрационного номера." width="3024" height="1656" data-path="product-assets/english-help-2026-09-22/profile-annotated.svg" />
</Frame>

### Внутренний псевдоним

Псевдоним номера в YCloud помогает вашей команде идентифицировать номер. Он не отображается клиентам и не меняет отображаемое имя в WhatsApp.

Например, ваша команда может использовать внутренний псевдоним, такой как **Служба поддержки** , в то время как клиенты будут видеть отображаемое имя вашего бренда. См. раздел [Настройки псевдонима телефонного номера](/ru/documentation/channels/whatsapp-accounts-management/phone-number-management/edit-phone-number-display-name).

## Имя пользователя компании

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

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

## Статус телефонного номера

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

Если отправка сообщения завершилась ошибкой, изучите сведения об ошибке и [статус доставки сообщений](/ru/documentation/whatsapp-business-platform/messaging/message-delivery-statuses), а не полагайтесь на то, что одобренное отображаемое имя гарантирует доставку.

## Рейтинг качества

Отзывы клиентов могут влиять на качество номера. Отправляйте релевантные сообщения клиентам, которые ожидают их получения, и соблюдайте [запросы на отказ от рассылки](/ru/documentation/whatsapp-business-platform/consent-policies-and-account-health/customer-opt-out).

<a id="maintain-high-quality-rating" />

Контроль качества и рассылок не связан с лимитом на количество зарегистрированных номеров. Полное описание см. в разделе [Контроль качества и доставки](/ru/documentation/whatsapp-business-platform/pricing-limits-and-quality/quality-and-delivery-controls).

<a id="xiao-xi-xian-e" />

## Лимиты на отправку сообщений

Лимиты на отправку сообщений действуют на уровне портфеля компании и распределяются между всеми его бизнес-номерами. Они не определяют, сколько номеров вы можете зарегистрировать или сколько сообщений API может обработать в секунду.

При планировании проактивных рассылок проверяйте текущий доступный лимит для соответствующего портфеля. Сведения об уровнях, масштабировании и различиях в скорости отправки см. в разделе [Лимиты сообщений и пропускная способность](/ru/documentation/whatsapp-business-platform/pricing-limits-and-quality/messaging-limits-and-throughput).

## Следующие шаги

* [Добавить еще один номер](/ru/documentation/channels/whatsapp-accounts-management/business-accounts/add-numbers).
* [Отредактировать профиль компании](/ru/documentation/channels/whatsapp-accounts-management/phone-number-management/phone-number-profile-settings).
* [Ознакомиться с совместным использованием приложения WhatsApp Business](/ru/documentation/whatsapp-business-platform/accounts-and-business-identity/whatsapp-business-app-coexistence).
* [Перенести номер](/ru/documentation/channels/whatsapp-accounts-management/business-accounts/number-migration).

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

<AccordionGroup>
  <Accordion title="Я удалил приложение WhatsApp, но номер все еще зарегистрирован. Почему?">
    Удаление приложения удаляет его с телефона, но не отвязывает аккаунт WhatsApp. Сначала определите, привязан ли номер к аккаунту в приложении или к существующему подключению к Platform. При переходе из приложения на Platform следуйте описанной выше процедуре явного удаления аккаунта. Для существующего номера API используйте миграцию провайдера. Не удаляйте WABA для исправления ошибки регистрации в приложении.
  </Accordion>

  <Accordion title="Появятся ли мои предыдущие чаты в YCloud после подключения номера?">
    Не автоматически. Стандартное удаление аккаунта в приложении не переносит историю приложения во «Входящие», а миграция BSP не копирует базу диалогов старого провайдера. Сохраните необходимые данные перед изменением или прекращением доступа. Отдельный сценарий совместного использования имеет собственные правила синхронизации; не распространяйте эти гарантии на полный переход из приложения на Platform.
  </Accordion>

  <Accordion title="Код подтверждения не приходит. Что проверить?">
    Убедитесь в правильности полного международного формата номера и в том, что вы можете принять выбранное SMS или голосовой вызов. Для городского номера или IVR настройте доступ к проверочному звонку. Используйте другой метод, если он предлагается на экране подключения, и дождитесь окончания таймера повторной попытки. Если ошибка сохраняется, отправьте в службу поддержки номер, выбранный метод, время попытки и точный текст ошибки — но не код подтверждения или PIN-код регистрации.
  </Accordion>

  <Accordion title="Мое отображаемое имя одобрено. Почему отправка все равно завершается ошибкой?">
    Одобрение имени относится только к запрошенному отображаемому имени компании, а не ко всем требованиям к отправке. Убедитесь, что регистрация завершена, затем проверьте ошибку сообщения на наличие ограничений, связанных с шаблонами, 24-часовым окном, биллингом, получателями или аккаунтом. Внутренний псевдоним в YCloud также не влияет на одобрение публичного имени или доставку.
  </Accordion>
</AccordionGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.