Отправка файла

Робот Отправка файла ([Telegram] Отправить файл / [MAX] Отправить файл) отправляет файлы, изображения, видео и документы контакту в мессенджер. Поддерживает три источника файлов: прямая URL-ссылка, файл с Битрикс24.Диска и файл из поля CRM-сущности.

Назначение

Отправить клиенту документ (договор, счёт, коммерческое предложение)
Отправить изображение или фотографию
Передать файл из CRM-карточки или Битрикс24.Диска

Параметры

Параметр	Описание	Обязательный
Линия	Линия Олчат, через которую отправляется файл	Да
Тип идентификатора	Способ определения получателя: по телефону, ID чата или username	Да
ID чата / Username / Телефон	Идентификатор получателя	Да
Источник файла	Откуда берётся файл: URL, Битрикс24.Диск или поле CRM	Да
Файл	URL-адрес файла, ID файла на диске или значение поля CRM	Да
Подпись	Текст подписи к файлу (caption)	Нет
Отправить как документ	Отправить без сжатия изображений/видео (только Telegram)	Нет (по умолчанию: Нет)
ID топика	ID топика в группе-форуме	Нет
Публикация в ОЛ	Режим публикации в открытую линию	Нет (по умолчанию: Входящим сообщением)
Записать в CRM карточку	Добавить запись в таймлайн CRM	Нет (по умолчанию: Да)

Источники файлов

Источник	Описание	Формат значения
URL ссылка	Прямая ссылка на файл в интернете	`https://example.com/file.pdf`
Битрикс24.Диск	Файл с корпоративного диска	ID файла (число)
Поле CRM сущности	Файл из пользовательского поля CRM	Значение поля (подставляется через переменную)

Настройка в редакторе роботов

Шаг 1. Добавьте робота

На нужной стадии воронки добавьте робота [Telegram] Отправить файл или [MAX] Отправить файл из раздела Олчат.

Шаг 2. Выберите источник файла

Укажите, откуда берётся файл:

URL ссылка — введите или подставьте из переменной прямой URL файла
Битрикс24.Диск — укажите ID файла на диске
Поле CRM сущности — выберите поле CRM, содержащее файл

Шаг 3. Укажите получателя и дополнительные параметры

Выберите линию, тип идентификатора и получателя. При необходимости добавьте подпись к файлу.

Шаг 4. Настройте режим отправки

Для Telegram можно включить опцию Отправить как документ, чтобы изображения и видео не сжимались.

Настройка в дизайнере бизнес-процессов

Параметры в дизайнере бизнес-процессов аналогичны настройке в роботах CRM.

Возвращаемые значения

Значение	Тип	Описание
`is_sent`	bool	Результат отправки: `Y` или `N`
`chat_id`	string	ID чата получателя
`message_id`	string	ID отправленного сообщения
`error`	string	Текст ошибки
`error_code`	string	Код ошибки

Коды ошибок

Код	Описание
`CHAT_ID_EMPTY`	Идентификатор чата не указан
`FILE_ERROR`	Ошибка при подготовке файла
`FILE_NOT_FOUND`	Файл не найден
`LINE_NOT_FOUND`	Линия не найдена или не активна
`CHAT_NOT_FOUND`	Не удалось найти чат с получателем
`SEND_ERROR`	Ошибка при отправке

Поддерживаемые типы файлов

Мессенджеры поддерживают большинство распространённых форматов:

Изображения: JPG, PNG, GIF, WebP, BMP
Видео: MP4, MOV, AVI
Документы: PDF, DOC/DOCX, XLS/XLSX, PPT/PPTX, TXT, ZIP, RAR
Аудио: MP3, OGG, WAV

Ограничения по размеру

Мессенджер	Максимальный размер файла
Telegram	2 ГБ (через Telegram API)
MAX	100 МБ

Примечания и рекомендации

Подпись к файлу (caption) ограничена 1024 символами в Telegram и 1024 символами в MAX
При отправке файла с Битрикс24.Диска файл сначала скачивается сервером Олчат, а затем отправляется в мессенджер
URL-ссылка должна быть доступна из интернета (не из локальной сети)