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

Вложения

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Если кнопки нет, обычно распознавание выключено у агента, канал не передал картинку как поддержанное вложение, результат еще не готов или 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. Отправить сообщение.

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

Диагностика

Если вложение не отправляется, проверьте:

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