Копирование файла между элементами

Робот «Копирование файла между элементами» для Битрикс24: перенос файлов между сущностями CRM без скачивания

Робот «Копирование файла между элементами» решает одну из самых частых рутинных задач в Битрикс24 — перенос вложений при смене стадии, конвертации лида или переходе между смарт-процессами. Вместо того чтобы вручную скачивать и заново прикреплять файлы, робот делает это автоматически по заданному триггеру.

Что делает

Робот забирает файл (или несколько файлов) из пользовательского поля-файла исходной сущности и копирует его в указанное поле целевой сущности. При копировании сохраняются оригинальные имена файлов, метаданные и структура множественных полей. Робот корректно обрабатывает как одиночные, так и множественные файловые поля, автоматически нормализует технические имена полей (например, uf_crm_123 → ufCrm123) и декодирует содержимое из base64 при необходимости.

Сценарии использования

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

Переход по стадиям смарт-процесса. В смарт-процессе на каждой стадии могут использоваться разные наборы полей. Робот копирует файл из поля «Вложение» на этапе «Заявка» в поле «Документы» на этапе «В работе».

Синхронизация между сделкой и контактом. Когда к сделке прикреплён подписанный договор, робот дублирует его в карточку контакта — так файл доступен из обеих сущностей без лишних переходов.

Объединение дублей. При слиянии дублирующихся карточек робот переносит все файлы из старой карточки в новую, чтобы история вложений не потерялась.

Настройка

В настройках робота укажите исходную сущность (тип и ID) и поле-файл, из которого нужно скопировать вложение. Затем задайте целевую сущность и поле, куда следует поместить файл. Исходная и целевая сущности могут относиться к разным типам CRM — лиды, сделки, контакты, компании и любые смарт-процессы. Робот сам сопоставит форматы полей.

Результат

Робот возвращает статус выполнения операции: «Y» — файл успешно скопирован, «N» — операция не удалась. При успехе файл появляется в целевом поле сущности с сохранением оригинального имени. В случае ошибки робот логирует причину для диагностики.

Интеграция

Робот встраивается в любой бизнес-процесс или триггерную цепочку CRM. На выходе отдаёт булево значение, которое можно использовать в условных операторах для ветвления логики процесса: если копирование успешно — отправить уведомление, если нет — создать задачу на проверку.

Возможные ошибки

• Файл не найден — исходное поле пусто или файл удалён.
• Неверный формат поля — указано поле не файлового типа, а строковое или числовое.
• Доступ запрещён — у робота нет прав на чтение исходной или запись в целевую сущность.
• Файл слишком большой — размер превышает лимиты Битрикс24 на одно вложение.