[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"docs-automation":3,"docs-tabs-automation":6},{"content":4,"lastmod":5},"\n# CRM Автоматизация\n\nЗапускайте CRM-триггеры и бизнес-процессы через API. Автоматизируйте воронку продаж, переводите сделки по стадиям, запускайте цепочки согласований программно.\n\n**Скоуп:** `crm` (триггеры), `bizproc` (бизнес-процессы) | **Базовый URL:** `https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1` | **Авторизация:** `X-Api-Key`\n\n## Разделы документации\n\n- [Триггеры](\u002Fdocs\u002Fautomation\u002Ftriggers) — активация CRM-триггеров для сущностей (2 эндпоинта).\n- [Бизнес-процессы](\u002Fdocs\u002Fautomation\u002Fworkflows) — запуск, мониторинг и управление бизнес-процессами (5 эндпоинтов).\n\n## Быстрый старт\n\n### Активировать CRM-триггер\n\n```bash\ncurl -X POST https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Ftriggers\u002Ffire \\\n  -H \"X-Api-Key: YOUR_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"entityType\": \"deal\",\n    \"entityId\": 100,\n    \"triggerId\": \"payment_received\"\n  }'\n```\n\nОтвет:\n\n```json\n{\n  \"success\": true,\n  \"data\": true\n}\n```\n\nПолная документация параметров и кодов ошибок: [`POST \u002Fv1\u002Ftriggers\u002Ffire`](\u002Fdocs\u002Fautomation\u002Ftriggers\u002Ffire)\n\n### Запустить бизнес-процесс\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 '{\n    \"templateId\": 15,\n    \"entityType\": \"deal\",\n    \"entityId\": 100,\n    \"parameters\": {\n      \"approver\": 1,\n      \"comment\": \"Согласование скидки 15%\"\n    }\n  }'\n```\n\nОтвет:\n\n```json\n{\n  \"success\": true,\n  \"data\": {\n    \"workflowId\": \"67a1b2c3d4e5f6\"\n  }\n}\n```\n\nПолная документация параметров и кодов ошибок: [`POST \u002Fv1\u002Fworkflows\u002Fstart`](\u002Fdocs\u002Fautomation\u002Fworkflows\u002Fstart)\n\n## Полный пример\n\nСценарий: сделка перешла в стадию «Оплачено» — активируем CRM-триггер, затем запускаем бизнес-процесс подготовки документов, отправляем событие для продолжения приостановленного процесса, завершаем ненужный экземпляр.\n\n```javascript\nconst VIBE_KEY = process.env.VIBE_KEY\nconst BASE = 'https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1'\n\nasync function api(method, path, body = null) {\n  const opts = {\n    method,\n    headers: { 'X-Api-Key': VIBE_KEY }\n  }\n  if (body) {\n    opts.headers['Content-Type'] = 'application\u002Fjson'\n    opts.body = JSON.stringify(body)\n  }\n  const res = await fetch(`${BASE}${path}`, opts)\n  return res.json()\n}\n\nconst dealId = 100\n\n\u002F\u002F 1. Сделка оплачена — активируем CRM-триггер\nawait api('POST', '\u002Ftriggers\u002Ffire', {\n  entityType: 'deal',\n  entityId: dealId,\n  triggerId: 'payment_received'\n})\nconsole.log('Триггер \"Оплата получена\" активирован')\n\n\u002F\u002F 2. Запускаем бизнес-процесс подготовки документов\nconst { data: wf } = await api('POST', '\u002Fworkflows\u002Fstart', {\n  templateId: 22,\n  entityType: 'deal',\n  entityId: dealId,\n  parameters: {\n    docType: 'act',\n    sendToClient: true\n  }\n})\nconsole.log('Бизнес-процесс запущен:', wf.workflowId)\n\n\u002F\u002F 3. Просматриваем запущенные экземпляры по шаблону\nconst { data: instances, meta } = await api('GET', '\u002Fworkflows?templateId=22')\nconsole.log(`Активных процессов по шаблону 22: ${meta.total}`)\nfor (const instance of instances) {\n  console.log(`  ${instance.ID}: started=${instance.STARTED}`)\n}\n\n\u002F\u002F 4. Отправляем событие в приостановленный процесс\n\u002F\u002F eventToken приходит на handler зарегистрированной активити из B24-callback\n\u002F\u002F (см. \u002Fdocs\u002Fentities\u002Fbizproc-activities), здесь — иллюстративное значение\nawait api('POST', '\u002Fworkflows\u002Fevent', {\n  eventToken: '55c1dc1c3f0d75.67',\n  returnValues: { approved: true },\n  logMessage: 'Автоматическое подтверждение — сумма в пределах лимита'\n})\nconsole.log('Событие отправлено, процесс продолжен')\n\n\u002F\u002F 5. Завершаем ненужный экземпляр\nawait fetch(`${BASE}\u002Fworkflows\u002F${wf.workflowId}`, {\n  method: 'DELETE',\n  headers: { 'X-Api-Key': VIBE_KEY }\n})\nconsole.log('Процесс завершён')\n```\n\n## Справочник эндпоинтов\n\n| Метод | Путь | Bitrix24 метод | Скоуп | Описание |\n|-------|------|---------------|-------|---------|\n| POST | [`\u002Fv1\u002Ftriggers\u002Ffire`](\u002Fdocs\u002Fautomation\u002Ftriggers\u002Ffire) | crm.automation.trigger | crm | Активировать CRM-триггер |\n| GET | [`\u002Fv1\u002Ftriggers`](\u002Fdocs\u002Fautomation\u002Ftriggers\u002Flist) | crm.automation.trigger.list | crm | Список триггеров портала |\n| POST | [`\u002Fv1\u002Fworkflows\u002Fstart`](\u002Fdocs\u002Fautomation\u002Fworkflows\u002Fstart) | bizproc.workflow.start | bizproc | Запустить бизнес-процесс |\n| GET | [`\u002Fv1\u002Fworkflows`](\u002Fdocs\u002Fautomation\u002Fworkflows\u002Flist) | bizproc.workflow.instances | bizproc | Список запущенных процессов |\n| DELETE | [`\u002Fv1\u002Fworkflows\u002F:id`](\u002Fdocs\u002Fautomation\u002Fworkflows\u002Fterminate) | bizproc.workflow.terminate \u002F kill | bizproc | Завершить бизнес-процесс |\n| POST | [`\u002Fv1\u002Fworkflows\u002Fevent`](\u002Fdocs\u002Fautomation\u002Fworkflows\u002Fevent) | bizproc.event.send | bizproc | Отправить событие в процесс |\n| POST | [`\u002Fv1\u002Fworkflows\u002Factivity-log`](\u002Fdocs\u002Fautomation\u002Fworkflows\u002Factivity-log) | bizproc.activity.log | bizproc | Записать в журнал процесса |\n\n## Коды ошибок\n\n### Ошибки автоматизации\n\n| HTTP | Код | Описание |\n|------|-----|---------|\n| 400 | `INVALID_ENTITY_TYPE` | Неизвестный тип сущности в `entityType`. Поддерживаются: `deal`, `lead`, `contact`, `company`, `quote`, `invoice` |\n| 400 | `MISSING_PARAMS` | Не переданы обязательные параметры (указаны в поле `message` ответа) |\n| 400 | `INVALID_PARAMS` | Некорректное значение параметра (возвращается Битрикс24) |\n| 401 | `TOKEN_MISSING` | API-ключ не имеет настроенных токенов Битрикс24 |\n| 403 | `SCOPE_DENIED` | API-ключ не имеет нужного скоупа: `crm` для триггеров, `bizproc` для бизнес-процессов |\n| 403 | `BITRIX_ACCESS_DENIED` | Портал Битрикс24 отклонил операцию — недостаточно прав на стороне портала |\n| 404 | `ENTITY_NOT_FOUND` | Сущность или шаблон с указанным ID не найден |\n| 422 | `BITRIX_ERROR` | Ошибка Битрикс24 REST API (подробности в поле `message`) |\n| 429 | `RATE_LIMITED` | Превышен лимит запросов. Подождите 1–2 секунды и повторите |\n| 429 | `QUEUE_TIMEOUT` | Запрос к Битрикс24 ожидал в очереди дольше 30 секунд. Запрос не был отправлен в Битрикс24 — безопасно повторить (`Retry-After`) |\n| 500 | `INTERNAL_ERROR` | Внутренняя ошибка сервера |\n| 502 | `BITRIX_UNAVAILABLE` | Портал Битрикс24 недоступен |\n| 503 | `BITRIX_TIMEOUT` | Битрикс24 принял запрос, но не ответил за 15 секунд. Для write-операций — сначала перечитайте сущность, изменение могло примениться |\n\nПолный справочник общих ошибок — [Ошибки](\u002Fdocs\u002Ferrors).\n\n## Смотрите также\n\n- [Сделки](\u002Fdocs\u002Fentities\u002Fdeals) — основная сущность для автоматизации воронки продаж\n- [Лиды](\u002Fdocs\u002Fentities\u002Fleads) — запуск триггеров и бизнес-процессов для лидов\n- [Шаблоны бизнес-процессов](\u002Fdocs\u002Fentities\u002Fbizproc-templates) — список шаблонов для параметра `templateId`\n- [Действия бизнес-процессов](\u002Fdocs\u002Fentities\u002Fbizproc-activities) — регистрация пользовательских действий\n- [Роботы](\u002Fdocs\u002Fentities\u002Fbizproc-robots) — регистрация пользовательских роботов\n- [Ошибки](\u002Fdocs\u002Ferrors) — полный справочник кодов ошибок\n","2026-07-07",{}]