Канбан Битрикс24 превращается в кашу, когда стадии называют кто как захотел, а воронку правят все менеджеры подряд. Я настраивал доски сделок и задач на нескольких порталах, и путаница почти всегда растёт из одного места: колонка означает то действие менеджера, то состояние клиента, то этап внутри компании. Ниже описано, как я развожу сделки и задачи, называю стадии, закрываю сделки и отслеживаю перемещения карточек через REST.
Канбан-доска Битрикс24: чем доска сделок отличается от доски задач
В портале две разные доски, и логика у них разная. Сделки в CRM можно смотреть списком или канбаном, и колонка там означает стадию воронки, то есть состояние клиента в процессе продажи. Задачи тоже выводятся на канбан, но колонка там означает состояние работы: запланировано, в работе, сделано, либо срок выполнения. Когда эти смыслы смешивают, в стадиях сделки появляются «Позвонить» и «Ждём счёт», а в задачах «Клиент согласовал».
Перенос карточки между колонками это редактирование поля, а не рисование по доске. У сделки меняется стадия, и на это реагируют роботы и триггеры автоматизации, исходящие вебхуки и внешние скрипты. Поэтому каждую колонку я проектирую так, будто на неё уже навешено действие, даже если пока не навешено ничего.
Есть и техническая деталь, которая пригодится ниже. У сделки стадия хранится в поле stageId (в старых методах STAGE_ID), воронка в поле categoryId. Идентификаторы стадий в основной воронке короткие, например NEW, а в дополнительных идут с префиксом воронки, вроде C2:NEW. Если интеграция сравнивает стадии, сравнивать нужно эти идентификаторы, а не названия.
Стадии сделок на канбане: названия, порядок и финальные колонки
Правила, по которым я перебираю воронку у клиента, когда прошу «навести порядок»:
- Колонка описывает состояние клиента, а не действие менеджера. «Позвонить» это задача, а «Первичный контакт установлен» это факт, который можно проверить.
- У каждой стадии один критерий выхода. Если менеджер спрашивает, когда можно тянуть карточку дальше, критерий не сформулирован.
- Стадий в воронке 5-7. Это моя практика, не правило платформы: при большем числе доска уезжает в горизонтальную прокрутку, менеджеры перестают видеть хвост воронки, и сделки застревают справа.
- Ожидание не отдельная стадия. Если клиент думает три дня, сделка остаётся на своей стадии, а к ней привязана задача с крайним сроком. Колонка «Ждём клиента» за месяц превращается в кладбище.
- Финальных колонок две группы: успешная и провальные. Если причин провала три-четыре, я завожу отдельную провальную колонку под каждую. Причину видно на доске, а не после открытия каждой карточки. Стадии настраивает администратор CRM, и доступность такой схемы я проверяю на конкретном портале.
Вот как выглядит типичная правка названий:
| Название | Что с ним не так | Вариант |
|---|---|---|
| Позвонить | Действие, а не состояние сделки | Первичный контакт установлен |
| В работе | Подходит к любой сделке, критерия нет | Потребность выяснена |
| Ждём клиента | Ожидание, которое копится без срока | Остаётся прежняя стадия плюс задача со сроком |
| Договор | Непонятно, составлен он, отправлен или подписан | Договор на подписании |
Переименование стадии на сами карточки не влияет, идентификатор остаётся прежним. Ломаются самописные фильтры и выгрузки, которые сравнивают название текстом. Поэтому перед переименованием я спрашиваю, что подключено к воронке.
Бесплатный материал
🎁 Полезный скрипт в подарок
Подпишитесь на Telegram - пришлю готовый скрипт по этой теме.
Без спама. Отписка в 1 клик.
Задачи на канбане: личный план, сроки и стадии проекта
Канбан задач работает в нескольких режимах: личный план, разбивка по срокам и стадии внутри проекта. Состав режимов зависит от тарифа и версии портала, поэтому я проверяю его на конкретном портале, прежде чем обещать заказчику схему. Путаница начинается, когда всю команду сажают на один режим для всего.
Режим по срокам
В нём перетаскивание между колонками меняет крайний срок задачи. Сотрудник, который двигает карточку «для порядка», сдвигает дедлайн, а постановщик потом не понимает, почему срок уехал. На обучении я предупреждаю об этом отдельно.
Стадии проекта
Здесь колонки общие для проекта и отражают статус работы: «Бэклог», «В работе», «Проверка», «Готово». Для «Проверки» у меня всегда прописан критерий: кто именно её проводит, обычно постановщик. Иначе задачи копятся в этой колонке, потому что двигать их дальше некому.
Связка задачи со сделкой
Задачу можно привязать к сделке, и я использую это как правило разделения: сделка живёт в стадии, задача это шаг внутри стадии. Задача «Отправить КП» привязана к сделке на стадии «Потребность выяснена». Переход сделки дальше я оставляю за менеджером либо за явно прописанным правилом автоматизации, а не за тем, что кто-то закрыл задачу и забыл про доску.
Воронки и направления: сколько досок нужно на портале
Каждая воронка это отдельная доска сделок со своим набором стадий. Схемы, с которыми я сталкивался чаще всего:
| Схема | Когда подходит | Что ломается |
|---|---|---|
| Одна воронка на все продажи | Один продукт и один цикл сделки | При появлении второй линии продуктов половина колонок пустует, стадии становятся компромиссом |
| Воронка на продуктовую линию | Разные циклы сделки и разные команды | Изменение процесса приходится вносить в каждую воронку отдельно |
| Воронка на источник заявки | Сайт, звонки и партнёры обрабатываются по-разному | Один клиент попадает в две воронки, если нет правила поиска дублей |
Перенос сделки между воронками меняет идентификатор стадии, у нового будет другой префикс. Скрипты и роботы, привязанные к старой стадии, после такого переноса надо проверять. Сколько воронок доступно, зависит от тарифа, поэтому я сначала смотрю на процесс, а потом на подбор лицензии Битрикс24 под ваши процессы. Цену лицензии называю после обсуждения задачи.
Смена стадии на канбане: вебхук, REST и лимиты
Типовая просьба звучит так: менеджер перетащил карточку, и в Telegram должно прийти уведомление или в другой системе должна появиться запись. Для этого нужен исходящий вебхук. Он создаётся в Битрикс24 в разделе «Разработчикам > Другое > Исходящий вебхук»: указывается URL обработчика и событие, для примера ниже ONCRMDEALUPDATE, а поле «Токен приложения» генерируется автоматически.
Есть несколько особенностей, которые я проверил по справке и на практике:
- Событие
ONCRMDEALUPDATEсрабатывает на любое обновление сделки: сменили сумму, ответственного или комментарий, а обработчик уже вызван. Смену стадии приходится вычислять самому, сравнивая с прошлым значением. - Запрос приходит как
application/x-www-form-urlencoded, поэтому в PHP данные лежат в$_POST, а не в теле JSON. - Повторных отправок нет: если обработчик не ответил или вернул ошибку, событие не придёт снова. Когда потери недопустимы, справка отправляет к офлайн-событиям, которые забирают из очереди вручную.
- Нагрузку не регулировать: если в портале разом изменили тысячу сделок, обработчик получит тысячу вызовов.
- Метод
crm.deal.getпомечен как устаревший, вместо него используютcrm.item.getсentityTypeIdравным 2 для сделок.
Ниже обработчик на PHP, который принимает событие, запрашивает сделку и сравнивает стадию с последней сохранённой. Для него хватает обычного хостинга с PHP и MySQL, отдельный сервер не нужен. Таблица простая: deal_stage с полями deal_id (первичный ключ) и stage_id. Для запроса crm.item.get нужен входящий вебхук с правами на CRM: права задаются у входящего вебхука, у исходящего их нет.
<?php
// handler.php: приём исходящего вебхука Битрикс24 (ONCRMDEALUPDATE)
$appToken = 'токен_из_настроек_вебхука';
$hook = 'https://ваш-портал.bitrix24.ru/rest/1/КОД_ВХОДЯЩЕГО_ВЕБХУКА/';
if (($_POST['auth']['application_token'] ?? '') !== $appToken) {
http_response_code(403);
exit;
}
if (($_POST['event'] ?? '') !== 'ONCRMDEALUPDATE') {
exit;
}
$dealId = (int)($_POST['data']['FIELDS']['ID'] ?? 0);
if ($dealId === 0) {
exit;
}
$ch = curl_init($hook . 'crm.item.get.json');
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
CURLOPT_POSTFIELDS => json_encode(['entityTypeId' => 2, 'id' => $dealId]),
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 10,
]);
$answer = json_decode(curl_exec($ch), true);
curl_close($ch);
$stage = $answer['result']['item']['stageId'] ?? '';
if ($stage === '') {
exit;
}
$pdo = new PDO('mysql:host=localhost;dbname=crm_log;charset=utf8mb4', 'user', 'password');
$select = $pdo->prepare('SELECT stage_id FROM deal_stage WHERE deal_id = ?');
$select->execute([$dealId]);
$prev = $select->fetchColumn();
if ($prev !== $stage) {
$pdo->prepare('REPLACE INTO deal_stage (deal_id, stage_id) VALUES (?, ?)')
->execute([$dealId, $stage]);
// здесь уведомление в Telegram или запись в журнал переходов
}
http_response_code(200);
Обработчик делает один запрос к Битрикс24 и одну запись в базу, то есть укладывается в доли секунды. Если позже понадобится обходить много сделок, например пересчитать стадии по всему портале, учитывайте лимиты REST. По справке для тарифов кроме «Энтерпрайз» это 2 запроса в секунду с накопительным порогом 50, при превышении приходит статус 503 и ошибка QUERY_LIMIT_EXCEEDED. Пакетный метод batch передаёт до 50 вызовов в одном запросе, но лимит ресурсоёмкости методов он не отменяет. Отдельно есть ограничение по накопленному времени выполнения метода: при его превышении приходит статус 429 и код OPERATION_TIME_LIMIT.
Когда сценарий состоит из нескольких шагов и сервисов, например смена стадии, затем запись в таблицу, затем сообщение в чат, я собираю его в n8n, так удобнее видеть цепочку целиком. Для одного уведомления PHP-обработчика достаточно. Если хотите, чтобы я посмотрел вашу воронку и схему стадий, консультация стоит от 3 000 ₽.
Условия и возможности Битрикс24 меняются, поэтому перед запуском я сверяюсь с актуальной справкой Битрикс24 и настройками вашего тарифа.
Частые вопросы
Можно ли создавать задачи автоматически при переходе сделки на другую стадию?
Да, для этого на стадии настраивают робота автоматизации, который ставит задачу ответственному за сделку. Я обычно добавляю в такую задачу крайний срок и привязку к сделке, чтобы она не висела без контекста.
Как узнать, кто и когда перенёс карточку сделки?
Изменения стадий фиксируются в истории сделки, её видно в самой карточке. Если нужна собственная таблица переходов, например для отчёта по времени на стадии, используйте вебхук и запись в базу, как в примере выше.
Нужен ли вебхук, если надо просто получать уведомление о смене стадии?
Нет. Если уведомление нужно внутри портала, хватает робота на стадии. Вебхук нужен, когда данные должны уйти во внешнюю систему: Telegram-бота, учётную программу или сайт.