Файлы и вложения

Фото, PDF, видео, аудио, документы. Хранилище — папка Attachment/, раздача — GET /files/{путь}. В тексте сообщений вложения видны как маркеры, новый API отдаёт их структурированно.

1. Маркеры вложений в тексте

• [Фото: Attachment/file.jpg] — изображение (локальное или URL);
• [Файл: Attachment/doc.pdf] и [Файл "invoice.pdf": https://…] — документ;
• [Видео: …], [Аудио: …] — медиа.

GET /api/v1/bookings/{id}/view разбирает их в messages[].attachments[]: type (image/file/video/audio), name, source, url, is_remote. Превью — по url, скачивание — тоже.

2. Что умеет каждая платформа

MAX / Telegram

image, PDF, document — всё уходит (capabilities: max/telegram = image,pdf,document)

Avito

Только image. Документы и PDF отклоняются с 400 — отправьте гостю ссылку или перейдите в мессенджер

Суточно / Яндекс / Островок

Приём фото работает (скачивание в Attachment), отправка произвольных файлов ограничена API площадок

3. Отправка файлов

• Панель: скрепка 📎 (множественный выбор: image/video/audio, pdf, doc(x), xls(x), zip, rar, mp4, mov, mkv, webm, mp3, wav, m4a). Превью-миниатюры + кнопка × (убрать все).
• Legacy: POST /api/send-file (multipart: chat_id=платформа:id + file). Ответ: local_path, file_type, message-маркер.
• Avito-фото: POST /api/avito/send-image (chat_id + photo): сохранение → UploadAvitoImage → SendAvitoImageMessage → [Фото: …] в историю.
• Новое: POST /api/v1/bookings/{id}/attachments (multipart: file + platform опционально) — без знания external_chat_id.
• Лимит формы ~32 МБ. Большие видео — ссылкой.

4. Как скачиваются входящие

• Суточно: <img> src и attachments[].path → Attachment/sutochno-{thread}-{num}-…; миниатюры /g:…/base64 декодируются (base64 std/url-safe) в полный URL; повтор не качается.
• Яндекс: image FileInfo.Id2 → https://travel.yandex.ru/api/download/{id} → маркер [Фото: URL].
• Открытие на сервере: GET /api/open-file?path=… / /api/open-folder?path=… (только локальный Windows, наружу не публикуется).