Skip to main content
Meta Business Agent — это ИИ-агент на базе Meta, который может отвечать на сообщения клиентов в WhatsApp, используя настроенную вами бизнес-информацию, знания, навыки и инструменты. YCloud предоставляет управление жизненным циклом Meta Business Agent через REST API YCloud и передает учетные данные Meta от вашего имени.
Meta Business Agent — это продукт Meta на стадии раннего доступа. Доступность, правила валидации и поведение во время выполнения могут меняться независимо от YCloud. Всегда вызывайте эндпоинт Check Eligibility для номера телефона, который планируете использовать.

​
Основы API

YCloud определяет тенант и токен доступа Meta на основе вашего API-ключа. Не передавайте токен доступа Meta в этих запросах.

​
Рекомендуемый жизненный цикл

Следуйте руководствам по созданию и запуску по порядку. Они объединяют отдельные ресурсы API в единый сквозной процесс развертывания.
  1. Подготовьтесь и проверьте соответствие требованиям.
  2. Подключите и настройте агента в ограниченном тестовом режиме.
  3. Протестируйте и оцените одиночные реплики, многоэтапные диалоги и типовые бизнес-сценарии.
  4. Выполните безопасное развертывание — от разрешенных получателей (allowlist) ко всей аудитории.
  5. Эксплуатируйте и устраняйте неполадки работающего агента.

​
Ресурсы, охватываемые рабочим процессом

Каждый раздел справочника API имеет отдельную начальную страницу со ссылками на все эндпоинты этой области. В этом выпуске описаны 62 операции REST API. Агенты, созданные через API, также могут отправлять Webhook-события эхо и передачи оператору.

​
Владение и изоляция

За исключением проверки соответствия требованиям, для операций на уровне номера телефона требуется активная привязка агента Public API, принадлежащая тому же тенанту YCloud. YCloud возвращает 404, если привязка отсутствует, принадлежит другому тенанту или была создана через несовместимый источник. Это предотвращает доступ одного тенанта или уровня интеграции к агенту другого.