[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"docs-bots\u002Fmanagement\u002Flist":3,"docs-tabs-bots\u002Fmanagement\u002Flist":6},{"content":4,"lastmod":5},"\n## Список ботов\n\n`GET \u002Fv1\u002Fbots`\n\nВозвращает список ботов, зарегистрированных текущим API-ключом на портале.\n\nЗапрос **не идёт** в Битрикс24 — возвращаются строки из Вайбкод DB, отфильтрованные по вашему API-ключу. Автоматически отключённые боты (`PORTAL_DELETED` \u002F `AUTH_FAILURES`) в список не попадают — чтобы увидеть их, переключите статус вручную через `PATCH \u002Fv1\u002Fbots\u002F:botId { disabled: false }`.\n\n## Параметры\n\n| Параметр | Тип | Обяз. | Описание |\n|----------|-----|:-----:|---------|\n| `limit` | number | нет | Максимальное количество ботов в ответе. По умолчанию 50, максимум 200 |\n| `offset` | number | нет | Смещение для пагинации. По умолчанию 0 |\n| `type` | string | нет | Фильтр по типу бота: `bot`, `personal`, `supervisor`, `openline` |\n\n## Примеры\n\n### curl — личный ключ\n\n```bash\ncurl https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fbots \\\n  -H \"X-Api-Key: YOUR_API_KEY\"\n```\n\n### curl — OAuth-приложение\n\n```bash\ncurl https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fbots \\\n  -H \"X-Api-Key: YOUR_APP_KEY\" \\\n  -H \"Authorization: Bearer USER_SESSION_TOKEN\"\n```\n\n### JavaScript — личный ключ\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fbots', {\n  headers: { 'X-Api-Key': 'YOUR_API_KEY' },\n})\nconst { data } = await res.json()\nconsole.log('Мои боты:', data.bots)\n```\n\n### JavaScript — OAuth-приложение\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fbots', {\n  headers: {\n    'X-Api-Key': 'YOUR_APP_KEY',\n    'Authorization': 'Bearer USER_SESSION_TOKEN',\n  },\n})\nconst { data } = await res.json()\n```\n\n## Поля ответа\n\n| Поле | Тип | Описание |\n|------|-----|---------|\n| `bots` | array | Массив объектов ботов |\n| `bots[].id` | number | ID бота на Битрикс24-портале |\n| `bots[].code` | string | Уникальный код бота |\n| `bots[].name` | string | Отображаемое имя бота в чате |\n| `bots[].type` | string | Тип: `bot`, `personal`, `supervisor`, `openline` |\n| `bots[].eventMode` | string | Режим событий: `fetch` или `webhook` |\n| `users` | array | Всегда пустой массив. Сохранён для обратной совместимости — чтобы получить пользователей Битрикс24, используйте `GET \u002Fv1\u002Fusers` |\n| `hasNextPage` | boolean | `true`, если ещё есть записи за пределами текущей страницы — увеличьте `offset` |\n\n## Пример ответа\n\n```json\n{\n  \"success\": true,\n  \"data\": {\n    \"bots\": [\n      {\n        \"id\": 42,\n        \"code\": \"support_bot\",\n        \"name\": \"Техподдержка\",\n        \"type\": \"bot\",\n        \"eventMode\": \"fetch\"\n      },\n      {\n        \"id\": 58,\n        \"code\": \"analytics_bot\",\n        \"name\": \"Аналитик\",\n        \"type\": \"openline\",\n        \"eventMode\": \"webhook\"\n      }\n    ],\n    \"users\": [],\n    \"hasNextPage\": false\n  }\n}\n```\n\n## Пример ответа при ошибке\n\n403 — нет скоупа `imbot`:\n\n```json\n{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"SCOPE_DENIED\",\n    \"message\": \"This endpoint requires 'imbot' scope\"\n  }\n}\n```\n\n## Ошибки\n\n| HTTP | Код | Описание |\n|------|-----|---------|\n| 403 | `SCOPE_DENIED` | API-ключ не имеет скоупа `imbot` |\n\nПолный список общих ошибок API — [Ошибки](\u002Fdocs\u002Ferrors).\n\n## Смотрите также\n\n- [Получить бота](\u002Fdocs\u002Fbots\u002Fmanagement)\n- [Зарегистрировать бота](\u002Fdocs\u002Fbots\u002Fmanagement)\n- [Бот-платформа](\u002Fdocs\u002Fbots)\n- [Лимиты и оптимизация](\u002Fdocs\u002Foptimization)\n","2026-06-24",{}]