Получить ссылку на файл из карточки
Робот «Получить ссылку на файл из карточки» читает файловое поле сделки, контакта, компании или лида в Битрикс24 и возвращает прямую ссылку на скачивание файла, его имя и размер в байтах. По индексу выбирает нужный файл из поля (0 — первый, -1 — последний). Также возвращает признак Y/N, найден ли файл.
Робот достаёт файл из файлового поля CRM-сущности и отдаёт его в бизнес-процесс как готовую ссылку. На вход принимает тип сущности (deal, contact, company, lead), её ID, код файлового поля и индекс файла внутри поля (0 — первый, -1 — последний, по умолчанию 0). На выходе возвращает ссылку для скачивания, имя файла, размер в байтах и признак found (Y/N). Применяйте, когда нужно переслать вложение из карточки во внешний сервис, вставить ссылку на документ в письмо или уведомление, передать файл в HTTP-запрос или просто проверить, прикреплён ли документ. Если сущность не найдена, поле пустое или файлов нет, робот вернёт found=N и пустые значения — используйте этот признак в условии следующего шага.
Какие параметры принимает робот?
| Параметр | Тип | Обязательный? | По умолчанию |
|---|---|---|---|
| Тип сущности: deal / contact / company / lead | string | да | |
| ID сущности | int | да | |
| Код файлового поля | string | да | |
| Индекс файла (0 = первый, -1 = последний; по умолчанию 0) | int | — |
Что возвращает робот?
| Параметр | Тип |
|---|---|
| Ссылка для скачивания | string |
| Имя файла | string |
| Размер в байтах | int |
| Файл найден (Y/N) | string |
Сценарий: отправка договора из сделки
- Сделка переходит на стадию «Документы готовы»
- Робот читает файловое поле сделки и возвращает ссылку, имя и размер файла
- Следующий шаг вставляет ссылку в письмо клиенту