[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"docs-entities\u002Fbizproc-activities":3,"docs-tabs-entities\u002Fbizproc-activities":6},{"content":4,"lastmod":5},"# Bizproc activities\n\n**Entity:** `bizprocActivity` | **Scope:** `bizproc` | **Base path:** `\u002Fv1\u002Fbizproc-activities`\n\n> Регистрация кастомных действий для дизайнера бизнес-процессов Битрикс24. Требует OAuth-приложение (вебхуки не поддерживаются Битрикс24 для этого метода). Только администраторы.\n\n## Operations\n\n| Method | Path | Description | Bitrix24 Method |\n|--------|------|-------------|-----------------|\n| `GET` | `\u002Fv1\u002Fbizproc-activities` | Список зарегистрированных действий | `bizproc.activity.list` |\n| `POST` | `\u002Fv1\u002Fbizproc-activities` | Зарегистрировать действие | `bizproc.activity.add` |\n| `PATCH` | `\u002Fv1\u002Fbizproc-activities\u002F:code` | Обновить действие | `bizproc.activity.update` |\n| `DELETE` | `\u002Fv1\u002Fbizproc-activities\u002F:code` | Удалить действие | `bizproc.activity.delete` |\n| `POST` | `\u002Fv1\u002Fworkflows\u002Factivity-log` | Записать в журнал БП | `bizproc.activity.log` |\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## Examples\n\n### List\n\n```bash\ncurl -X GET 'https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fbizproc-activities' \\\n  -H 'X-Api-Key: YOUR_KEY' \\\n  -H 'Authorization: Bearer YOUR_TOKEN'\n```\n\nResponse: `{ \"success\": true, \"data\": [\"my_action_1\", \"my_action_2\"] }`\n\n### Create\n\n```bash\ncurl -X POST 'https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fbizproc-activities' \\\n  -H 'X-Api-Key: YOUR_KEY' \\\n  -H 'Authorization: Bearer YOUR_TOKEN' \\\n  -H 'Content-Type: application\u002Fjson' \\\n  -d '{\n    \"code\": \"my_custom_action\",\n    \"handler\": \"https:\u002F\u002Fmyapp.example.com\u002Fhandler\",\n    \"name\": {\"ru\": \"Мое действие\", \"en\": \"My Action\"},\n    \"useSubscription\": \"Y\",\n    \"properties\": {\n      \"message\": {\n        \"Name\": {\"ru\": \"Сообщение\"},\n        \"Type\": \"string\",\n        \"Required\": \"Y\"\n      }\n    },\n    \"returnProperties\": {\n      \"result\": {\n        \"Name\": {\"ru\": \"Результат\"},\n        \"Type\": \"string\"\n      }\n    }\n  }'\n```\n\n### Update\n\n```bash\ncurl -X PATCH 'https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fbizproc-activities\u002Fmy_custom_action' \\\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-handler\"}'\n```\n\n### Delete\n\n```bash\ncurl -X DELETE 'https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fbizproc-activities\u002Fmy_custom_action' \\\n  -H 'X-Api-Key: YOUR_KEY' \\\n  -H 'Authorization: Bearer YOUR_TOKEN'\n```\n\n### Activity Log\n\n```bash\ncurl -X POST 'https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fworkflows\u002Factivity-log' \\\n  -H 'X-Api-Key: YOUR_KEY' \\\n  -H 'Content-Type: application\u002Fjson' \\\n  -d '{\"eventToken\": \"TOKEN_FROM_HANDLER\", \"logMessage\": \"Processing complete\"}'\n```\n\n## Authorization\n\n`bizproc.activity.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` | Action with this CODE already registered |\n| `ERROR_ACTIVITY_VALIDATION_FAILURE` | Missing required fields or invalid values |\n| `ERROR_ACTIVITY_NOT_FOUND` | Action 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",{}]