BusinessImprovement API — Автоматизация бизнеса

Введение

BusinessImprovement API предоставляет полный набор инструментов для программной автоматизации бизнес-процессов. Вы можете создавать сложные сценарии автоматизации, управлять задачами сотрудников, интегрироваться с CRM-системами, мессенджерами и платёжными шлюзами, а также получать детальные отчёты по эффективности.

Высокая скорость

Среднее время ответа < 120 мс. Обработка до 10 000 запросов в минуту.

Безопасность

OAuth 2.0, API-ключи с тонкой настройкой прав и IP-whitelist.

Вебхуки

Мгновенные уведомления о событиях. Надёжная доставка с retry-политикой.

Аутентификация

Все запросы к API должны включать заголовок Authorization с Bearer-токеном. Получить ключ можно в личном кабинете.

POST /auth/token

Требует API-ключ

// Запрос на получение Bearer-токена
curl -X POST https://api.businessimprovement.ru/v2/auth/token \
  -H "Content-Type: application/json" \
  -H "X-API-Key: bi_live_8f3a2c1d4e5b6f7a8b9c0d1e2f3a4b5c" \
  -d '{
    "grant_type": "client_credentials",
    "scope": "workflows:read tasks:write reports:read"
  }'

Ответ 200 OK

{
  "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "token_type": "Bearer",
  "expires_in": 3600,
  "scope": "workflows:read tasks:write reports:read"
}

Обработка ошибок

API возвращает стандартные HTTP-коды состояния. Тело ошибки содержит машиночитаемый код и описание.

Код	Значение	Описание
400	Bad Request	Некорректный запрос
401	Unauthorized	Недействительный токен
403	Forbidden	Недостаточно прав
404	Not Found	Ресурс не найден
429	Rate Limit	Превышен лимит запросов
500	Internal Error	Внутренняя ошибка сервера

Сценарии автоматизации

Сценарии (workflows) — это цепочки автоматических действий, запускаемые по триггеру: новое письмо, заполнение формы, вебхук, расписание.

                            GET
                            /workflows
                            Получить список сценариев
                        

                        {
  "data": [
    {
      "id": "wf_8a7b6c5d",
      "name": "Автоответ на заявку с сайта",
      "status": "active",
      "trigger": "form_submission",
      "steps_count": 4,
      "created_at": "2026-05-15T10:30:00Z"
    }
  ],
  "total": 12,
  "page": 1
}
                    

                            POST
                            /workflows
                            Создать новый сценарий
                        

                        // Тело запроса
{
  "name": "Уведомление в Telegram о новом лиде",
  "trigger": {
    "type": "crm_lead_created",
    "pipeline_id": "pipe_3f2a1b"
  },
  "steps": [
    {
      "type": "condition",
      "field": "lead.amount",
      "operator": "gte",
      "value": 50000
    },
    {
      "type": "notification",
      "channel": "telegram",
      "chat_id": "-1001234567890",
      "template": "🔥 Крупный лид: {{lead.name}} на сумму {{lead.amount}} ₽"
    }
  ]
}
                    

                            POST
                            /workflows/{id}/execute
                            Запустить сценарий вручную
                        

                        // Ответ
{
  "execution_id": "exec_f9e8d7c6",
  "workflow_id": "wf_8a7b6c5d",
  "status": "running",
  "started_at": "2026-06-06T14:22:00Z",
  "estimated_duration_ms": 450
}
                    

Управление задачами

API задач позволяет создавать, назначать и отслеживать выполнение задач сотрудниками в рамках автоматизированных процессов.

                            GET
                            /tasks
                            Список задач с фильтрацией
                        

                        // Параметры запроса
?status=pending&assignee=user_123&sort=-created_at&limit=25

// Ответ
{
  "data": [
    {
      "id": "task_4e2a1f",
      "title": "Проверить договор клиента",
      "status": "pending",
      "priority": "high",
      "assignee": { "id": "user_123", "name": "Анна Петрова" },
      "deadline": "2026-06-08T18:00:00Z"
    }
  ]
}
                    

                            PUT
                            /tasks/{id}/complete
                            Отметить задачу выполненной
                        

                        {
  "task_id": "task_4e2a1f",
  "status": "completed",
  "completed_by": "user_123",
  "completed_at": "2026-06-06T15:45:00Z",
  "comment": "Договор проверен, замечаний нет"
}
                    

Интеграции

Подключайте внешние сервисы: CRM (amoCRM, Bitrix24), мессенджеры (Telegram, WhatsApp), платёжные системы, 1С, Google Sheets.

                            GET
                            /integrations
                            Список активных интеграций
                        

                        {
  "integrations": [
    { "id": "int_crm_amo", "type": "crm", "provider": "amoCRM", "status": "connected" },
    { "id": "int_tg_bot", "type": "messenger", "provider": "Telegram", "status": "connected" },
    { "id": "int_1c", "type": "accounting", "provider": "1С:Предприятие", "status": "pending" }
  ]
}
                    

Отчёты

Генерируйте отчёты по эффективности автоматизации: выполненные сценарии, сэкономленное время, конверсия, статистика по задачам.

                            POST
                            /reports/generate
                            Сформировать отчёт
                        

                        // Запрос
{
  "type": "efficiency",
  "period": { "from": "2026-05-01", "to": "2026-06-01" },
  "format": "json"
}

// Ответ
{
  "report_id": "rpt_9c2d1a",
  "metrics": {
    "workflows_executed": 1847,
    "time_saved_hours": 326.5,
    "tasks_auto_completed": 1203,
    "error_rate": 0.4,
    "cost_savings_rub": 245000
  }
}
                    

Вебхуки

Настраивайте вебхуки для получения мгновенных уведомлений о событиях в реальном времени. Подпись запросов — HMAC-SHA256.

                            POST
                            /webhooks
                            Зарегистрировать вебхук
                        

                        // Пример payload вебхука (событие: task.completed)
{
  "event": "task.completed",
  "timestamp": "2026-06-06T15:45:00Z",
  "data": {
    "task_id": "task_4e2a1f",
    "workflow_id": "wf_8a7b6c5d",
    "completed_by": "user_123"
  },
  "signature": "sha256=9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08"
}
                    

                            DELETE
                            /webhooks/{id}
                            Удалить вебхук
                        

                        {
  "deleted": true,
  "webhook_id": "wh_7d3f2e",
  "deleted_at": "2026-06-06T16:00:00Z"
}
                    

Лимиты запросов

1 000

запросов / минуту

Тариф «Стандарт»

10 000

запросов / минуту

Тариф «Бизнес»

∞

индивидуально

Тариф «Enterprise»

API автоматизации бизнеса

Введение

Высокая скорость

Безопасность

Вебхуки

Аутентификация

Обработка ошибок

Сценарии автоматизации

Управление задачами

Интеграции

Отчёты

Вебхуки

Лимиты запросов