Вложения и голосовые в диалогах

Вложения

Откройте «Диалоги» в боковом меню проекта и выберите нужную переписку в списке. Внизу переписки нажмите кнопку с плюсом, чтобы добавить файл, или кнопку с микрофоном, чтобы начать запись голосового сообщения. До отправки ненужный файл можно убрать через крестик в предпросмотре.

В истории могут отображаться фото, изображения, стикеры, видео, документы, голосовые и другие вложения. Для некоторых вложений кабинет показывает AI-распознавание речи или анализ изображения.

Несколько фото или видео, отправленных одним альбомом Telegram, отображаются как одно сообщение с несколькими вложениями. Отдельные части могут быть без подписи: это не мешает сборке. Senler AI сначала собирает альбом и только затем начинает обработку. Альбом не создаёт отдельный запуск на каждый файл; итоговое количество ответов зависит от назначенных агентов и их ролей в диалоге.

Состояние вложения показывает, готов ли файл:

• «Файл не загружен» — вложение найдено в старой истории, но ещё не запрашивалось у платформы. Нажмите «Загрузить», только если файл действительно нужен. После успешной загрузки карточка обновится; при ошибке появится сообщение «Не удалось загрузить файл с платформы».
• "Файл готовится" - сервис получает файл с платформы.
• "Файл загружается" - файл сохраняется в хранилище.
• "VK обрабатывает видео" - VK ещё готовит исходное видео; это ожидание, а не ошибка загрузки.
• "Источник файла недоступен" - платформа больше не отдаёт исходный файл.
• "Не удалось сохранить файл" - исходник получен, но не сохранился в хранилище.
• "Файл не удалось получить с платформы" - точную причину определить не удалось.
• "Изображение недоступно" - ссылка на уже подготовленное изображение не открылась; если доступна внешняя ссылка, её кнопка остаётся на карточке.

Доставка исходящих вложений

Подготовка файла в Senler AI и его доставка в подключённый канал — разные этапы. Файл может успешно сохраниться в хранилище, но затем не быть принят Telegram, VK, MAX или другой платформой.

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

Если текст уже отправлен, а одно или несколько вложений не доставлены, сообщение помечается предупреждением «Текст отправлен, часть вложений не доставлена». Это не означает, что текст нужно отправлять повторно: сначала проверьте предупреждение у конкретного файла или откройте информацию о сообщении, где указано количество недоставленных вложений.

Отдельное ограничение действует для SVG в VK: платформа не принимает такой файл как фотографию. Перед отправкой преобразуйте изображение в PNG или JPEG.

Частые причины ошибок

• HTTP 404 - ссылка платформы недоступна или истекла.
• HTTP 403 - платформа запретила скачать файл, часто из-за прав канала.
• Timeout - платформа не ответила вовремя.
• Limit exceeded - файл больше текущего лимита загрузки вложений проекта.
• Source unavailable - исходная ссылка или файл больше недоступны на платформе.
• Upload failed - файл не удалось сохранить после получения.

Если файл больше лимита, кабинет предлагает открыть настройки лимита в хранилище проекта.

Старые вложения со статусом «Файл не загружен» не являются ошибкой и не требуют загрузки заранее. Загружать всю историю вручную не нужно: запрашивайте только конкретные файлы, которые хотите открыть, скачать или передать дальше.

Скачивание и ссылки

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

Пока копия файла сохраняется в хранилище Senler, вложение уже может открываться по безопасной ссылке платформы. После завершения подготовки кабинет использует сохранённую копию; пользователю не нужно переключать источник вручную.

В контекстном меню вложения также может быть действие "Открыть по ссылке", если у события есть внешняя ссылка платформы. Фото и стикеры обычно открываются через просмотрщик, а не через отдельное скачивание из меню.

Если вложение ещё обрабатывается или завершилось ошибкой, но платформа уже передала внешнюю ссылку, на самой карточке может отображаться отдельная кнопка открытия по ссылке. Она позволяет открыть исходный материал на платформе, не дожидаясь загрузки файла в Senler.

