#CRM Автоматизация

Запускайте CRM-триггеры и бизнес-процессы через API. Автоматизируйте воронку продаж, переводите сделки по стадиям, запускайте цепочки согласований — всё программно.

#Обзор

Automation API объединяет два направления автоматизации Битрикс24:

Триггеры (/v1/triggers/*) — точечный запуск CRM-триггеров. Переводят сделку на следующую стадию, запускают роботов. Обёртка над crm.automation.trigger.*.
Бизнес-процессы (/v1/workflows/*) — запуск, мониторинг и управление бизнес-процессами. Стартуют цепочки действий: согласования, уведомления, создание документов. Обёртка над bizproc.workflow.* и bizproc.event.*.

Требуемые скоупы: crm (триггеры), bizproc (бизнес-процессы)

Базовый URL: https://vibecode.bitrix24.tech/v1

Авторизация: заголовок X-Api-Key с вашим API-ключом.

#Быстрый старт

#1. Активируйте триггер для сделки

Terminal

curl -X POST https://vibecode.bitrix24.tech/v1/triggers/fire \
  -H "X-Api-Key: $VIBE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "entityType": "deal",
    "entityId": 100,
    "triggerId": "webhook_trigger_abc123"
  }'

Ответ:

JSON

{
  "success": true,
  "data": true
}

#2. Запустите бизнес-процесс

Terminal

curl -X POST https://vibecode.bitrix24.tech/v1/workflows/start \
  -H "X-Api-Key: $VIBE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "templateId": 15,
    "entityType": "deal",
    "entityId": 100,
    "parameters": {
      "approver": 1,
      "comment": "Согласование скидки 15%"
    }
  }'

Ответ:

JSON

{
  "success": true,
  "data": {
    "workflowId": "67a1b2c3d4e5f6"
  }
}

#Триггеры

#POST /v1/triggers/fire

Активирует CRM-триггер для указанной сущности. Триггер должен быть предварительно настроен в CRM-воронке Битрикс24.

Bitrix24 метод: crm.automation.trigger

Параметры:

Параметр	В	Тип	Обяз.	По умолч.	Описание
`entityType`	body	string	да	—	Тип сущности: `deal`, `lead`, `contact`, `company`
`entityId`	body	number	да	—	ID сущности в CRM
`triggerId`	body	string	да	—	Код триггера (из настроек автоматизации Битрикс24)

curl:

Terminal

curl -X POST https://vibecode.bitrix24.tech/v1/triggers/fire \
  -H "X-Api-Key: $VIBE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "entityType": "deal",
    "entityId": 100,
    "triggerId": "webhook_trigger_abc123"
  }'

JavaScript:

javascript

const res = await fetch('https://vibecode.bitrix24.tech/v1/triggers/fire', {
  method: 'POST',
  headers: {
    'X-Api-Key': VIBE_KEY,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    entityType: 'deal',
    entityId: 100,
    triggerId: 'webhook_trigger_abc123'
  })
})

const { success, data } = await res.json()
console.log('Trigger fired:', data) // true

Ответ:

JSON

{
  "success": true,
  "data": true
}