Роботека
Роботека · Роботы · Найти сделку по условию

Найти сделку по условию

Робот «Найти сделку по условию» ищет сделки в CRM Битрикс24 по фильтру: ID контакта или компании, стадия, ответственный, произвольный JSON-фильтр. Поддерживает сортировку и лимит результатов (до 50). Возвращает ID и название первой найденной сделки, список всех ID, количество и признак «Найдено» (Y/N). Работает в бизнес-процессах и роботах Битрикс24.

Робот ищет сделки в CRM Битрикс24 по заданным условиям: ID контакта, ID компании, стадия (например WON или C1:NEW), ответственный, а для нестандартных условий — произвольный JSON-фильтр, который объединяется с остальными полями. Доступны сортировка по дате создания, дате изменения или ID и лимит результатов от 1 до 50 (по умолчанию 5). Типовые случаи: найти открытую сделку контакта, чтобы не создавать дубль при повторном обращении, или получить последнюю сделку компании перед сменой стадии. Возвращает ID и название первой сделки, список всех найденных ID, количество и признак «Найдено» (Y/N) — по нему строится условие в дизайнере бизнес-процессов, а ID передаются следующим роботам.

Какие параметры принимает робот?

Параметр Тип Обязательный? По умолчанию
ID контакта int —
ID компании int —
Стадия (например WON, LOSE, C1:NEW) string —
ID ответственного int —
Произвольный фильтр (JSON, например {"CLOSED":"N"}) string —
Сортировка: CREATED_DATE / DATE_MODIFY / ID (по умолчанию DATE_MODIFY DESC) string —
Максимум результатов (по умолчанию 5) int —

Что возвращает робот?

Параметр Тип
ID первой найденной сделки int
Название первой сделки string
Все найденные ID int
Количество найденных сделок int
Найдено (Y/N) string

Какие ошибки может вернуть робот?

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

  • Ошибка API
  • Сделки не найдены

Сценарий: не создавать дубль сделки для контакта

  1. Новая заявка с сайта запускает бизнес-процесс по контакту
  2. Робот ищет открытые сделки этого контакта по фильтру CLOSED=N
  3. Если сделка найдена, заявка добавляется в неё, иначе создаётся новая

Похожие роботы

Статьи по теме

Установить Опишите задачу — сделаем робота бесплатно