Получить список моделей поведения

GET /api/v1/bot-agents

Возвращает модели поведения указанного бота. Если бот не найден, возвращается 404; если нет доступа — 403.

URL

https://app.helpfy.ai/api/v1/bot-agents

Адрес своей установки подставьте вместо https://app.helpfy.ai. Идентификаторы в фигурных скобках замените значениями из ответов API.

Заголовки

Заголовок	Значение
Authorization	Basic <base64(email:api_key)>
Accept	application/json

Подробнее — авторизация API.

Параметры запроса

Параметры строки запроса

Параметр	Тип	Обязательный	Описание
bot_unique_id	строка	Да	Идентификатор бота, модели поведения которого нужно получить.
is_active	логическое значение	Нет	Активна ли запись.
skip	число	Нет	Количество пропускаемых записей. По умолчанию 0.
take	число	Нет	Количество возвращаемых записей. По умолчанию 10.

Пример запроса

curl --request GET 'https://app.helpfy.ai/api/v1/bot-agents' \
  --user 'user@example.com:api_key' \
  --header 'Accept: application/json' \
  --get \
  --data-urlencode 'bot_unique_id=804be633-6f3b-4d38-abf3-8b2709e141fb'

Ответы

HTTP	Описание
200	Успешный ответ
403	Недостаточно прав для доступа к боту.
404	Бот не найден.

Пример ответа — HTTP 200

Сокращённый пример; показаны клиентские поля. Значения условные.

{
  "data": [
    {
      "unique_id": "17396bcc-6b29-4b2e-b7fd-63c8eb8b6cc8",
      "name": "Служба поддержки",
      "greeting_message": "example",
      "greeting_message_is_enabled": true,
      "greeting_filter": "example",
      "greeting_filter_is_enabled": true,
      "closing_message": "example",
      "closing_message_is_enabled": true,
      "closing_filter": "example",
      "closing_filter_is_enabled": true,
      "classify_greeting_is_enabled": true,
      "classify_closing_is_enabled": true,
      "classify_operator_is_enabled": true,
      "classify_spam_is_enabled": true,
      "spam_filter": "example",
      "spam_filter_is_enabled": true,
      "spam_fallback_message": "example",
      "system_behavior": "example",
      "system_behavior_is_enabled": true,
      "executor": "example",
      "executor_is_enabled": true,
      "executor_fallback_message": "example",
      "constant_context": "example",
      "constant_context_is_enabled": true,
      "public_sources_header": "example",
      "public_sources_header_is_enabled": true,
      "public_sources_limit": 1,
      "is_active": false,
      "is_default": false,
      "created_at": "2026-10-16T09:00:00.000Z",
      "updated_at": "2026-10-16T09:00:00.000Z"
    }
  ],
  "meta": {
    "total": 100,
    "skip": 0,
    "take": 10
  }
}