[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"docs-automation\u002Fworkflows":3,"docs-tabs-automation\u002Fworkflows":6},{"content":4,"lastmod":5},"\n# Бизнес-процессы\n\nБизнес-процесс — это многошаговый сценарий, выполняемый над документом Битрикс24. В отличие от CRM-триггеров, которые мгновенно меняют состояние сущности, бизнес-процесс может включать паузы для ожидания внешних событий, ветвление по условиям, параллельные ветви и задержки. Типичные сценарии: цепочки согласований, автоматическая подготовка документов, уведомления по расписанию.\n\nЖизненный цикл: запуск (`start`) → выполнение → просмотр экземпляров (`list`) → обработка приостановок через событие (`event`) или запись в журнал (`activity-log`) → завершение (`terminate`).\n\nBitrix24 API: `bizproc.workflow.*`, `bizproc.event.*`, `bizproc.activity.*`\nСкоуп: `bizproc`\n\n## Операции\n\n- [Запустить бизнес-процесс](.\u002Fworkflows\u002Fstart.md) — `POST \u002Fv1\u002Fworkflows\u002Fstart`\n- [Список запущенных процессов](.\u002Fworkflows\u002Flist.md) — `GET \u002Fv1\u002Fworkflows`\n- [Завершить бизнес-процесс](.\u002Fworkflows\u002Fterminate.md) — `DELETE \u002Fv1\u002Fworkflows\u002F:id`\n- [Отправить событие в процесс](.\u002Fworkflows\u002Fevent.md) — `POST \u002Fv1\u002Fworkflows\u002Fevent`\n- [Записать в журнал процесса](.\u002Fworkflows\u002Factivity-log.md) — `POST \u002Fv1\u002Fworkflows\u002Factivity-log`\n\n## Шаблоны и роботы требуют ключ авторизации\n\n`GET\u002FPOST\u002FPATCH\u002FDELETE \u002Fv1\u002Fbizproc-templates` и `GET\u002FPOST\u002FPATCH\u002FDELETE \u002Fv1\u002Fbizproc-robots` работают **только с ключом авторизации** (`vibe_app_…` + `Authorization: Bearer`). С API-ключом (`vibe_api_…`) Битрикс24 возвращает `ACCESS_DENIED` — ограничение на стороне Битрикс24. Подробнее о типах ключей — [Ключи и авторизация](\u002Fdocs\u002Fkeys-auth).\n\nЭндпоинты запуска, остановки и мониторинга процессов (`\u002Fv1\u002Fworkflows\u002F*`) работают с обоими типами ключей.\n\n## Смотрите также\n\n- [CRM Автоматизация](\u002Fdocs\u002Fautomation) — обзор раздела и полный пример\n- [Триггеры](\u002Fdocs\u002Fautomation\u002Ftriggers) — точечная активация автоматизации\n- [Шаблоны бизнес-процессов](\u002Fdocs\u002Fentities\u002Fbizproc-templates) — список шаблонов для `templateId`\n","2026-07-07",{"workflows\u002Fstart.md":7,"workflows\u002Flist.md":8,"workflows\u002Fterminate.md":9,"workflows\u002Fevent.md":10,"workflows\u002Factivity-log.md":11},"\n## Запустить бизнес-процесс\n\n`POST \u002Fv1\u002Fworkflows\u002Fstart`\n\nЗапускает экземпляр бизнес-процесса по шаблону для указанной CRM-сущности. Возвращает уникальный идентификатор запущенного экземпляра.\n\n## Поля запроса (body)\n\n| Поле | Тип | Обяз. | Описание |\n|------|-----|:-----:|---------|\n| `templateId` | number | ★ | ID шаблона бизнес-процесса. Источник: `GET \u002Fv1\u002Fentities\u002Fbizproc-templates` |\n| `entityType` | string | ★ | Тип CRM-сущности: `deal`, `lead`, `contact`, `company` |\n| `entityId` | number | ★ | ID CRM-сущности. Источник: `GET \u002Fv1\u002Fdeals`, `GET \u002Fv1\u002Fleads`, `GET \u002Fv1\u002Fcontacts`, `GET \u002Fv1\u002Fcompanies` |\n| `parameters` | object | нет | Значения параметров шаблона. Набор полей определяется конкретным шаблоном в Битрикс24 |\n\n## Примеры\n\n### curl — личный ключ\n\n```bash\ncurl -X POST https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fworkflows\u002Fstart \\\n  -H \"X-Api-Key: YOUR_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\"templateId\":713,\"entityType\":\"deal\",\"entityId\":5141}'\n```\n\n### curl — OAuth-приложение\n\n```bash\ncurl -X POST https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fworkflows\u002Fstart \\\n  -H \"X-Api-Key: YOUR_APP_KEY\" \\\n  -H \"Authorization: Bearer USER_SESSION_TOKEN\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\"templateId\":713,\"entityType\":\"deal\",\"entityId\":5141}'\n```\n\n### JavaScript — личный ключ\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fworkflows\u002Fstart', {\n  method: 'POST',\n  headers: {\n    'X-Api-Key': 'YOUR_API_KEY',\n    'Content-Type': 'application\u002Fjson',\n  },\n  body: JSON.stringify({\n    templateId: 713,\n    entityType: 'deal',\n    entityId: 5141,\n  }),\n})\nconst data = await res.json()\nconsole.log(data.data.workflowId)\n```\n\n### JavaScript — OAuth-приложение\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fworkflows\u002Fstart', {\n  method: 'POST',\n  headers: {\n    'X-Api-Key': 'YOUR_APP_KEY',\n    'Authorization': 'Bearer USER_SESSION_TOKEN',\n    'Content-Type': 'application\u002Fjson',\n  },\n  body: JSON.stringify({\n    templateId: 713,\n    entityType: 'deal',\n    entityId: 5141,\n  }),\n})\nconst data = await res.json()\n```\n\n## Поля ответа\n\n| Поле | Тип | Описание |\n|------|-----|---------|\n| `success` | boolean | `true` при успешном запуске |\n| `data.workflowId` | string | Уникальный идентификатор запущенного экземпляра бизнес-процесса |\n\n## Пример ответа\n\n`HTTP 201 Created`\n\n```json\n{\n  \"success\": true,\n  \"data\": {\n    \"workflowId\": \"69f0c2d5ade389.22457798\"\n  }\n}\n```\n\n## Пример ответа при ошибке\n\n400 — не переданы обязательные параметры:\n\n```json\n{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"MISSING_PARAMS\",\n    \"message\": \"Required: templateId (number), entityType (\\\"deal\\\"|\\\"lead\\\"|\\\"contact\\\"|\\\"company\\\"), entityId (number)\"\n  }\n}\n```\n\n## Ошибки\n\n| HTTP | Код | Описание |\n|------|-----|---------|\n| 400 | `MISSING_PARAMS` | Не передан один или несколько обязательных параметров: `templateId`, `entityType`, `entityId` |\n| 401 | `MISSING_API_KEY` | Не передан заголовок `X-Api-Key` |\n| 401 | `INVALID_API_KEY` | Неверный или недействительный API-ключ |\n| 401 | `TOKEN_MISSING` | У ключа нет подключённых токенов Битрикс24 |\n| 401 | `TOKEN_EXPIRED` | Пользовательская сессия OAuth истекла — повторите авторизацию через `\u002Fv1\u002Foauth\u002Fauthorize` |\n| 403 | `SCOPE_DENIED` | Ключу не хватает скоупа `bizproc` |\n| 403 | `BITRIX_ACCESS_DENIED` | Битрикс24 отказал в доступе |\n| 422 | `BITRIX_ERROR` | Ошибка на стороне Битрикс24 — например, шаблон с указанным `templateId` не найден |\n| 429 | `RATE_LIMITED` | Превышен лимит запросов. Повторите через 1–2 секунды |\n| 502 | `BITRIX_UNAVAILABLE` | Битрикс24 недоступен |\n\nПолный список общих ошибок API — [Ошибки](\u002Fdocs\u002Ferrors).\n\n## Известные особенности\n\n- **Один шаблон — несколько экземпляров.** Один и тот же `templateId` можно запустить для разных сущностей одновременно. Каждый запуск получает отдельный уникальный `workflowId`.\n\n## Смотрите также\n\n- [Список запущенных процессов](\u002Fdocs\u002Fautomation\u002Fworkflows\u002Flist)\n- [Завершить бизнес-процесс](\u002Fdocs\u002Fautomation\u002Fworkflows\u002Fterminate)\n- [Бизнес-процессы](\u002Fdocs\u002Fautomation\u002Fworkflows)\n- [Шаблоны бизнес-процессов](\u002Fdocs\u002Fentities\u002Fbizproc-templates) — источник `templateId`\n","\n## Список запущенных бизнес-процессов\n\n`GET \u002Fv1\u002Fworkflows`\n\nВозвращает запущенные экземпляры бизнес-процессов на портале, отсортированные по дате изменения (сначала новые).\n\n## Параметры\n\n| Параметр | Тип | Описание |\n|----------|-----|---------|\n| `templateId` | number | Фильтр по ID шаблона бизнес-процесса |\n| `startedBy` | number | Фильтр по ID пользователя, запустившего процесс |\n| `offset` | number | Смещение для пагинации. По умолчанию 0 |\n\n## Примеры\n\n### curl — личный ключ\n\n```bash\ncurl https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fworkflows \\\n  -H \"X-Api-Key: YOUR_API_KEY\"\n```\n\n### curl — OAuth-приложение\n\n```bash\ncurl https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fworkflows \\\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\u002Fworkflows', {\n  headers: { 'X-Api-Key': 'YOUR_API_KEY' },\n})\nconst { data, meta } = await res.json()\nconsole.log(`Процессов: ${meta.total}`, data)\n```\n\n### JavaScript — OAuth-приложение\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fworkflows', {\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| `success` | boolean | Всегда `true` при успехе |\n| `data` | array | Массив экземпляров бизнес-процессов |\n| `data[].ID` | string | Уникальный идентификатор экземпляра |\n| `data[].MODIFIED` | string | Дата последнего изменения (ISO 8601) |\n| `data[].OWNED_UNTIL` | string \\| null | Дата блокировки на выполнение текущего шага; `null` если не заблокирован |\n| `data[].MODULE_ID` | string | Модуль сущности (например `crm`) |\n| `data[].ENTITY` | string | Класс документа (например `CCrmDocumentDeal`) |\n| `data[].DOCUMENT_ID` | string | Идентификатор документа в формате `TYPENAME_ID` (например `DEAL_5141`) |\n| `data[].STARTED` | string | Дата запуска (ISO 8601) |\n| `data[].STARTED_BY` | string | ID пользователя, запустившего процесс (`\"0\"` — системный запуск) |\n| `data[].TEMPLATE_ID` | string | ID шаблона бизнес-процесса |\n| `meta.total` | number | Общее количество найденных экземпляров |\n\n## Пример ответа\n\n```json\n{\n  \"success\": true,\n  \"data\": [\n    {\n      \"ID\": \"69f0c2d5ade389.22457798\",\n      \"MODIFIED\": \"2026-04-28T17:23:17+03:00\",\n      \"OWNED_UNTIL\": null,\n      \"MODULE_ID\": \"crm\",\n      \"ENTITY\": \"CCrmDocumentDeal\",\n      \"DOCUMENT_ID\": \"DEAL_5141\",\n      \"STARTED\": \"2026-04-28T17:23:17+03:00\",\n      \"STARTED_BY\": \"0\",\n      \"TEMPLATE_ID\": \"713\"\n    }\n  ],\n  \"meta\": {\n    \"total\": 1\n  }\n}\n```\n\n## Пример ответа при ошибке\n\n403 — нет скоупа `bizproc`:\n\n```json\n{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"SCOPE_DENIED\",\n    \"message\": \"This endpoint requires 'bizproc' scope\"\n  }\n}\n```\n\n## Ошибки\n\n| HTTP | Код | Описание |\n|------|-----|---------|\n| 401 | `MISSING_API_KEY` | Не передан заголовок `X-Api-Key` |\n| 401 | `INVALID_API_KEY` | Неверный или недействительный API-ключ |\n| 401 | `TOKEN_MISSING` | У ключа нет подключённых токенов Битрикс24 |\n| 401 | `TOKEN_EXPIRED` | Пользовательская сессия OAuth истекла — повторите авторизацию через `\u002Fv1\u002Foauth\u002Fauthorize` |\n| 403 | `SCOPE_DENIED` | Ключу не хватает скоупа `bizproc` |\n| 403 | `BITRIX_ACCESS_DENIED` | Битрикс24 отказал в доступе |\n| 429 | `RATE_LIMITED` | Превышен лимит запросов. Повторите через 1–2 секунды |\n| 502 | `BITRIX_UNAVAILABLE` | Битрикс24 недоступен |\n\nПолный список общих ошибок API — [Ошибки](\u002Fdocs\u002Ferrors).\n\n## Известные особенности\n\n- **`DOCUMENT_ID` — строка, не массив.** Поле возвращается строкой в формате `\"TYPENAME_ID\"` (например `\"DEAL_5141\"`), а не массивом. При запуске процесса через `POST \u002Fv1\u002Fworkflows\u002Fstart` идентификатор документа передаётся в Битрикс24 массивом, однако в ответе этого эндпоинта он нормализован к строке.\n\n## Смотрите также\n\n- [Запустить бизнес-процесс](\u002Fdocs\u002Fautomation\u002Fworkflows\u002Fstart)\n- [Завершить бизнес-процесс](\u002Fdocs\u002Fautomation\u002Fworkflows\u002Fterminate)\n- [Бизнес-процессы](\u002Fdocs\u002Fautomation\u002Fworkflows)\n","\n## Завершить бизнес-процесс\n\n`DELETE \u002Fv1\u002Fworkflows\u002F:id`\n\nЗавершает запущенный экземпляр бизнес-процесса. По умолчанию выполняет мягкое завершение — дожидается окончания текущего шага. С параметром `?force=true` принудительно прерывает процесс немедленно.\n\n## Параметры\n\n| Параметр | В | Тип | Обяз. | Описание |\n|----------|---|-----|:-----:|---------|\n| `id` | path | string | да | Идентификатор экземпляра бизнес-процесса. Источник: `GET \u002Fv1\u002Fworkflows`, поле `ID` |\n| `force` | query | string | нет | `true` — принудительное завершение без ожидания текущего шага |\n| `status` | query | string | нет | Причина завершения — произвольный текст, передаётся в Битрикс24 |\n\n## Примеры\n\n### curl — личный ключ\n\n```bash\ncurl -X DELETE https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fworkflows\u002F69f0c2d5ade389.22457798 \\\n  -H \"X-Api-Key: YOUR_API_KEY\"\n```\n\n### curl — OAuth-приложение\n\n```bash\ncurl -X DELETE https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fworkflows\u002F69f0c2d5ade389.22457798 \\\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(\n  'https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fworkflows\u002F69f0c2d5ade389.22457798',\n  { method: 'DELETE', headers: { 'X-Api-Key': 'YOUR_API_KEY' } }\n)\nif (res.status === 204) {\n  console.log('Бизнес-процесс завершён')\n}\n```\n\n### JavaScript — OAuth-приложение\n\n```javascript\nconst res = await fetch(\n  'https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fworkflows\u002F69f0c2d5ade389.22457798',\n  {\n    method: 'DELETE',\n    headers: {\n      'X-Api-Key': 'YOUR_APP_KEY',\n      'Authorization': 'Bearer USER_SESSION_TOKEN',\n    },\n  }\n)\nif (res.status === 204) {\n  console.log('Бизнес-процесс завершён')\n}\n```\n\n## Ответ\n\nПри успешном завершении возвращается HTTP-статус `204 No Content` с пустым телом. Признак успеха — код ответа, не содержимое.\n\n## Пример ответа\n\n```\nHTTP\u002F1.1 204 No Content\n```\n\n## Пример ответа при ошибке\n\n404 — экземпляр не найден:\n\n```json\n{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"ENTITY_NOT_FOUND\",\n    \"message\": \"Бизнес-процесс не найден\"\n  }\n}\n```\n\n## Ошибки\n\n| HTTP | Код | Описание |\n|------|-----|---------|\n| 401 | `MISSING_API_KEY` | Не передан заголовок `X-Api-Key` |\n| 401 | `INVALID_API_KEY` | Неверный или недействительный API-ключ |\n| 401 | `TOKEN_MISSING` | У ключа нет подключённых токенов Битрикс24 |\n| 401 | `TOKEN_EXPIRED` | Пользовательская сессия OAuth истекла — повторите авторизацию через `\u002Fv1\u002Foauth\u002Fauthorize` |\n| 403 | `SCOPE_DENIED` | Ключу не хватает скоупа `bizproc` |\n| 403 | `BITRIX_ACCESS_DENIED` | Битрикс24 отказал в доступе |\n| 404 | `ENTITY_NOT_FOUND` | Экземпляр бизнес-процесса с указанным `id` не найден |\n| 429 | `RATE_LIMITED` | Превышен лимит запросов. Повторите через 1–2 секунды |\n| 502 | `BITRIX_UNAVAILABLE` | Битрикс24 недоступен |\n\nПолный список общих ошибок API — [Ошибки](\u002Fdocs\u002Ferrors).\n\n## Смотрите также\n\n- [Список запущенных процессов](\u002Fdocs\u002Fautomation\u002Fworkflows\u002Flist)\n- [Запустить бизнес-процесс](\u002Fdocs\u002Fautomation\u002Fworkflows\u002Fstart)\n- [Бизнес-процессы](\u002Fdocs\u002Fautomation\u002Fworkflows)\n","\n## Отправить событие в процесс\n\n`POST \u002Fv1\u002Fworkflows\u002Fevent`\n\nПередаёт выходные значения в приостановленный бизнес-процесс и возобновляет его выполнение. После вызова процесс продолжает работу с переданными значениями в выходных параметрах действия.\n\n## Поля запроса (body)\n\n| Поле | Тип | Обяз. | Описание |\n|------|-----|:-----:|---------|\n| `eventToken` | string | ★ | Одноразовый токен приостановленного процесса. Битрикс24 присылает его на `handler` зарегистрированного действия — см. [`\u002Fv1\u002Fbizproc-activities`](\u002Fdocs\u002Fentities\u002Fbizproc-activities) или [`\u002Fv1\u002Fbizproc-robots`](\u002Fdocs\u002Fentities\u002Fbizproc-robots) |\n| `returnValues` | object | нет | Значения выходных параметров активности. По умолчанию — `{}` |\n| `logMessage` | string | нет | Сообщение для журнала выполнения процесса |\n\n## Примеры\n\n### curl — личный ключ\n\n```bash\ncurl -X POST https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fworkflows\u002Fevent \\\n  -H \"X-Api-Key: YOUR_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\"eventToken\":\"xxx.yyy.zzz\",\"returnValues\":{\"result\":\"approved\"}}'\n```\n\n### curl — OAuth-приложение\n\n```bash\ncurl -X POST https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fworkflows\u002Fevent \\\n  -H \"X-Api-Key: YOUR_APP_KEY\" \\\n  -H \"Authorization: Bearer USER_SESSION_TOKEN\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\"eventToken\":\"xxx.yyy.zzz\",\"returnValues\":{\"result\":\"approved\"}}'\n```\n\n### JavaScript — личный ключ\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fworkflows\u002Fevent', {\n  method: 'POST',\n  headers: {\n    'X-Api-Key': 'YOUR_API_KEY',\n    'Content-Type': 'application\u002Fjson',\n  },\n  body: JSON.stringify({\n    eventToken: 'xxx.yyy.zzz',\n    returnValues: { result: 'approved' },\n  }),\n})\nconst data = await res.json()\nconsole.log(data.success) \u002F\u002F true\n```\n\n### JavaScript — OAuth-приложение\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fworkflows\u002Fevent', {\n  method: 'POST',\n  headers: {\n    'X-Api-Key': 'YOUR_APP_KEY',\n    'Authorization': 'Bearer USER_SESSION_TOKEN',\n    'Content-Type': 'application\u002Fjson',\n  },\n  body: JSON.stringify({\n    eventToken: 'xxx.yyy.zzz',\n    returnValues: { result: 'approved' },\n  }),\n})\n```\n\n## Поля ответа\n\n| Поле | Тип | Описание |\n|------|-----|---------|\n| `success` | boolean | `true` при успешной доставке события |\n| `data` | boolean | `true` — событие принято и выполнение процесса возобновлено |\n\n## Пример ответа\n\n```json\n{\n  \"success\": true,\n  \"data\": true\n}\n```\n\n## Пример ответа при ошибке\n\n403 — недействительный токен:\n\n```json\n{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"BITRIX_ACCESS_DENIED\",\n    \"message\": \"Access denied!\"\n  }\n}\n```\n\n## Ошибки\n\n| HTTP | Код | Описание |\n|------|-----|---------|\n| 400 | `MISSING_PARAMS` | Не передан обязательный параметр `eventToken` |\n| 401 | `MISSING_API_KEY` | Не передан заголовок `X-Api-Key` |\n| 401 | `INVALID_API_KEY` | Неверный или недействительный API-ключ |\n| 401 | `TOKEN_MISSING` | У ключа нет подключённых токенов Битрикс24 |\n| 401 | `TOKEN_EXPIRED` | Пользовательская сессия OAuth истекла — повторите авторизацию через `\u002Fv1\u002Foauth\u002Fauthorize` |\n| 403 | `SCOPE_DENIED` | Ключу не хватает скоупа `bizproc` |\n| 403 | `BITRIX_ACCESS_DENIED` | Битрикс24 отклонил запрос — токен недействителен, истёк или уже использован |\n| 422 | `BITRIX_ERROR` | Ошибка на стороне Битрикс24 |\n| 429 | `RATE_LIMITED` | Превышен лимит запросов. Повторите через 1–2 секунды |\n| 502 | `BITRIX_UNAVAILABLE` | Битрикс24 недоступен |\n\nПолный список общих ошибок API — [Ошибки](\u002Fdocs\u002Ferrors).\n\n## Известные особенности\n\n- **`eventToken` — одноразовый.** Каждая приостановка бизнес-процесса генерирует новый токен. Токен становится недействительным сразу после вызова `\u002Fevent`.\n- **Отличие от `\u002Fv1\u002Fworkflows\u002Factivity-log`.** Оба эндпоинта принимают `eventToken`, но `\u002Fevent` завершает действие и возобновляет процесс с переданными `returnValues`, а `\u002Factivity-log` только записывает сообщение в журнал, не изменяя состояние процесса. Для протоколирования промежуточных шагов используйте `\u002Factivity-log`; для финального ответа — `\u002Fevent`.\n\n## Смотрите также\n\n- [Записать в журнал процесса](\u002Fdocs\u002Fautomation\u002Fworkflows\u002Factivity-log)\n- [Список запущенных процессов](\u002Fdocs\u002Fautomation\u002Fworkflows\u002Flist)\n- [Запустить бизнес-процесс](\u002Fdocs\u002Fautomation\u002Fworkflows\u002Fstart)\n- [Бизнес-процессы](\u002Fdocs\u002Fautomation\u002Fworkflows)\n- [Действия бизнес-процессов](\u002Fdocs\u002Fentities\u002Fbizproc-activities)\n","\n## Записать в журнал процесса\n\n`POST \u002Fv1\u002Fworkflows\u002Factivity-log`\n\nДобавляет сообщение в журнал выполнения бизнес-процесса, не изменяя его состояние. Действие остаётся приостановленным. Применяется для протоколирования промежуточных шагов пользовательского действия.\n\n## Поля запроса (body)\n\n| Поле | Тип | Обяз. | Описание |\n|------|-----|:-----:|---------|\n| `eventToken` | string | ★ | Одноразовый токен приостановленного процесса. Битрикс24 присылает его на `handler` зарегистрированного действия — см. [`\u002Fv1\u002Fbizproc-activities`](\u002Fdocs\u002Fentities\u002Fbizproc-activities) или [`\u002Fv1\u002Fbizproc-robots`](\u002Fdocs\u002Fentities\u002Fbizproc-robots) |\n| `logMessage` | string | ★ | Текст записи журнала. Отображается в журнале выполнения бизнес-процесса в Битрикс24 |\n\n## Примеры\n\n### curl — личный ключ\n\n```bash\ncurl -X POST https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fworkflows\u002Factivity-log \\\n  -H \"X-Api-Key: YOUR_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\"eventToken\":\"xxx.yyy.zzz\",\"logMessage\":\"Шаг 1 завершён, ожидаем подтверждение\"}'\n```\n\n### curl — OAuth-приложение\n\n```bash\ncurl -X POST https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fworkflows\u002Factivity-log \\\n  -H \"X-Api-Key: YOUR_APP_KEY\" \\\n  -H \"Authorization: Bearer USER_SESSION_TOKEN\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\"eventToken\":\"xxx.yyy.zzz\",\"logMessage\":\"Шаг 1 завершён, ожидаем подтверждение\"}'\n```\n\n### JavaScript — личный ключ\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fworkflows\u002Factivity-log', {\n  method: 'POST',\n  headers: {\n    'X-Api-Key': 'YOUR_API_KEY',\n    'Content-Type': 'application\u002Fjson',\n  },\n  body: JSON.stringify({\n    eventToken: 'xxx.yyy.zzz',\n    logMessage: 'Шаг 1 завершён, ожидаем подтверждение',\n  }),\n})\nconst data = await res.json()\nconsole.log(data.success) \u002F\u002F true\n```\n\n### JavaScript — OAuth-приложение\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fworkflows\u002Factivity-log', {\n  method: 'POST',\n  headers: {\n    'X-Api-Key': 'YOUR_APP_KEY',\n    'Authorization': 'Bearer USER_SESSION_TOKEN',\n    'Content-Type': 'application\u002Fjson',\n  },\n  body: JSON.stringify({\n    eventToken: 'xxx.yyy.zzz',\n    logMessage: 'Шаг 1 завершён, ожидаем подтверждение',\n  }),\n})\n```\n\n## Поля ответа\n\n| Поле | Тип | Описание |\n|------|-----|---------|\n| `success` | boolean | `true` при успешной записи в журнал |\n| `data` | null | Всегда `null` — эндпоинт не возвращает данных |\n\n## Пример ответа\n\n```json\n{\n  \"success\": true,\n  \"data\": null\n}\n```\n\n## Пример ответа при ошибке\n\n400 — не переданы обязательные параметры:\n\n```json\n{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"MISSING_PARAMS\",\n    \"message\": \"Required: eventToken (string), logMessage (string)\"\n  }\n}\n```\n\n## Ошибки\n\n| HTTP | Код | Описание |\n|------|-----|---------|\n| 400 | `MISSING_PARAMS` | Не передан `eventToken` или `logMessage` |\n| 401 | `MISSING_API_KEY` | Не передан заголовок `X-Api-Key` |\n| 401 | `INVALID_API_KEY` | Неверный или недействительный API-ключ |\n| 401 | `TOKEN_MISSING` | У ключа нет подключённых токенов Битрикс24 |\n| 401 | `TOKEN_EXPIRED` | Пользовательская сессия OAuth истекла — повторите авторизацию через `\u002Fv1\u002Foauth\u002Fauthorize` |\n| 403 | `SCOPE_DENIED` | Ключу не хватает скоупа `bizproc` |\n| 403 | `BITRIX_ACCESS_DENIED` | Битрикс24 отклонил запрос — токен недействителен, истёк или уже использован |\n| 422 | `BITRIX_ERROR` | Ошибка на стороне Битрикс24 |\n| 429 | `RATE_LIMITED` | Превышен лимит запросов. Повторите через 1–2 секунды |\n| 502 | `BITRIX_UNAVAILABLE` | Битрикс24 недоступен |\n\nПолный список общих ошибок API — [Ошибки](\u002Fdocs\u002Ferrors).\n\n## Известные особенности\n\n- **Несколько записей до финального события.** Один `eventToken` допускает многократные вызовы `\u002Factivity-log` — каждый добавляет отдельную запись в журнал. Для длительных операций это позволяет отражать прогресс пошагово, прежде чем вызвать [`\u002Fv1\u002Fworkflows\u002Fevent`](\u002Fdocs\u002Fautomation\u002Fworkflows\u002Fevent) и завершить действие.\n\n## Смотрите также\n\n- [Отправить событие в процесс](\u002Fdocs\u002Fautomation\u002Fworkflows\u002Fevent)\n- [Список запущенных процессов](\u002Fdocs\u002Fautomation\u002Fworkflows\u002Flist)\n- [Запустить бизнес-процесс](\u002Fdocs\u002Fautomation\u002Fworkflows\u002Fstart)\n- [Бизнес-процессы](\u002Fdocs\u002Fautomation\u002Fworkflows)\n- [Действия бизнес-процессов](\u002Fdocs\u002Fentities\u002Fbizproc-activities)\n"]