1С Битрикс · 7 мин чтения

Канбан Битрикс24: сделки и задачи на доске без путаницы в стадиях

Канбан Битрикс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-бота, учётную программу или сайт.

Есть задача?

Обсудим в мессенджере

Расскажите, что нужно сделать — отвечу в течение 4 часов в рабочее время. Первая консультация бесплатно.

Продолжая пользование настоящим сайтом Вы выражаете своё согласие на обработку Ваших персональных данных (файлов куки) с использованием Yandex.Metrika.
Понятно