> ## 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 — это идентификатор отправителя, который клиенты видят в переписке. Эти API позволяют находить зарегистрированные номера, настраивать их бизнес-профиль, запрашивать смену отображаемого имени, управлять видимостью коммерции и настройками, специфичными для номера.

## Перед началом

* Подключите родительский WABA к YCloud.
* Добавьте номер телефона в WABA.
* Сохраните ID WABA и номер телефона в формате E.164.
* Загрузите изображение профиля в Meta перед установкой `profilePictureUrl`.

## Как это работает

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

Смена отображаемого имени и некоторые платформенные настройки могут требовать асинхронной обработки со стороны Meta.

## Запрос

### Зарегистрировать номер телефона

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl --request POST \
  https://api.ycloud.com/v2/whatsapp/phoneNumbers/WABA_ID/+16315551111/register \
  --header "X-API-Key: $YCLOUD_API_KEY"
```

### Обновить бизнес-профиль

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl --request PATCH \
  https://api.ycloud.com/v2/whatsapp/phoneNumbers/WABA_ID/+16315551111/profile \
  --header "X-API-Key: $YCLOUD_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "about": "Customer support and order updates",
    "address": "100 Market Street",
    "description": "Example Store",
    "email": "support@example.com",
    "vertical": "RETAIL",
    "websites": ["https://example.com"]
  }'
```

### Обновить видимость коммерции

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl --request PATCH \
  https://api.ycloud.com/v2/whatsapp/phoneNumbers/WABA_ID/+16315551111/whatsappCommerceSettings \
  --header "X-API-Key: $YCLOUD_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "isCartEnabled": true,
    "isCatalogVisible": true
  }'
```

## Ответ

Операции над профилем и настройками возвращают обновлённый ресурс.

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "about": "Customer support and order updates",
  "email": "support@example.com",
  "vertical": "RETAIL",
  "websites": ["https://example.com"]
}
```

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

## Области настройки

| Область | Используется для |
| - | - |
| Профиль | Текст «О себе», адрес, описание, email, вертикаль, веб-сайты и изображение профиля. |
| Отображаемое имя | Имя отправителя, видимое клиентам, подаётся на обработку Meta. |
| Коммерция | Видимость каталога и управление корзиной покупок. |
| Настройки | Функции, специфичные для номера, например WhatsApp Calling. |

## Ограничения и устранение неполадок

* Поля профиля имеют лимиты формата и длины; полные ограничения см. в справочнике API.
* URL веб-сайтов должны включать `http://` или `https://`.
* Обновление отображаемого имени может активироваться не сразу.
* Регистрация, качество и состояние WABA могут независимо влиять на отправку.
* Используйте ID WABA и точный номер в формате E.164 в каждом пути.

<CardGroup cols={2}>
  <Card title="Список номеров телефонов" icon="list" href="/api-reference/whatsapp-phone-numbers/list-phone-numbers">
    Найдите зарегистрированные номера и их родительский WABA.
  </Card>

  <Card title="Обновить профиль" icon="address-card" href="/api-reference/whatsapp-phone-numbers/update-a-phone-number-profile">
    Изучите каждое поле профиля и его ограничения.
  </Card>
</CardGroup>


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