Удалить телефон у сущности по ID
Робот «Удалить телефон у сущности по ID» убирает указанные номера из карточки лида, контакта или компании по её типу и ID — из любого контекста бизнес-процесса в Битрикс24. Номера задаются списком, сравнение по умолчанию умное: 8 и +7 считаются одним номером. Возвращает признак удаления (Y/N), количество удалённых номеров и список удалённых значений.
Робот удаляет один или несколько телефонов у произвольной сущности — лида, контакта или компании, заданных явно типом и ID, даже если бизнес-процесс запущен на другом элементе CRM (например процесс по сделке чистит телефон связанного контакта). Номера для удаления задаются множественным полем (по одному в строке). Способ сравнения выбирается параметром: «умное» (по умолчанию) приводит номера к 10-значному ядру и считает 8, +7 и запись без префикса одним номером; «только по цифрам» сравнивает все цифры без приведения; «точное совпадение» — строку как есть. Внутри робот читает список телефонов сущности и удаляет только совпавшие значения по их идентификаторам — остальные телефоны, а также email и другие контактные данные остаются нетронутыми. Если ни один номер не найден, запись не выполняется. Типовые случаи: убрать устаревший номер у связанной компании при работе по сделке, снять номер из чёрного списка по данным внешней системы. Возвращает признак «Удалено» (Y/N), количество удалённых номеров и список удалённых значений — используйте их в условиях и уведомлениях следующих шагов. Если робот запускается в бизнес-процессе самой сущности, удобнее робот «Удалить телефон у текущей сущности» — там ID указывать не нужно.
Какие параметры принимает робот?
| Параметр | Тип | Обязательный? | По умолчанию |
|---|---|---|---|
| Тип сущности | select | да | contact |
| ID сущности | int | да | |
| Номера для удаления (по одному в строке) | string | да | |
| Как сравнивать номера | select | да | smart |
Что возвращает робот?
| Параметр | Тип |
|---|---|
| Удалено (Y/N) | string |
| Сколько номеров удалено | int |
| Удалённые номера | string |
Какие ошибки может вернуть робот?
Эти сообщения робот пишет в журнал бизнес-процесса, когда не может выполнить шаг. По тексту видно, что исправить в настройках или данных.
- Ошибка API
- Ошибка: не указаны номера для удаления
- Ошибка: не указан ID сущности
- Ошибка: выберите тип сущности — лид, контакт или компания
- Ошибка: робот «текущей сущности» нужно запускать из бизнес-процесса лида, контакта или компании
Сценарий: убрать телефон связанного контакта из процесса по сделке
- В бизнес-процессе сделки добавьте робота «Удалить телефон у сущности по ID»
- Выберите тип «Контакт», в ID укажите контакт сделки, в списке номеров — телефон для удаления
- Робот вернёт «Удалено» = Y и removed_count = 1, если номер был в карточке