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, с которых клиент писал. Если значение не похоже на телефон, поиска нет, выход «Не найдено». |
| Без учёта регистра: Aliya@Mail.kz совпадёт с aliya@mail.kz. | |
| ID контакта | Только цифры. Контакт другой компании не найдётся. |
| Своему полю контакта | Равенство без учёта регистра. Списки с несколькими вариантами и длинный текст для поиска не подходят. |
| Компании | Текст поля «Компания» в карточке контакта, без учёта регистра: «ТОО Мебель Плюс» совпадёт с «тоо мебель плюс». |
| ID организации | Контакты этой организации, обычно {{vars.found_organization_id}} из блока «Найти организацию». Удалённая организация и организация другой компании не найдутся. |
- Если после подстановки значение пустое, блок сразу идёт по выходу «Не найдено».
- Если подходят несколько контактов, берётся тот, что создан раньше всех. В запуске это видно как «совпадений несколько».
- ID найденного контакта сохраняется в переменную, по умолчанию
found_contact_id. Дальше он доступен как{{vars.found_contact_id}}. - В разделе «Сохранить в переменные» можно сразу забрать до 20 полей контакта: строка «Поле» и «Переменная». Если контакт не найден, эти переменные очищаются, чтобы следующие блоки не взяли старое значение.

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

Найти организацию
Блок ищет 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. 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}}) и куда перевести. Сделка сценария это сделка, с которой начался сценарий; если он начался не событием сделки, то сделка диалога, а если её нет, самая новая открытая сделка клиента. Если сделки нет или она в «Неразобранном», шаг пропускается и сценарий идёт дальше, причина видна в запуске. - Убрать тег: укажите тег, блок снимет его с клиента сценария.
Четыре готовых связки
Заявка с сайта двигает сделку
- Триггер «Webhook / API», в теле запроса телефон клиента.
- «Найти контакт» по телефону
{{trigger.body.phone}}. - С выхода «Найдено»: «Найти сделку» контакта по ID
{{vars.found_contact_id}}в воронке «Продажи», статус «Открыта». - С выхода «Найдено»: «Сменить этап сделки» по 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 сделок или контактов. Проверьте, не зациклился ли сценарий. |
| Сделка в «Неразобранном» | Не удалось | Такие сделки блок не удаляет. Сначала разберите сделку. |
| Это групповой чат | Не удалось | Групповой чат как контакт не удаляется. |
| Шаг не выполнен | Не удалось | Внутренняя ошибка. Напишите в поддержку и назовите номер запуска. |
Смотрите также
Как устроены сценарии: «Автоматизации». Переменные и константы: «Переменные, константы и кнопки в сценариях». Контакты, сделки и воронки: «Контакты и сделки». Свои поля и доступ ИИ к ним: «Свои поля».