Bitrix24: вебхук
Используется входящий вебхук: панель вызывает Bitrix24 REST API. (Исходящий — когда Bitrix24 вызывает ваш сервер по событиям.)
Используется для ссылок на сделки и контакты в логах и статистике. Если не указан — берётся из URL вебхука.
Укажите адрес, по которому Bitrix24 может достучаться до панели. Нужен для подсказки URL при настройке исходящего вебхука в Bitrix24 (событие «Создание сделки»).
Если Bitrix24 при настройке исходящего вебхука выдаёт секретный ключ — вставьте его сюда. Запросы без подписи или с неверной подписью (X-Bitrix-Signature) будут отклоняться (403). Если поле пусто — проверка не выполняется.
При нескольких событиях по одной сделке распределение запустится один раз через указанное число секунд после последнего события. 0 — без задержки. Рекомендуется 3–5 сек.
Входящий вебхук (панель вызывает Bitrix24)
Создание: Bitrix24 → Приложения → Разработчикам → Другое → Входящий вебхук.
Права при создании входящего вебхука:
- crm — сделки, контакты, компании, воронки, стадии, таймлайн (назначение ответственного, комментарии)
- user — список пользователей (для синхронизации и выбора менеджеров)
- task — создание задач ответственному после распределения
Скопируйте сгенерированный URL в поле «URL вебхука» выше.
Исходящий вебхук (Bitrix24 вызывает панель при создании сделки)
Создание: Bitrix24 → Разработчикам → Исходящий вебхук (или в настройках CRM — автоматизации). Событие: Создание сделки (onCrmDealAdd). В поле «URL» вставьте адрес из блока «URL для вставки в Bitrix24» выше (или https://ваш-сервер/api/bitrix/webhook). После сохранения создайте сделку в Bitrix24 — панель получит запрос и запустит распределение.
Вход через Яндекс ID
Разрешённые email для входа. Только пользователи из этого списка смогут войти через Яндекс. При первом запуске добавьте хотя бы один email в .env: YANDEX_ALLOWED_EMAILS=admin@example.ru
Добавьте или удалите адреса и нажмите «Сохранить настройки» внизу страницы.
Часовой пояс
Время запуска и график смен считаются в выбранной зоне (например, 9:00 — это 9:00 по Москве).
Время распределения
Каждый день в это время (в выбранном часовом поясе) запускается автоматическое распределение сделок.
▶
Тест: запуск планировщика через 5 минут
Проверка, что сделки попадают в планировщик и что запуск по расписанию их распределяет. Делайте по шагам вручную.
- График работы: уберите менеджеров из смены на текущее время (удалите или измените слоты на сегодня).
- График работы: добавьте слоты на сегодня на время «через 5 минут», чтобы в момент запуска в смене были менеджеры.
- Bitrix24: создайте несколько сделок в воронке/стадиях из блока «Планировщик» ниже.
- Нажмите кнопку ниже — время запуска станет «через 5 минут», флаг «уже запускали сегодня» сбросится. При необходимости нажмите «Сохранить».
- Откройте главную: сделки должны быть в списке. Через ~5 минут в Bitrix24 у них появится ответственный.
Планировщик (главная страница)
Какие сделки распределять. Распределяются только сделки из выбранной воронки и стадий (вебхук, крон, «Распределить сейчас»). Сделки из других воронок и стадий не распределяются. По умолчанию — воронка продаж (0) и стадия «Новая заявка».
Сначала нажмите «Загрузить воронки и стадии» в блоке «Синхронизация с Bitrix24» ниже.
Удерживайте Ctrl/Cmd для выбора нескольких стадий. Пусто — только стадия «Новая заявка».
Исключить отдельные сделки из распределения можно кнопкой «Исключить» на странице Планировщик.
Синхронизация с Bitrix24
Загрузить пользователей (и выставить роли), воронки и стадии.
Поля сделки/контакта/компании для правил «По условиям полей» кэшируются отдельно (кнопка ниже).
После распределения
Действия после успешного назначения ответственного по сделке.
Если включено, при назначении ответственного по сделке тот же ответственный будет установлен у привязанного контакта.
Дубли контактов
Перед распределением проверять контакты с одинаковым телефоном или email. При наличии дублей — не распределять автоматически, подсветить для ручного назначения.
Дублем считается контакт из сделок, подходящих под любое из правил ниже. Сначала нажмите «Загрузить воронки и стадии» выше. Чтобы применить настройки — нажмите «Сохранить настройки» внизу страницы.
Звонковые сделки (телефония)
Для сделок с источником «звонок» (SOURCE_ID=CALL) не распределять сразу: подождать и перечитать сделку. Если в названии статус «Принят» — не распределять (ответил менеджер). Если «Пропущенный звонок» — распределить. Задержка и уведомления применяются только к сделкам из воронки и стадий, заданных в блоке «Планировщик» выше (воронка продажи, этап 0 и т.д.). Остальные звонковые сделки обрабатываются как обычные.
Уведомления в Telegram
Отправка сообщений в чат при выбранных событиях. Создайте бота через @BotFather, укажите токен и Chat ID (личный или группы).
Ежедневный отчёт (Daily Report)
Публичная страница /daily-report.html — показатели менеджеров за день: звонки (кол-во и длительность с индикатором к норме), переводы сделок на этапы. Только менеджеры (роль из раздела «Пользователи»). Сначала нажмите «Загрузить воронки и стадии» выше.
Выберите воронку и стадию. Подпись — название столбца. Поле для суммы — из полей карточки сделки (например, Сумма); тогда под количеством отобразится сумма сделок.