Перейти к содержимому
AISARAISAR
Все инструкции

CRM-блоки в сценариях: найти, прочитать поле, удалить

Как в сценарии найти контакт или сделку, сохранить значение поля в переменную, сменить этап найденной сделки и удалить сделку или контакт. Кто может добавлять такие блоки и что значат причины в истории запусков.

Что умеют блоки

Блоки работают с CRM AISAR: контактами, сделками, организациями, своими полями контакта, диалога и организации. В Битрикс24 и amoCRM напрямую они ничего не ищут и не меняют. Если сделки у вас синхронизируются с Битрикс24, изменения от сценария уходят туда так же, как правки из кабинета. Удаление уходит в Битрикс24 или amoCRM, только если в карточке интеграции выбрано, что делать при удалении, и сценарий никогда не удаляет там насовсем (подробнее ниже).

В редакторе сценария блоки лежат в библиотеке действий, в категории «Контакты и сделки»:

БлокЧто делаетВыходы
Найти контактИщет контакт по телефону, e-mail, ID, своему полю или компании и сохраняет его ID и поля в переменные.Найдено, Не найдено, Не удалось
Найти сделкуНаходит самую новую сделку клиента или по воронке, этапу и названию, сохраняет её ID и поля в переменные.Найдено, Не найдено, Не удалось
Найти организациюИщет организацию по налоговому номеру, названию, ID или своему полю и сохраняет её ID и поля в переменные.Найдено, Не найдено, Не удалось
Получить значение поляСохраняет значение одного поля контакта, сделки, диалога или организации в переменную.Найдено, Не найдено, Не удалось
Удалить сделку или контактУдаляет сделку или контакт сценария либо найденный по ID.Удалено, Не найдено, Не удалось
Создать сделкуСоздаёт сделку клиенту сценария в выбранной воронке и этапе.один выход
Сменить этап сделкиПереводит сделку сценария или найденную сделку на другой этап.один выход
Убрать тегСнимает тег с контакта, например «ждёт звонка» после разговора.один выход
Библиотека действий, категория «Контакты и сделки»: «Добавить тег», «Убрать тег», «Изменить поле контакта», «Назначить ответственного», «Найти контакт», «Найти сделку», «Получить значение поля», «Создать сделку», «Сменить этап сделки», «Удалить сделку или контакт»

Найденный контакт не становится клиентом сценария. Сообщения, ожидания ответа и «Изменить поле контакта» по-прежнему работают с тем, кто запустил сценарий. Найденного берите по ID в следующих блоках: «Найти сделку», «Получить значение поля», «Сменить этап сделки» и «Удалить».

Кто может добавлять блоки

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

БлокЧто нужно сотруднику
Удалить сделкуПраво удалять сделки и уровень «Все» у сделок в роли.
Удалить контактПраво удалять контакты и доступ ко всем каналам компании.
Найти сделку, Получить значение поля сделкиПраво смотреть сделки и уровень «Все» у сделок.
Найти контакт, Получить значение поля контакта по IDПраво смотреть контакты и доступ ко всем каналам компании: поиск идёт по всем контактам.
Сменить этап сделкиПраво изменять сделки. Для сделки по ID ещё и уровень «Все» у сделок.
Создать сделкуПраво создавать сделки.
Найти организацию, Получить значение поля организацииПраво смотреть организации. Для организации сделки сценария ещё и то, что нужно для чтения сделки.
  • Если права нет, карточка блока в библиотеке видна, но недоступна, а подсказка объясняет, чего не хватает. Администратор компании проходит всегда.
  • Права проверяются по всему сценарию и по сценариям, в которые он переходит, когда его сохраняют, включают, переключают версию, запускают живой тест или безопасный прогон и меняют настройки входящего вебхука. Сотрудник без права не сможет пересохранить сценарий, где такой блок уже стоит, но может удалить этот блок.
  • Константу компании, которая подставляется в CRM-блоки, может создать, изменить или удалить только тот, кто сам может собрать эти блоки. Иначе через константу можно было бы подменить, что удалит сценарий администратора.
  • Уже включённый сценарий продолжает работать, если его автору потом урезали права. После смены ролей проверьте сценарии с блоком удаления.

