Найти CRM-дела по условиям процесса
Находит дела основной карточки CRM по состоянию, сроку и типу.
Видимая часть формы настройки в Битрикс24. Скриншот показывает поля действия; он не подтверждает выполнение учебного примера.
Для кого и какую проблему решает
Робот полезен для координатора, которому нужна точная подборка дел одной CRM-карточки. Сотрудник вручную отбирает открытые или завершённые дела перед обработкой. Робот ищет дела по карточке, состоянию и дополнительным фильтрам, возвращая ID и доступные сведения для следующих шагов.
Что делает и когда применять
Находит дела основной карточки CRM по состоянию, сроку и типу.
Принимает тип и ID основной карточки, состояние, необязательные тип дела, источник и период крайних сроков. Возвращает краткие данные и ID, не более 500 записей, с явным признаком усечения. Дела, связанные с карточкой только дополнительной привязкой, в этот поиск не входят. Пустой результат успешен.
Что подготовить
Нужен установленный робот из приложения «CRM роботы 2.0 + AI» и право на настройку автоматизации нужной CRM-воронки или шаблона бизнес-процесса. Пользователю, от имени которого работает приложение, должны быть доступны выбранные CRM-элементы и нужное действие с ними.
Укажите тип и ID карточки и состояние дел. Дополнительные тип, источник и границы срока задавайте только когда они нужны. Границы дат записывайте с часовым поясом, а лимит подберите под ожидаемый объём.
Как настроить и использовать
- Откройте автоматизацию нужной сущности и выберите стадию, на которой нужен робот «Найти CRM-дела по условиям процесса». В шаблоне бизнес-процесса добавьте одноимённое действие.
- Укажите тип и ID карточки и состояние дел. Дополнительные тип, источник и границы срока задавайте только когда они нужны. Границы дат записывайте с часовым поясом, а лимит подберите под ожидаемый объём.
- Заполните Тип карточки CRM, ID карточки CRM, Состояние, Лимит. Для рабочего сценария подставьте значения полей документа или результаты предыдущих действий вместо учебных данных ниже.
- Проверьте обязательные поля и варианты выбора в таблице настроек. Сохраните действие и свяжите его результаты с дальнейшими условиями процесса.
- Выполните пробный запуск на отдельном учебном элементе. Сначала проверьте статус и пояснение ошибки, затем содержательный результат и ветку, выбранную следующим действием.
Параметры робота
Имена полей ниже совпадают с настройками действия. Значения из таблицы относятся к самому роботу; результаты предыдущих шагов выбирайте через подстановку значения в редакторе.
| Поле в настройках | Что передать | Обязательность и исходное значение |
|---|---|---|
Тип карточки CRM (OWNER_TYPE_ID) |
Формат: целое число. | Обязательно. Значение по умолчанию в настройках не задано |
ID карточки CRM (OWNER_ID) |
Формат: целое число. | Обязательно. Значение по умолчанию в настройках не задано |
Состояние (COMPLETED) |
Формат: выбор из списка. Варианты: N: Открытые; Y: Завершённые; ALL: Любые. | Обязательно. По умолчанию: N |
Тип дела: необязательно (TYPE_ID) |
Формат: целое число. | Необязательно. Значение по умолчанию в настройках не задано |
Источник дела: необязательно (PROVIDER_ID) |
Формат: строка. | Необязательно. Значение по умолчанию в настройках не задано |
Срок от: ISO с часовым поясом (FROM) |
Формат: строка. | Необязательно. Значение по умолчанию в настройках не задано |
Срок до: ISO с часовым поясом (TO) |
Формат: строка. | Необязательно. Значение по умолчанию в настройках не задано |
Лимит (LIMIT) |
Формат: целое число. | Обязательно. По умолчанию: 100 |
Учебный пример
Пример показывает способ настройки на вымышленных данных и ожидаемый смысл результата; это не отчёт о запуске на вашем портале.
- Тип карточки CRM (
OWNER_TYPE_ID):2. - ID карточки CRM (
OWNER_ID):501. - Состояние (
COMPLETED):N. - Лимит (
LIMIT):100.
При этих настройках ищутся незавершённые дела учебной сделки 501. Пустая доступная выборка является нормальным итогом. Если «Вывод усечён» положителен, возвращённое количество не подтверждает полный объём всех подходящих дел.
Какие данные возвращает и что делать дальше
| Результат | Какое значение получает следующий шаг |
|---|---|
ID дел (ids) |
целое число, несколько значений |
Краткие данные: JSON (activitiesJson) |
текст |
Возвращено дел (count) |
целое число |
Результат усечён (truncated) |
да/нет |
Статус выполнения (status) |
да/нет |
Пояснение ошибки (error) |
строка |
Передайте «ID дел» в отдельную проверку или выборочное завершение. До массового изменения проверьте фильтры и усечение; даты срока относятся к планированию дела, а не обязательно ко времени реального общения.
Ошибки и ограничения
Проверяйте результат действия до следующего изменения карточки. Ошибка доступа, неверный идентификатор и отсутствие найденного элемента требуют разных веток процесса. Не подставляйте нулевой или пустой результат как идентификатор существующего документа.