Прямая ссылка на файл

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

Что такое прямая ссылка

Прямая ссылка (direct link) — это URL, при обращении к которому сервер возвращает содержимое файла, а не HTML-страницу. Например:

Тип ссылки	Пример	Подходит?
Прямая ссылка	`https://example.com/files/contract.pdf`	Да
Страница загрузки	`https://drive.google.com/file/d/abc123/view`	Нет
Облачное хранилище (preview)	`https://disk.yandex.ru/d/abc123`	Нет

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

URL ссылка

Прямая ссылка на файл в интернете. Сервер Олчат скачивает файл по этой ссылке и отправляет в мессенджер.

Требования:

Ссылка должна быть доступна из интернета (не из локальной сети)
Ссылка должна возвращать файл напрямую (не страницу загрузки)
Файл должен быть доступен без авторизации

Битрикс24.Диск

Файл с корпоративного диска Битрикс24. Указывается числовой ID файла.

Как найти ID файла на Битрикс24.Диске:

Откройте файл на Битрикс24.Диске
В URL страницы найдите числовой ID: https://portal.bitrix24.ru/disk/showFile/123/ — ID файла = 123
Или используйте API: файл доступен через disk.file.get

Поле CRM сущности

Файл из пользовательского поля CRM (тип поля: «Файл»). При подстановке переменной файл автоматически извлекается из CRM.

Как получить прямую ссылку

Файлы на собственном сервере

Разместите файл на веб-сервере и используйте прямой URL:

https://your-site.com/files/document.pdf

Google Drive

Для файлов Google Drive используйте формат прямой загрузки:

https://drive.google.com/uc?export=download&id=ФАЙЛ_ID

Где ФАЙЛ_ID — идентификатор файла из ссылки общего доступа. Файл должен быть доступен по ссылке (настройка «Все, у кого есть ссылка»).

Яндекс.Диск

Яндекс.Диск не предоставляет прямые ссылки через стандартный интерфейс. Для получения прямой ссылки используйте API Яндекс.Диска или разместите файл на другом хостинге.

Битрикс24.Диск (через URL)

Если нужна URL-ссылка на файл с Битрикс24.Диска (а не ID), получите публичную ссылку:

Откройте файл на Битрикс24.Диске
Нажмите Получить публичную ссылку
Используйте полученную ссылку

Проверка прямой ссылки

Чтобы убедиться, что ссылка является прямой:

Откройте ссылку в браузере
Если браузер начинает скачивание файла — ссылка прямая
Если открывается веб-страница с кнопкой «Скачать» — ссылка не прямая

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

Максимальное время загрузки файла по URL — 30 секунд; для больших файлов используйте Битрикс24.Диск
URL-ссылка должна использовать протокол HTTPS (HTTP может быть отклонён)
Файлы, защищённые авторизацией (401/403), не могут быть скачаны