Этот блок поддерживает следующие типы вложений:
- Ссылка
- Видео
- Изображение
- Файл
- Аудио
В одном блоке НЕЛЬЗЯ комбинировать разные типы вложений!
Загружаемые в конструктор вложения не должны превышать 20 МБ.
Допускается отправка до 10 вложений одного типа в одном блоке.
Вы также можете сгенерировать изображение с помощью кнопки «Сгенерировать изображение» и отправить его клиенту.
Как отправлять вложения
Чтобы отправить вложение, создайте пустой блок и откройте редактор блока (правое меню).
Важно!
- Загружаемое вложение не должно превышать 20 МБ. Допускается отправка до 10 вложений одного типа в одном блоке.
- Не рекомендуется отправлять блок с несколькими вложениями в рассылке, чтобы избежать превышения лимитов API различных мессенджеров.
- НЕ присваивайте одинаковые имена разным вложениям в рамках одного проекта!
- Если вы загрузите новое вложение с тем же именем, что и существующее, система доставит исходный файл. Чтобы избежать ошибок и обеспечить корректную работу блока, всегда присваивайте вложениям уникальные имена.
Обратите внимание!
Особенности Telegram:
- Кнопки НЕ будут отображаться при отправке более одного вложения в блоке.
- Исключение: Если текст блока превышает 1024 символа, сообщение будет разделено на два — кнопки появятся с текстом, а вложения будут отправлены отдельным сообщением.
- Форматирование текста Markdown и HTML не работает при отправке более одного вложения в блоке.
Все настройки вложений находятся в настройках блока, доступных по нажатию кнопки «Вложение».
Давайте подробнее рассмотрим появившиеся кнопки для типов вложений.
Ссылка
Первая кнопка — Ссылка:
- Нажмите кнопку, чтобы открыть настройки вложения.
- Вариант A: Введите URL в предоставленное поле, чтобы поделиться ссылкой.
- Вариант B: Загрузите файл; он будет представлен клиенту в виде отдельной ссылки для скачивания.
Прикрепленный файл будет отправлен в виде ссылки с сервера mavibot.ai.
Загруженный файл имеет приоритет над ссылкой. Если указаны оба, будет отправлен загруженный файл.
Под полем URL находятся три флажка:
-
Уведомление о клике: При включении бот будет регистрировать клик пользователя, отправляя сообщение в формате
link_was_pressed [link1] [link2].
Для чего это используется?
Это событие позволяет отслеживать, какие пользователи нажали на ссылку. Когда флажок включен, система отправляет обратный вызов в диалог в формате:
link_was_pressed {url}
В этом обратном вызове link_was_pressed — это фиксированный префикс, а {url} — переменная, представляющая конкретный URL, который вы настроили в блоке.
Например, вы можете отправить последующие напоминания клиентам.
Чтобы узнать, как настроить ответ бота на обратный вызов при клике по ссылке, см. раздел ниже Отслеживание кликов по ссылкам.
Вы можете установить собственный домен для генерации ссылок с уведомлениями о кликах.
Для этого перейдите в настройки вашего проекта:
Нажмите кнопку «Установить пользовательский домен...» и введите ваш домен в модальном окне:
Процесс создания и настройки пользовательского домена описан здесь.
Когда уведомление о клике включено, ссылка, отправленная пользователю, будет отформатирована следующим образом:
https://{your_domain}/{proxy_id}/s
- Флажок «Показать превью ссылки»
Это генерирует расширенный предварительный просмотр ссылки в мессенджере, позволяя пользователю увидеть фрагмент содержимого файла (например, заголовок, изображение или описание) перед его открытием.
- Флажок «Изображение под текстом»
Вложение видео
Кнопка вложения видео
Используйте этот параметр при отправке видео. По умолчанию WhatsApp отображает видео только в виде ссылок.
Чтобы отображать видео с YouTube в виде ссылок во всех мессенджерах:
- Сократите URL с помощью любого сервиса сокращения ссылок, или
- Отправьте его как вложение с включенным уведомлением о клике.
Примечание!
Telegram автоматически преобразует небольшие видео-вложения (менее ~2 МБ) в GIF.
Для больших видео, хранящихся во внешнем хранилище, лучше прикреплять их в виде ссылок. Блок имеет ограничение на прямую загрузку видеофайлов размером 20 МБ.
Обратите внимание!
Видео прикрепляется в формате MP4.
Изображение
Кнопка «Изображение» — используйте ее для отправки необходимых изображений в боте.
Как и любое другое вложение, изображение можно загрузить непосредственно с вашего компьютера или указав его URL.
Файл
Значок «Файл» — используйте его для отправки документов и любых других файлов.
Аудио
Значок «Аудио»: используйте этот значок при прикреплении или отправке файла в аудиоформате (например, MP3, WAV).
Для Instagram формат файла должен быть .m4a.
Отправка нескольких файлов
Чтобы отправить несколько вложений (видео, файлы, изображения или аудио):
- Перейдите в раздел «Вложение» в редакторе блока.
- Выберите нужный тип вложения.
- Загрузите необходимые файлы один за другим.
Пожалуйста, учитывайте следующие ограничения при отправке нескольких вложений:
Общие лимиты:
- Количество: вы можете добавить до 10 файлов одного типа одновременно.
- Размер: каждый отдельный файл не должен превышать 20 МБ.
Особенности Telegram:
- Форматирование текста: форматирование markdown или HTML отключено в сообщениях, содержащих несколько файлов.
- Кнопки: интерактивные кнопки не доставляются с несколькими вложениями файлов.
В Telegram:
- Кнопки отключаются, когда блок содержит более одного вложения.
Исключение: Если текст блока превышает 1024 символа, сообщение разделяется. Кнопки будут отправлены с текстом, а вложения доставлены отдельным сообщением.
- Форматирование текста Markdown и HTML не работает при отправке более одного вложения в блоке.
Отправка вложений: примеры
Перейдем к практическим примерам. Мы настроим бота на автоматическую отправку сообщений с интервалом в 2 секунды.
В каждый пример блока мы включим разный тип вложения, чтобы продемонстрировать, как они отображаются в Telegram.
Пример потока демонстрирует различные типы вложений — файл, ссылка, видео, изображение и аудио — отправленные последовательно с задержкой в 2 секунды.