Распознавание изображений

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

Статусы распознавания:

• идет анализ - описание еще готовится;
• завершено - можно открыть описание и теги, если они есть;
• ошибка - изображение не удалось распознать.

Кнопка появляется только после статуса «завершено», когда результат содержит текст описания или найденные объекты. Во время обработки и при ошибке вместо кнопки показывается соответствующий статус; если распознавание для вложения не запускалось, отдельного блока нет.

Переслать себе

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

В окне «Отправить себе» кабинет загружает получателей: активных участников проекта с правом работы с диалогами, у которых есть подходящий аккаунт исходной платформы. Текущий пользователь отмечается как "Вы". Выберите получателя и нажмите «Отправить».

Если нужного аккаунта нет, нажмите «Добавить». Дальнейший шаг зависит от платформы:

• Telegram и MAX открывают ссылку бота; запустите бота и дождитесь автоматического появления аккаунта в списке. Ссылка создаётся для текущего пользователя и действует около 10 минут, поэтому просроченную ссылку нужно создать заново.
• VK может сначала предложить привязать VK-аккаунт. Затем в окне разрешения разрешите сообществу канала отправлять вам сообщения. Если список не обновился автоматически, нажмите «Проверить». Без этого разрешения сообщество не сможет переслать вам исходное сообщение.

Действие доступно только когда у вложения есть исходные данные платформы для пересылки. Сейчас это поддерживается для Telegram, VK и MAX, но конкретная кнопка зависит от канала, типа вложения и прав пользователя.

Если действие недоступно, проверьте платформу вложения, доступ к диалогу, привязанные аккаунты участников проекта и причину недоступности файла: лимит проекта, ограничение Telegram Bot API, отсутствие исходной ссылки или ошибка загрузки.

Видео

Видео из поддерживаемых MP4/MOV/M4V-контейнеров приводится к MP4 fast start, чтобы оно лучше открывалось в браузере. Если подготовка видео не удалась, но исходный файл доступен, кабинет может показать предупреждение и кнопку скачивания вместо обычного плеера.

Статус «VK обрабатывает видео» означает, что платформа ещё не отдала готовый файл. Не отправляйте видео повторно и не считайте его потерянным: подождите и обновите или заново откройте диалог. Когда VK завершит обработку, вложение подготовится автоматически; отдельная ошибка появится только если получить видео так и не удалось.

Структурированные вложения

Помимо файлов, в диалоге могут отображаться структурированные вложения: контакт, локация, чеклист, пересланное сообщение и карточки платформы.

Контакт показывает доступные поля из платформы: имя, телефон, username, ID пользователя, ссылку на профиль, vCard и признак бота, если платформа передала эти данные. Если у контакта MAX нет username или публичной ссылки, кабинет не может открыть профиль и показывает только доступные идентификаторы.

Локация показывает название, адрес и координаты. Если координаты доступны, карточку можно открыть на карте, а в инфопанели диалога - перейти в Яндекс Карты.

Чеклисты и пересланные сообщения

Чеклист показывает пункты, прогресс выполнения и, если платформа передала эти данные, кто и когда завершил пункт. Это помогает оператору видеть состояние задачи без перехода в исходную платформу.

Для пересланных сообщений кабинет показывает превью источника, если исходное событие найдено в истории проекта. Из превью можно перейти к связанному сообщению; если исходник не найден или недоступен, останется только информация, переданная платформой.

В пересланных сообщениях VK AI может учитывать доступный текст пересылки, сведения о вложениях и вложенных пересылках. Поэтому ответ может опираться на пересланное сообщение, даже если пользователь ничего не дописал. Если VK не передал текст, AI знает только о наличии пересылки и должен уточнить детали, а не придумывать её содержание.

Голосовые

Оператор может записать голосовое сообщение:

1. Нажать запись голосового.
2. Говорить.
3. Остановить и прикрепить запись.
4. Отправить сообщение.

Запись можно отменить до прикрепления.