
# Бизнес-процессы

Бизнес-процесс — это многошаговый сценарий, выполняемый над документом Битрикс24. В отличие от CRM-триггеров, которые мгновенно меняют состояние сущности, бизнес-процесс может включать паузы для ожидания внешних событий, ветвление по условиям, параллельные ветви и задержки. Типичные сценарии: цепочки согласований, автоматическая подготовка документов, уведомления по расписанию.

Жизненный цикл: запуск (`start`) → выполнение → просмотр экземпляров (`list`) → обработка приостановок через событие (`event`) или запись в журнал (`activity-log`) → завершение (`terminate`).

Bitrix24 API: `bizproc.workflow.*`, `bizproc.event.*`, `bizproc.activity.*`
Скоуп: `bizproc`

## Операции

- [Запустить бизнес-процесс](./workflows/start.md) — `POST /v1/workflows/start`
- [Список запущенных процессов](./workflows/list.md) — `GET /v1/workflows`
- [Завершить бизнес-процесс](./workflows/terminate.md) — `DELETE /v1/workflows/:id`
- [Отправить событие в процесс](./workflows/event.md) — `POST /v1/workflows/event`
- [Записать в журнал процесса](./workflows/activity-log.md) — `POST /v1/workflows/activity-log`

## Шаблоны и роботы требуют ключ авторизации

`GET/POST/PATCH/DELETE /v1/bizproc-templates` и `GET/POST/PATCH/DELETE /v1/bizproc-robots` работают **только с ключом авторизации** `vibe_app_…` вместе с заголовком `Authorization: Bearer`. С API-ключом `vibe_api_…` запрос отклоняется с `403 OAUTH_REQUIRED` — этим методам нужен контекст приложения. Подробнее о типах ключей — [Ключи и авторизация](/docs/keys-auth).

Эндпоинты запуска, остановки и мониторинга процессов (`/v1/workflows/*`) работают с обоими типами ключей.

## Смотрите также

- [CRM Автоматизация](/docs/automation)
- [Триггеры](/docs/automation/triggers)
- [Шаблоны бизнес-процессов](/docs/entities/bizproc-templates)