Как настраиваются права и уровень «Все» — в «Ролях и правах».

Найти контакт

В блоке выберите, по чему искать, и укажите «Значение»: текст или переменную, например {{trigger.body.phone}} из входящего вебхука.

Искать поКак сравнивается
ТелефонуНомер приводится к виду +7 701 555 12 34 по стране компании, поэтому 8 701 555 12 34 тоже найдётся. Ищем и среди номеров WhatsApp, с которых клиент писал. Если значение не похоже на телефон, поиска нет, выход «Не найдено».
E-mailБез учёта регистра: Aliya@Mail.kz совпадёт с aliya@mail.kz.
ID контактаТолько цифры. Контакт другой компании не найдётся.
Своему полю контактаРавенство без учёта регистра. Списки с несколькими вариантами и длинный текст для поиска не подходят.
КомпанииТекст поля «Компания» в карточке контакта, без учёта регистра: «ТОО Мебель Плюс» совпадёт с «тоо мебель плюс».
ID организацииКонтакты этой организации, обычно {{vars.found_organization_id}} из блока «Найти организацию». Удалённая организация и организация другой компании не найдутся.
  • Если после подстановки значение пустое, блок сразу идёт по выходу «Не найдено».
  • Если подходят несколько контактов, берётся тот, что создан раньше всех. В запуске это видно как «совпадений несколько».
  • ID найденного контакта сохраняется в переменную, по умолчанию found_contact_id. Дальше он доступен как {{vars.found_contact_id}}.
  • В разделе «Сохранить в переменные» можно сразу забрать до 20 полей контакта: строка «Поле» и «Переменная». Если контакт не найден, эти переменные очищаются, чтобы следующие блоки не взяли старое значение.
Панель блока «Найти контакт»: «Искать по» Телефону, значение {{trigger.body.phone}}, «ID найденного контакта» found_contact_id, в «Сохранить в переменные» поля «Имя» и «Телефон», ниже выходы «Найдено», «Не найдено», «Не удалось»

Найти сделку

  • «Чьи сделки»: клиента сценария, контакта по ID (обычно {{vars.found_contact_id}} из «Найти контакт») или любого контакта. Для любого контакта обязательно укажите воронку, этап или часть названия, иначе блок нашёл бы случайную сделку компании.
  • Условия: воронка и этап (можно оставить любые), статус (по умолчанию «Открыта», ещё «Выиграна», «Проиграна», «Любой») и «Название содержит», до 100 символов. «угловая» найдёт «Кухня угловая, Абая 150».
  • Если подходят несколько сделок, берётся самая новая. Сделки из «Неразобранного» не ищутся.
  • ID найденной сделки сохраняется в found_deal_id, поля сделки можно забрать в переменные так же, как у контакта.
Панель блока «Найти сделку»: «Чьи сделки» клиента сценария, воронка, «Любой этап», статус «Открыта», «Название содержит», ID найденной сделки found_deal_id и поле «Сумма» в переменную deal_amount, выходы «Найдено», «Не найдено», «Не удалось»

Найти организацию

Блок ищет CRM-организацию вашей компании. Выберите, по чему искать, и укажите «Значение», например {{trigger.body.tax_number}} из входящего вебхука.

Искать поКак сравнивается
Налоговый номерПробелы, дефисы и точки убираются, поэтому 1234 5678 9012 совпадёт с 123456789012. Если значение не похоже на налоговый номер (нужно от 3 до 32 латинских букв и цифр), поиска нет, выход «Не найдено».
НазваниюНазвание целиком, без учёта регистра.
ID организацииТолько цифры. Организация другой компании не найдётся.
Своему полю организацииРавенство без учёта регистра. Списки с несколькими вариантами и длинный текст для поиска не подходят.
  • Если подходят несколько организаций, берётся та, что создана раньше всех. В запуске это видно как «совпадений несколько».
  • ID найденной организации сохраняется в found_organization_id, дальше он доступен как {{vars.found_organization_id}}. В «Сохранить в переменные» можно забрать поля организации: название, налоговый номер, тип отношений, реквизиты, ответственного и свои поля. Банковские счета блоки не читают.
  • Найденная организация не привязывается к клиенту сценария. Её контакты ищите блоком «Найти контакт» по ID организации.

