[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"docs-automation\u002Ftriggers":3,"docs-tabs-automation\u002Ftriggers":6},{"content":4,"lastmod":5},"\n# Триггеры\n\nCRM-триггер — это условие автоматизации, привязанное к определённой стадии воронки. Когда вы активируете триггер через API для конкретной сущности, Битрикс24 выполняет все роботы и действия, настроенные на соответствующем шаге воронки: отправляет уведомления, меняет стадию, запускает бизнес-процессы.\n\nСписок доступных триггеров и их коды получают через [`GET \u002Fv1\u002Ftriggers`](\u002Fdocs\u002Fautomation\u002Ftriggers\u002Flist) — поле `CODE` ответа и есть `triggerId`. Используйте триггеры, когда внешняя система — платёжный шлюз, система учёта или CRM-интеграция — должна уведомить Битрикс24 о наступлении определённого события.\n\nBitrix24 API: `crm.automation.trigger.*`\nСкоуп: `crm`\n\n## Операции\n\n- [Активировать триггер](.\u002Ftriggers\u002Ffire.md) — `POST \u002Fv1\u002Ftriggers\u002Ffire`\n- [Список триггеров](.\u002Ftriggers\u002Flist.md) — `GET \u002Fv1\u002Ftriggers`\n\n## Пример активации\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- [CRM Автоматизация](\u002Fdocs\u002Fautomation) — обзор раздела и полный пример\n- [Бизнес-процессы](\u002Fdocs\u002Fautomation\u002Fworkflows) — запуск многошаговых сценариев\n","2026-07-07",{"triggers\u002Ffire.md":7,"triggers\u002Flist.md":8},"\n## Активировать триггер\n\n`POST \u002Fv1\u002Ftriggers\u002Ffire`\n\nОтправляет сигнал об активации автоматизации для заданной CRM-сущности. Битрикс24 запускает все роботы и действия, настроенные для указанного триггера на соответствующем шаге воронки.\n\n## Поля запроса (body)\n\n| Поле | Тип | Обяз. | Описание |\n|------|-----|:-----:|---------|\n| `entityType` | string | ★ | Тип CRM-сущности: `deal`, `lead`, `contact`, `company`, `quote`, `invoice`, `item` |\n| `entityId` | number | ★ | ID CRM-сущности. Источник: `GET \u002Fv1\u002Fdeals`, `GET \u002Fv1\u002Fleads`, `GET \u002Fv1\u002Fcontacts`, `GET \u002Fv1\u002Fcompanies`, `GET \u002Fv1\u002Fquotes`, `GET \u002Fv1\u002Finvoices`. Для `item` — ID элемента из `GET \u002Fv1\u002Fitems\u002F:entityTypeId` |\n| `entityTypeId` | number |  | ID типа смарт-процесса. Обязателен при `entityType: item`. Список типов: `GET \u002Fv1\u002Fsmart-processes` |\n| `triggerId` | string | ★ | Код триггера. Список кодов: [`GET \u002Fv1\u002Ftriggers`](\u002Fdocs\u002Fautomation\u002Ftriggers\u002Flist), поле `CODE` |\n\n## Примеры\n\n### curl — личный ключ\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 '{\"entityType\":\"deal\",\"entityId\":5141,\"triggerId\":\"payment_received\"}'\n```\n\n### curl — OAuth-приложение\n\n```bash\ncurl -X POST https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Ftriggers\u002Ffire \\\n  -H \"X-Api-Key: YOUR_APP_KEY\" \\\n  -H \"Authorization: Bearer USER_SESSION_TOKEN\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\"entityType\":\"deal\",\"entityId\":5141,\"triggerId\":\"payment_received\"}'\n```\n\n### JavaScript — личный ключ\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Ftriggers\u002Ffire', {\n  method: 'POST',\n  headers: {\n    'X-Api-Key': 'YOUR_API_KEY',\n    'Content-Type': 'application\u002Fjson',\n  },\n  body: JSON.stringify({\n    entityType: 'deal',\n    entityId: 5141,\n    triggerId: 'payment_received',\n  }),\n})\nconst data = await res.json()\nconsole.log(data.success, data.data) \u002F\u002F true, true\n```\n\n### curl — счёт (SmartInvoice)\n\nСчёт — это смарт-счёт (динамический тип CRM). Передайте `entityType: \"invoice\"` и ID счёта из `GET \u002Fv1\u002Finvoices`:\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 '{\"entityType\":\"invoice\",\"entityId\":42,\"triggerId\":\"payment_received\"}'\n```\n\n### JavaScript — OAuth-приложение\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Ftriggers\u002Ffire', {\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    entityType: 'deal',\n    entityId: 5141,\n    triggerId: 'payment_received',\n  }),\n})\nconst data = await res.json()\n```\n\n## Поля ответа\n\n| Поле | Тип | Описание |\n|------|-----|---------|\n| `success` | boolean | `true` при успешной отправке сигнала |\n| `data` | boolean | `true` — сигнал принят Битрикс24 |\n\n## Пример ответа\n\n```json\n{\n  \"success\": true,\n  \"data\": true\n}\n```\n\n## Пример ответа при ошибке\n\n400 — неизвестный тип сущности:\n\n```json\n{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"INVALID_ENTITY_TYPE\",\n    \"message\": \"Unknown entityType \\\"banana\\\". Supported: deal, lead, contact, company, quote, invoice, item\"\n  }\n}\n```\n\n## Ошибки\n\n| HTTP | Код | Описание |\n|------|-----|---------|\n| 400 | `MISSING_PARAMS` | Не передан обязательный параметр `entityType`, `entityId` или `triggerId`, либо указан `entityType: item` без `entityTypeId` |\n| 400 | `INVALID_ENTITY_TYPE` | Неизвестный тип сущности. Допустимые: `deal`, `lead`, `contact`, `company`, `quote`, `invoice`, `item` |\n| 400 | `INVALID_ENTITY_TYPE_ID` | `entityTypeId` относится к типу с выделенным `entityType` — используйте сам тип (`deal`, `lead`, `contact`, `company`, `quote` или `invoice` для `entityTypeId=31`) вместо `item` |\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` | Ключу не хватает скоупа `crm` |\n| 403 | `BITRIX_ACCESS_DENIED` | Битрикс24 отказал в доступе |\n| 404 | `ENTITY_NOT_FOUND` | Битрикс24 не нашёл цель сигнала — `entityId` некорректен, например нечисловой |\n| 429 | `RATE_LIMITED` | Превышен лимит запросов. Повторите через 1–2 секунды |\n| 502 | `BITRIX_UNAVAILABLE` | Битрикс24 недоступен |\n\nПолный список общих ошибок API — [Ошибки](\u002Fdocs\u002Ferrors).\n\n## Известные особенности\n\n- **Сигнал принимается независимо от настройки автоматизации.** Если для переданного `triggerId` на данном шаге воронки не настроены роботы, Битрикс24 всё равно возвращает `data: true` — ошибки не возникает.\n- **Существование сущности не проверяется.** Корректный числовой `entityId` принимается, даже если записи с таким ID нет — `fire` возвращает `data: true`, не проверяя получателя сигнала. Передавайте `entityId` из источников, указанных в полях запроса.\n\n## Смотрите также\n\n- [Список триггеров](\u002Fdocs\u002Fautomation\u002Ftriggers\u002Flist)\n- [CRM Автоматизация](\u002Fdocs\u002Fautomation)\n- [Бизнес-процессы](\u002Fdocs\u002Fautomation\u002Fworkflows)\n","\n## Список триггеров автоматизации\n\n`GET \u002Fv1\u002Ftriggers`\n\nВозвращает триггеры автоматизации, зарегистрированные текущим OAuth-приложением на портале. Доступен только с OAuth-ключом и активной пользовательской сессией.\n\n## Примеры\n\n### curl\n\n```bash\ncurl https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Ftriggers \\\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\u002Ftriggers', {\n  headers: {\n    'X-Api-Key': 'YOUR_APP_KEY',\n    'Authorization': 'Bearer USER_SESSION_TOKEN',\n  },\n})\nconst { data } = await res.json()\nconsole.log('Триггеры:', data)\n```\n\n## Поля ответа\n\n| Поле | Тип | Описание |\n|------|-----|---------|\n| `success` | boolean | `true` при успехе |\n| `data` | array | Массив триггеров, зарегистрированных приложением |\n| `data[].NAME` | string | Отображаемое название триггера |\n| `data[].CODE` | string | Код триггера — передаётся как `triggerId` в `POST \u002Fv1\u002Ftriggers\u002Ffire` |\n\n## Пример ответа\n\n```json\n{\n  \"success\": true,\n  \"data\": [\n    {\n      \"NAME\": \"Оплата получена\",\n      \"CODE\": \"payment_received\"\n    },\n    {\n      \"NAME\": \"Доставка подтверждена\",\n      \"CODE\": \"delivery_confirmed\"\n    }\n  ]\n}\n```\n\n## Пример ответа при ошибке\n\n403 — обращение с личным ключом: контекст приложения не установлен:\n\n```json\n{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"BITRIX_ACCESS_DENIED\",\n    \"message\": \"Access denied! Application context required\"\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` | У OAuth-ключа нет активной пользовательской сессии — не передан `Authorization: Bearer` |\n| 401 | `TOKEN_EXPIRED` | Пользовательская сессия истекла — повторите авторизацию через `\u002Fv1\u002Foauth\u002Fauthorize` |\n| 403 | `SCOPE_DENIED` | Ключу не хватает скоупа `crm` |\n| 403 | `BITRIX_ACCESS_DENIED` | Битрикс24 отказал в доступе: требуется контекст OAuth-приложения |\n| 429 | `RATE_LIMITED` | Превышен лимит запросов |\n| 502 | `BITRIX_UNAVAILABLE` | Битрикс24 недоступен |\n\nПолный список общих ошибок API — [Ошибки](\u002Fdocs\u002Ferrors).\n\n## Известные особенности\n\n- **Только для OAuth-приложений.** Запрос с личным ключом (`vibe_api_*`) возвращает `403 BITRIX_ACCESS_DENIED` — Битрикс24 требует контекст установленного OAuth-приложения. Для получения списка триггеров настройте OAuth-приложение и получите пользовательский токен через `\u002Fv1\u002Foauth\u002Fauthorize`.\n- **Только триггеры текущего приложения.** Возвращаются триггеры, зарегистрированные именно вызывающим OAuth-приложением, а не все триггеры портала.\n\n## Смотрите также\n\n- [Активировать триггер](\u002Fdocs\u002Fautomation\u002Ftriggers\u002Ffire)\n- [CRM Автоматизация](\u002Fdocs\u002Fautomation)\n- [Бизнес-процессы](\u002Fdocs\u002Fautomation\u002Fworkflows)\n"]