[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"docs-entities\u002Fbizproc-robots":3,"docs-tabs-entities\u002Fbizproc-robots":6},{"content":4,"lastmod":5},"# Bizproc robots\n\n**Entity:** `bizprocRobot` | **Scope:** `bizproc` | **Base path:** `\u002Fv1\u002Fbizproc-robots`\n\n> Регистрация роботов для автоматизации Битрикс24. Роботы появляются и в конфигураторе роботов, и в дизайнере бизнес-процессов. Рекомендуемый Битрикс24 формат вместо activities. Требует OAuth-приложение. Только администраторы.\n\n## Operations\n\n| Method | Path | Description | Bitrix24 Method |\n|--------|------|-------------|-----------------|\n| `GET` | `\u002Fv1\u002Fbizproc-robots` | Список зарегистрированных роботов | `bizproc.robot.list` |\n| `POST` | `\u002Fv1\u002Fbizproc-robots` | Зарегистрировать робота | `bizproc.robot.add` |\n| `PATCH` | `\u002Fv1\u002Fbizproc-robots\u002F:code` | Обновить робота | `bizproc.robot.update` |\n| `DELETE` | `\u002Fv1\u002Fbizproc-robots\u002F:code` | Удалить робота | `bizproc.robot.delete` |\n\n> **Disabled operations:** `get` (нет метода в Битрикс24)\n\n> **Важно:** Идентификатор — `CODE` (строка), не числовой ID. `list` возвращает массив строк (кодов).\n\n## Fields\n\n| API Name | Bitrix24 Name | Type | Description |\n|----------|---------------|------|-------------|\n| `code` | `CODE` | string | Уникальный код робота (a-z, A-Z, 0-9, ., -, _) |\n| `handler` | `HANDLER` | string | URL обработчика (тот же домен, что и приложение) |\n| `name` | `NAME` | string | Название (строка или локализованный объект `{ru: '...', en: '...'}`) |\n| `description` | `DESCRIPTION` | string | Описание (строка или локализованный объект) |\n| `authUserId` | `AUTH_USER_ID` | number | ID пользователя, чей токен передаётся приложению |\n| `useSubscription` | `USE_SUBSCRIPTION` | string | Ожидать ответ от приложения (`Y`\u002F`N`) |\n| `properties` | `PROPERTIES` | object | Входные параметры робота |\n| `returnProperties` | `RETURN_PROPERTIES` | object | Выходные параметры робота |\n| `documentType` | `DOCUMENT_TYPE` | object | Тип документа `[module, object, documentType]` |\n| `filter` | `FILTER` | object | Правила INCLUDE\u002FEXCLUDE для типа документа |\n| `usePlacement` | `USE_PLACEMENT` | string | Открывать настройки в слайдере (`Y`\u002F`N`) |\n| `placementHandler` | `PLACEMENT_HANDLER` | string | URL слайдера (обязателен при `usePlacement: 'Y'`) |\n\n### Document types\n\n| Entity | documentType |\n|--------|-------------|\n| Leads | `['crm', 'CCrmDocumentLead', 'LEAD']` |\n| Deals | `['crm', 'CCrmDocumentDeal', 'DEAL']` |\n| Quotes | `['crm', 'Bitrix\\\\Crm\\\\Integration\\\\BizProc\\\\Document\\\\Quote', 'QUOTE']` |\n| Invoices | `['crm', 'Bitrix\\\\Crm\\\\Integration\\\\BizProc\\\\Document\\\\SmartInvoice', 'SMART_INVOICE']` |\n| Smart Processes | `['crm', 'Bitrix\\\\Crm\\\\Integration\\\\BizProc\\\\Document\\\\Dynamic', 'DYNAMIC_XXX']` |\n\n## Examples\n\n### List\n\n```bash\ncurl -X GET 'https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fbizproc-robots' \\\n  -H 'X-Api-Key: YOUR_KEY' \\\n  -H 'Authorization: Bearer YOUR_TOKEN'\n```\n\nResponse: `{ \"success\": true, \"data\": [\"my_robot_1\", \"sms_robot\"] }`\n\n### Create\n\n```bash\ncurl -X POST 'https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fbizproc-robots' \\\n  -H 'X-Api-Key: YOUR_KEY' \\\n  -H 'Authorization: Bearer YOUR_TOKEN' \\\n  -H 'Content-Type: application\u002Fjson' \\\n  -d '{\n    \"code\": \"send_notification\",\n    \"handler\": \"https:\u002F\u002Fmyapp.example.com\u002Frobot-handler\",\n    \"name\": {\"ru\": \"Отправить уведомление\", \"en\": \"Send Notification\"},\n    \"useSubscription\": \"Y\",\n    \"documentType\": [\"crm\", \"CCrmDocumentDeal\", \"DEAL\"],\n    \"properties\": {\n      \"message\": {\n        \"Name\": {\"ru\": \"Текст уведомления\"},\n        \"Type\": \"string\",\n        \"Required\": \"Y\"\n      }\n    },\n    \"returnProperties\": {\n      \"sent\": {\n        \"Name\": {\"ru\": \"Отправлено\"},\n        \"Type\": \"bool\"\n      }\n    }\n  }'\n```\n\n### Update\n\n```bash\ncurl -X PATCH 'https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fbizproc-robots\u002Fsend_notification' \\\n  -H 'X-Api-Key: YOUR_KEY' \\\n  -H 'Authorization: Bearer YOUR_TOKEN' \\\n  -H 'Content-Type: application\u002Fjson' \\\n  -d '{\"handler\": \"https:\u002F\u002Fmyapp.example.com\u002Fnew-robot-handler\"}'\n```\n\n### Delete\n\n```bash\ncurl -X DELETE 'https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fbizproc-robots\u002Fsend_notification' \\\n  -H 'X-Api-Key: YOUR_KEY' \\\n  -H 'Authorization: Bearer YOUR_TOKEN'\n```\n\n## Authorization\n\n`bizproc.robot.add` requires application context. Personal keys (webhooks) will fail with \"Unable to get application by token\". Use OAuth app keys with `bizproc` scope and `Authorization: Bearer` header.\n\n## Errors\n\n| Code | Description |\n|------|-------------|\n| `ERROR_ACTIVITY_ALREADY_INSTALLED` | Robot with this CODE already registered |\n| `ERROR_ACTIVITY_VALIDATION_FAILURE` | Missing required fields or invalid values |\n| `ERROR_ACTIVITY_NOT_FOUND` | Robot with this CODE not found |\n| `ERROR_UNSUPPORTED_PROTOCOL` | Handler URL protocol not supported |\n| `ACCESS_DENIED` | User is not administrator |\n","2026-07-07",{}]