Получить значение поля

Блок читает одно поле в переменную, чтобы проверить его в условии или вставить в сообщение. «Откуда»: контакт, сделка или диалог, сценария или по ID (у диалога только диалог сценария), либо организация: клиента сценария, сделки сценария или по ID. «Что прочитать»: встроенные поля (имя, телефон, ответственный, сумма, этап, воронка, причина проигрыша и другие) и свои поля контакта, диалога и организации.

  • Сумма приходит числом без пробелов, например 2450000, дата как 2026-11-16, теги через запятую. Поэтому условие vars.deal_amount больше 100000 работает сразу.
  • Для условий по типу отношений организации берите поле «Тип отношений (код для условий)»: у стартовых типов это customer, partner и другие ключи, и он не меняется, если тип переименовать. У своих типов компании код пустой, для них сравнивайте поле «Тип отношений» с названием.
  • Пустое поле по умолчанию даёт выход «Найдено» и пустую переменную. Включите «Пустое значение считать „Не найдено“», если пустое поле надо обработать отдельно.
Панель блока «Получить значение поля»: «Откуда» Сделка, «По ID» {{vars.found_deal_id}}, поле «Сумма», переменная deal_amount, переключатель «Пустое значение считать „Не найдено“» выключен, выходы «Найдено», «Не найдено», «Не удалось»
Своё поле, у которого выключено «Видно ИИ-сотруднику», в списке помечено «закрыто для ИИ». Блок всё равно сохранит его значение в переменную. Если потом вставить эту переменную в ИИ-шаг или в сообщение клиенту, значение увидят ИИ или клиент. Не вставляйте такие переменные туда, где они не нужны.

Удалить сделку или контакт

В блоке выберите «Что удалить» (сделку или контакт) и «Чью»: сценария или по ID. ID обычно берут из блока поиска: {{vars.found_deal_id}} или {{vars.found_contact_id}}.

Блок удаляет по-настоящему, в том числе в «Живом тесте». Ничего не удаляет только «Безопасный прогон». Подтверждения перед удалением нет: проверяйте сценарий «Безопасным прогоном» и на тестовом контакте.
Панель блока «Удалить сделку или контакт»: красное предупреждение «Блок удаляет по-настоящему», выбрано «Контакт» и «Клиент сценария», пометка «Завершает сценарий», выходы только «Не найдено» и «Не удалось»
Узел «Удалить сделку или контакт» на холсте с пометкой «Завершает сценарий» и выходами «Не найдено» и «Не удалось», без «Удалено»
  • Удаление мягкое. Запись пропадает из списков, но не стирается из базы. Сделку можно восстановить: через API запросом POST /v1/deals/{id}/restore (нужно право удалять сделки, см. REST, сделки) или через поддержку. Отдельной корзины сделок в кабинете пока нет.
  • Контакт из кабинета не вернуть, только через поддержку. Голосовые саммари и ИИ-оценки его диалогов удаляются сразу и насовсем, как и при удалении контакта вручную.
  • В Битрикс24 и amoCRM удаление передаётся, только если это включено в карточке интеграции. По умолчанию там выбрано «Ничего не делать», и запись в CRM остаётся как есть. Режим выбирает администратор компании на вкладке «Синхронизация» карточки интеграции. Удаление уходит в CRM после того, как запись удалена в AISAR, через очередь, а не мгновенно.
  • Сценарий в CRM насовсем не удаляет. Даже при режиме «Удалить в Битрикс24» сделка, удалённая сценарием, закрывается в портале как проигранная, а контакт получает комментарий. Насовсем удаляет только сотрудник, который удалил одну запись в веб-кабинете. В комментарии указано, что запись удалена сценарием, и его название. Режимы, лимиты и пауза передачи описаны в статье «Подключение Битрикс24».
  • amoCRM. В карточке интеграции amoCRM на вкладке «Синхронизация» есть настройка «Если контакт удалили в AISAR»: «Ничего не делать» или «Поставить тег «Удалён в AISAR»». Тег добавляется к остальным тегам контакта, вместе с ним появляется заметка: кто и когда удалил контакт. По тегу удобно найти такие контакты и разобрать их вручную. Удалить контакт в amoCRM через интеграцию нельзя: amoCRM не даёт такой возможности. Сделки AISAR в amoCRM не передаются, поэтому для них настройки нет. Если к той же карточке amoCRM привязан ещё один контакт AISAR, который не удалён, тег не ставится. Если за час удалили больше 100 контактов, передача встаёт на паузу так же, как в Битрикс24, и её снимает администратор кнопкой «Возобновить».
  • Удаление клиента сценария завершает сценарий. Запуск закрывается, следующие блоки не выполняются, поэтому у такого блока нет выхода «Удалено», а на холсте он помечен «Завершает сценарий». То же будет, если по ID удалили контакт, который и запустил сценарий. В истории запусков итог «Контакт удалён, сценарий завершён».
  • Не больше 20 удалений на одну цепочку запусков, включая «Перейти в сценарий» и «Запустить сценарий сначала». 21-е удаление уйдёт по выходу «Не удалось». Так случайная петля не сотрёт всю базу.
  • Сделку из «Неразобранного» блок не удаляет, групповой чат как контакт не удаляется: в обоих случаях выход «Не удалось».
  • Вебхуки deal.deleted и contact.deleted уходят так же, как при удалении из кабинета.

