> ## 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.

# Обзор Meta Business Agent

> Создавайте и запускайте ИИ-агента на базе Meta для номера телефона WhatsApp Business с помощью YCloud API.

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

<Warning>
  Meta Business Agent — это продукт Meta на стадии раннего доступа. Доступность, правила валидации и поведение во время выполнения могут меняться независимо от YCloud. Всегда вызывайте [эндпоинт Check Eligibility](/api-reference/meta-business-agents/check-eligibility) для номера телефона, который планируете использовать.
</Warning>

## Основы API

| Элемент | Значение |
| - | - |
| Базовый URL | `https://api.ycloud.com/v2` |
| Аутентификация | `X-API-Key: YOUR_API_KEY` |
| Путь к ресурсу | `/metaBusinessAgents/{entityId}` |
| `entityId` | Идентификатор номера телефона WhatsApp Business, которому принадлежит агент |
| Именование полей в полезной нагрузке | `snake_case` |

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

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

Следуйте руководствам по созданию и запуску по порядку. Они объединяют отдельные ресурсы API в единый сквозной процесс развертывания.

1. [Подготовьтесь и проверьте соответствие требованиям](/ru/documentation/meta-business-agent/prepare-and-check-eligibility).
2. [Подключите и настройте](/ru/documentation/meta-business-agent/onboard-and-configure) агента в ограниченном тестовом режиме.
3. [Протестируйте и оцените](/ru/documentation/meta-business-agent/test-and-evaluate) одиночные реплики, многоэтапные диалоги и типовые бизнес-сценарии.
4. [Выполните безопасное развертывание](/ru/documentation/meta-business-agent/roll-out-safely) — от разрешенных получателей (allowlist) ко всей аудитории.
5. [Эксплуатируйте и устраняйте неполадки](/ru/documentation/meta-business-agent/operate-and-troubleshoot) работающего агента.

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

Каждый раздел справочника API имеет отдельную начальную страницу со ссылками на все эндпоинты этой области.

| Область | Возможности | Справочник API |
| - | - | - |
| Подключение (Onboard) | Проверка соответствия требованиям, подключение или удаление агента, управление настройками профиля и бюджетами, а также ведение списка разрешенных (allowlist) | [Открыть раздел](/ru/api-reference/meta-business-agents/onboard) |
| Настройка (Configure) | Управление бизнес-знаниями, поведенческими и UI-навыками, коннекторами, учетными данными и инструментами коннекторов | [Открыть раздел](/ru/api-reference/meta-business-agents/configure) |
| Эксплуатация (Operate) | Отправка событий, анализ этапов диалога, тестирование ответов, управление ветками переписки, запуск оценок и получение результатов | [Открыть раздел](/ru/api-reference/meta-business-agents/operate) |

В этом выпуске описаны 62 операции REST API. Агенты, созданные через API, также могут отправлять
[Webhook-события эхо и передачи оператору](/ru/api-reference/guides/examples/webhook-examples/overview#echo-and-agent-handover-events).

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

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


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