Перейти к основному содержанию
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. Безопасно разверните агента от получателей из белого списка на всю аудиторию.
  5. Эксплуатируйте и устраняйте неполадки работающего агента.

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

У каждого раздела справочника API есть собственная начальная страница и ссылки на все эндпоинты в этой области. В этом релизе задокументированы 62 операции REST. Созданные через API агенты также могут отправлять события вебхуков echo и handover.

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

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