ID из входящего вебхука

Если ID для удаления берётся из тела входящего вебхука, например {{trigger.body.deal_id}}, то что удалить, решает тот, кто отправляет запрос. Так можно делать, только если адрес и секрет вебхука знает одна ваша система. На адрес с секретом внутри, который виден в HTML формы на сайте, такой сценарий не вешайте.

Старый секрет продолжает действовать и после того, как в сценарий добавили CRM-блоки. Если адрес или секрет мог попасть к посторонним раньше (например, к бывшему сотруднику или подрядчику), нажмите «Заменить секрет» в настройках вебхука и обновите его в своей системе. Как устроен входящий вебхук: «Запуск сценария вебхуком».

Создать сделку, сменить этап, убрать тег

  • Создать сделку: воронка и этап (по умолчанию первый этап воронки), название и сумма, можно с переменными. В пункте «Если у клиента уже есть открытая сделка» выберите «Не создавать новую» или «Создать ещё одну». Сделка создаётся клиенту сценария, ответственный берётся из его карточки.
  • Сменить этап сделки: какую сделку (сделка сценария или по ID, обычно {{vars.found_deal_id}}) и куда перевести. Сделка сценария это сделка, с которой начался сценарий; если он начался не событием сделки, то сделка диалога, а если её нет, самая новая открытая сделка клиента. Если сделки нет или она в «Неразобранном», шаг пропускается и сценарий идёт дальше, причина видна в запуске.
  • Убрать тег: укажите тег, блок снимет его с клиента сценария.

Четыре готовых связки

Заявка с сайта двигает сделку

  1. Триггер «Webhook / API», в теле запроса телефон клиента.
  2. «Найти контакт» по телефону {{trigger.body.phone}}.
  3. С выхода «Найдено»: «Найти сделку» контакта по ID {{vars.found_contact_id}} в воронке «Продажи», статус «Открыта».
  4. С выхода «Найдено»: «Сменить этап сделки» по ID {{vars.found_deal_id}}, например на «Оплачено».
Холст связки: триггер «Webhook получен» → «Найти контакт» по {{trigger.body.phone}} → с выхода «Найдено» «Найти сделку» контакта {{vars.found_contact_id}} → с выхода «Найдено» «Сменить этап сделки» {{vars.found_deal_id}}; у блоков поиска выходы «Найдено», «Не найдено», «Не удалось»

Крупная сделка — сразу руководителю

