Skip to main content

​
Что это такое

Аккаунт WhatsApp Business (WABA) содержит телефонные номера, шаблоны и настройки обмена сообщениями, используемые бизнесом. Используйте эти API для поиска аккаунтов WABA, подключенных к вашему аккаунту YCloud, и проверки готовности каждого аккаунта к отправке сообщений в рабочей среде.

​
Перед началом работы

  • Подключите или зарегистрируйте WABA в YCloud.
  • Обеспечьте безопасное хранение вашего API-ключа YCloud.
  • Определите, требуются ли вам все подключенные аккаунты или один конкретный WABA ID.

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

  1. Получите список WABA, чтобы узнать их ID.
  2. Получите данные конкретного WABA, когда вам требуется его текущий статус бизнеса, верификации, оплаты, ограничений или лимитов на отправку сообщений.
  3. Сохраняйте WABA ID вместе с относящимися к нему телефонными номерами и шаблонами.
Этот API предназначен только для чтения. Подключение аккаунта и устранение проблем могут потребовать действий в YCloud или Meta Business Manager.

​
Запрос

​
Получить список WABA

GET /whatsapp/businessAccounts
Используйте filter.accountReviewStatus, когда вам нужны аккаунты в определенном статусе проверки.

​
Получить один WABA

GET /whatsapp/businessAccounts/{id}

​
Ответ

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

Эндпоинты получения списка и отдельного аккаунта не возвращают историю значений для maxPhoneNumbersPerBusiness или maxPhoneNumbersPerWaba. Подпишитесь на whatsapp.business_account.updated и обрабатывайте updateEvent=BUSINESS_CAPABILITY_UPDATE, чтобы получать значения, которые Meta включает в каждое обновление. В настоящее время Meta передает эти два поля в отдельных обновлениях. Не рассматривайте их как взаимоисключающие: обрабатывайте каждое поле независимо и принимайте оба, если в будущем обновлении они будут переданы вместе. Значение 0 является допустимым. Сохраняйте эти значения в своей системе, если вам требуется история или последнее известное состояние.

​
Готовность аккаунта

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

​
Лимиты и устранение неполадок

  • Если WABA не найден, обычно это означает, что он не подключен к текущему аккаунту YCloud или указан неверный ID.
  • Статусы проверки, верификации, ограничений и оплаты контролируются Meta и могут изменяться асинхронно.
  • Кэшируйте стабильные идентификаторы, но запрашивайте актуальный статус перед диагностикой проблем с подключением или отправкой сообщений.

Получить список WABA

Ознакомьтесь с пагинацией, фильтрами и полной схемой страницы.

Получить WABA

Ознакомьтесь со всеми полями статуса аккаунта и ограничений.