Что синхронизировать с Ii-Agenty-Dlya-Biznesa

• Lead_ID (Лиды): Синхронизация статусов квалификации из CRM (amoCRM, Bitrix24). Метод: POST /v1/leads/sync.
• Conversation_History (История диалогов): Выгрузка логов общения в хранилище данных или BI-системы (Tableau, PowerBI). Метод: GET /v1/chats/{id}/history.
• Knowledge_Base_Chunk (База знаний): Актуализация данных из Notion или Google Sheets для дообучения агента. Метод: PUT /v1/kb/items/{chunk_id}.
• Task_Assignment (Задачи): Автоматическое создание тикетов в Jira или YouTrack при получении запроса от клиента. Метод: POST /v1/agents/tasks.
• User_Context (Профиль пользователя): Передача метаданных клиента (сегмент, LTV) из внутренней базы для персонализации ответа. Метод: PATCH /v1/users/{user_id}/context.
• Execution_Log (Логи исполнения): Отправка данных о работе агента в системы мониторинга (Sentry, ELK). Метод: POST /v1/monitoring/logs.

Технические особенности API Ii-Agenty-Dlya-Biznesa

• Аутентификация: Используется Bearer-токен (JWT), передаваемый в заголовке Authorization: Bearer {api_key}.
• Формат данных: Все запросы и ответы строго в формате application/json с кодировкой UTF-8.
• Rate Limits: Ограничение составляет 100 запросов в минуту на один API-ключ. При превышении сервер возвращает 429 Too Many Requests с заголовком Retry-After.
• Обработка ошибок: API использует стандартные коды: 401 Unauthorized (неверный ключ), 403 Forbidden (недостаточно прав), 422 Unprocessable Entity (ошибка валидации полей), 500 Internal Server Error.
• Вебхуки: Система поддерживает отправку событий (например, agent.task.completed) по HTTPS URL. Требуется подтверждение получения через 200 OK.
• Версионирование: Актуальная версия API передается в пути запроса, например: /api/v1/ или /api/v2/.
• Песочница: Доступен эндпоинт /v1/sandbox/ для тестирования сценариев без расхода лимитов и воздействия на продуктовые данные.

Часто задаваемые вопросы о Ii-Agenty-Dlya-Biznesa

Как получить API-ключ для доступа?
Ключ генерируется в панели управления в разделе «Интеграции» -> «API Keys». Вы можете создавать до 5 активных ключей с разным уровнем прав доступа.

Существуют ли жесткие лимиты на количество запросов?
Да, стандартный тариф предусматривает ограничение в 100 запросов/мин. Для высоконагруженных B2B-решений лимиты могут быть увеличены через запрос в службу технической поддержки.

Как реализовать получение уведомлений о событиях?
Необходимо настроить Webhook URL в настройках агента и подписаться на конкретные события, такие как создание диалога или завершение задачи. Система отправляет POST-запрос с JSON-телом, содержащим данные события.

Можно ли протестировать API без реальной нагрузки?
Да, используйте эндпоинты в песочнице /sandbox/. Все данные, отправленные в песочницу, не сохраняются в основной базе знаний и не влияют на метрики реальных агентов.

Гарантируется ли обратная совместимость версий?
Мы поддерживаем текущую (stable) и предыдущую (deprecated) версии API в течение 6 месяцев после выхода нового релиза. Рекомендуется обновлять интеграции при появлении минорных версий для использования новых функций.

Где найти документацию по методам?
Техническое описание методов, спецификации Swagger/OpenAPI доступны по адресу docs.ii-agenty.ru. Настроить интеграцию Ii-Agenty-Dlya-Biznesa под ключ — flowframe.ru, от 40 000 ₽, срок 7-21 день.