«Найти сделку» клиента сценария, в «Сохранить в переменные» поле «Сумма» → deal_amount. Дальше «Если / иначе» с условием vars.deal_amount больше 100000 и на ветке «Да» «Уведомить команду» руководителя.

Спам-контакт удаляется

Триггер «Новое сообщение», в «Если / иначе» условие по тексту спам-рассылки, на ветке «Да» «Удалить сделку или контакт»: контакт, клиент сценария. Сценарий на этом закончится. Начните с узкого условия и проверьте его на нескольких реальных сообщениях: удалённый контакт из кабинета не вернуть.

Контакт по названию компании

«Найти контакт» по компании «ТОО Ромашка», в «Сохранить в переменные» поле «Имя» → boss_name. Дальше «Отправить в чат» с текстом вида «Пришла заявка для {{vars.boss_name}}».

Удаление сделки из кабинета и сценарии «Сделка обновлена»

Раньше удаление сделки из кабинета, в том числе массовое, запускало сценарии с триггером «Сделка обновлена» на удаляемой сделке. Теперь удаление их не запускает: сценарий по удалённой сделке всё равно не мог ничего полезного с ней сделать. Если вам нужно реагировать на удаление сделки во внешней системе, подпишитесь на вебхук deal.deleted.

Причины в истории запусков

Если блок ушёл по выходу «Не найдено» или «Не удалось», причина видна на вкладке «Запуски» сценария: откройте запуск и шаг блока. Значения полей в историю не пишутся, только ID и причина.

ПричинаВыходЧто значит и что делать
Совпадений нетНе найденоПодходящего контакта или сделки нет.
Искать нечегоНе найденоПосле подстановки переменных значение пустое. Проверьте, что поле заявки или переменная заполнены.
Телефон не распознан, E-mail не распознанНе найденоЗначение не похоже на номер или адрес почты, поиск не выполнялся.
ID не подошёлНе найденоВместо ID пришло не число.
У запуска нет клиентаНе найденоСценарий запущен без контакта, например по расписанию. Ищите по ID.
Сделки нетНе найденоУ клиента нет открытой сделки, а сценарий начался не событием сделки.
Диалога нетНе найденоСценарий запущен без диалога.
Организации нетНе найденоУ клиента или сделки нет организации, организацию удалили или ID принадлежит другой компании.
Номер не распознанНе найденоЗначение после подстановки не похоже на налоговый номер, поиск не выполнялся.
Поле пустоеНе найденоВключено «Пустое значение считать „Не найдено“».
Блок настроен не до концаНе удалосьВ настройках не хватает значения. Откройте блок и проверьте поля.
Поле не найдено, Поле в архивеНе удалосьПоле удалили или своё поле перенесли в архив. Верните поле или выберите другое.
По полю искать нельзяНе удалосьСписки с несколькими вариантами и длинный текст в поиске не сравниваются.
Воронки или этапа больше нетНе удалосьВоронку или этап из настроек блока удалили. Выберите другие.
Слишком длинное значениеНе удалосьПосле подстановки значение длиннее допустимого, например «Название содержит» длиннее 100 символов.
Нет места для переменныхНе удалосьВ запуске уже 50 переменных или 64 КБ значений. Сохраняйте в переменные только нужные поля.
Поиск занял слишком долгоНе удалосьБаза не ответила за 3 секунды. Сузьте условия поиска.
Достигнут предел удаленийНе удалосьВ цепочке запусков уже удалено 20 сделок или контактов. Проверьте, не зациклился ли сценарий.
Сделка в «Неразобранном»Не удалосьТакие сделки блок не удаляет. Сначала разберите сделку.
Это групповой чатНе удалосьГрупповой чат как контакт не удаляется.
Шаг не выполненНе удалосьВнутренняя ошибка. Напишите в поддержку и назовите номер запуска.

Смотрите также

Как устроены сценарии: «Автоматизации». Переменные и константы: «Переменные, константы и кнопки в сценариях». Контакты, сделки и воронки: «Контакты и сделки». Свои поля и доступ ИИ к ним: «Свои поля».