Управление номерами телефонов WhatsApp

​

Что это

​

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

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

​

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

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

​

Запрос

​

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

curl --request POST \
  https://api.ycloud.com/v2/whatsapp/phoneNumbers/WABA_ID/+16315551111/register \
  --header "X-API-Key: $YCLOUD_API_KEY"

​

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

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"]
  }'

​

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

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
  }'

​

Ответ

{
  "about": "Customer support and order updates",
  "email": "support@example.com",
  "vertical": "RETAIL",
  "websites": ["https://example.com"]
}

​

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

​

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

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