Выбрать сотрудника по взвешенной очереди

Робот «Выбрать сотрудника по взвешенной очереди». Распределяет последовательные обращения между переданными сотрудниками в заданной пропорции.

Видимая часть формы настройки в Битрикс24. Скриншот показывает поля действия; он не подтверждает выполнение учебного примера.

Для кого и какую проблему решает

Для руководителя отдела, распределяющего последовательные обращения в согласованной пропорции. Позволяет дать опытному сотруднику больше обращений, сохранив воспроизводимый выбор при повторной обработке заявки.

Что подготовить

Установите действие в каталоге приложения «CRM роботы 2.0 + AI», затем добавьте его в нужную точку автоматизации. Для чтения или изменения объектов нужен соответствующий доступ пользователя подключения. Идентификаторы берите из полей карточки или результатов предыдущих шагов: название объекта не заменяет его числовой ID.

Параметры и значения

Поле в настройке	Тип	Обязательность и исходное значение
Код очереди	Строка	Обязательное; значение по умолчанию не задано
Уникальный ключ обращения	Строка	Обязательное; значение по умолчанию не задано
Сотрудники и веса (JSON)	Текст	Обязательное; значение по умолчанию не задано

Поля, обозначенные JSON, заполняйте корректными массивами или объектами с двойными кавычками в строках. Подставляйте одно значение через штатный выбор данных редактора; не копируйте служебный идентификатор шага из другого шаблона.

Как использовать пошагово

1. Задайте код очереди для неизменной конфигурации, например training-support-v1.
2. Передайте кандидатов с ключами employeeId и weight, например [{"employeeId":21,"weight":2},{"employeeId":22,"weight":1}].
3. Составьте уникальный ключ одного обращения, например request-900. Повтор этого обращения должен использовать тот же ключ.
4. Перед назначением заранее проверьте активность, рабочее время и доступность кандидатов; очередь не делает этого сама.
5. Используйте выбранный ID в следующем действии назначения. Для изменения состава или весов создайте новый код очереди.

Учебный пример и ожидаемый результат

Для кандидатов 21 с весом 2 и 22 с весом 1 цикл идёт по ID: два последовательных шага получают 21, один: 22. Повтор одного ключа обращения возвращает прежний выбор, а не следующий шаг. Все номера объектов в примере условные; замените их данными своего портала. Пример объясняет настройку, а не подтверждает выполненный запуск.

Какие результаты передать дальше

• Выбранный сотрудник: сотрудник.
• Вес сотрудника: целое число.
• Получен прежний выбор: да/нет (Y/N).

В следующем действии откройте выбор данных и выберите результат этого робота по названию. Сначала проверьте статус выполнения; при ошибке передайте её пояснение на разбор и не используйте пустые значения как подтверждённый результат. Успех шага и положительный ответ на бизнес-проверку: разные условия.

Ограничения и исправление ошибок

До 100 сотрудников, каждый вес 1–1000, сумма до 10 000. Параллельные обращения получают разные шаги, но неуспешный запуск может занять шаг. Очередь не проверяет автоматически активность и не назначает ответственного. Незавершённую операцию требуется сверить.

Один ключ операции закрепляйте за одним событием и сохраняйте неизменным при его повторе вместе со всеми входными данными. Для другого события нужен другой ключ. Случайный новый ключ на каждом запуске допускает дубли. При неизвестном или частичном результате сначала сверяйте фактически созданный объект; не обходите остановку сменой ключа.

Если доступ изменился, сначала проверьте объект под пользователем подключения и актуальность ID. Повторяйте действие после устранения причины. Для действий с записью предварительно сверяйте фактическое состояние: сообщение об ошибке само по себе не доказывает, что ни одна правка не сохранилась.

Как заполнять JSON-поля

Каждый блок ниже вставляется целиком в своё поле. Не добавляйте внешние кавычки вокруг всего массива или объекта. Учебные ID и названия замените фактическими данными.

Сотрудники и веса (JSON)

[
  {
    "employeeId": 21,
    "weight": 2
  },
  {
    "employeeId": 22,
    "weight": 1
  }
]

Непустой массив до 100 сотрудников. В каждом объекте обязательны числовой положительный employeeId и целый weight 1–1000; общая сумма весов до 10 000. Пример задаёт пропорцию 2:1. ID берите из согласованной и заранее проверенной команды, веса утверждает руководитель. [] не задаёт очередь, {} вместо массива неверен. Для изменения состава или весов нужен новый код очереди.