Вкладка вложений
Этот блок поддерживает следующие типы вложений:
Ссылка
Видео
Изображение
Файл
Аудио
В одном блоке НЕЛЬЗЯ комбинировать разные типы вложений!
Вложения, загружаемые в конструктор, не должны превышать 20 МБ.
Отправка до 10 вложений одного и того же типа в одном блоке разрешена.
Также вы можете сгенерировать изображение с помощью "Сгенерировать изображение" кнопки и отправить его своему клиенту.
Как отправлять вложения
Чтобы отправить вложение, создайте пустой блок и откройте редактор блока (правое меню).
Важно!
Загруженное вложение не должно превышать 20 МБ. Отправка до 10 вложений одного и того же типа в одном блоке разрешена.
Не рекомендуется отправлять блок с несколькими вложениями в рассылке, чтобы не столкнуться с лимитами API разных мессенджеров.
НЕ назначайте одно и то же имя разным вложениям в рамках одного проекта!
Если вы загружаете новое вложение с тем же именем, что и существующее, система доставит исходный файл. Чтобы избежать ошибок и обеспечить корректную работу блока, всегда присваивайте вложениям уникальные имена.
Обратите внимание!
Особенности Telegram:
Кнопки не будет отображаться при отправке более одного вложения в блоке.
Исключение: Если текст блока превышает 1024 символа, сообщение будет разделено на два — кнопки будут показаны вместе с текстом, а вложения будут отправлены отдельным сообщением.
Форматирование текста Markdown и HTML не работает при отправке более одного вложения в блоке.
Все настройки вложений находятся в настройках блока, доступных по нажатию на "Вложение" .
Давайте подробнее рассмотрим новые появившиеся кнопки для типов вложений.
Ссылка
Первая кнопка — Ссылка:
Нажмите кнопку, чтобы открыть настройки вложения.
Вариант A: введите URL в указанное поле, чтобы поделиться ссылкой.
Вариант B: загрузите файл; клиент увидит его как отдельную ссылку для скачивания.
Прикреплённый файл будет отправлен в виде ссылки с сервера mavibot.ai.
Загруженный файл имеет приоритет над ссылкой. Если указаны оба варианта, будет отправлен загруженный файл.
Под полем URL есть три флажка:
Уведомление о клике: Если включено, бот зафиксирует клик пользователя, отправив сообщение в формате
link_was_pressed [link1] [link2].
Для чего это используется?
Это событие позволяет отслеживать, какие пользователи нажали на ссылку. Когда флажок включён, система отправляет в диалог callback в формате:
link_was_pressed {url}
В этом callback link_was_pressed — это фиксированный префикс, а {url} — переменная, представляющая конкретный URL, который вы настроили в блоке.
Например, вы можете затем отправлять клиентам напоминания.
Чтобы узнать, как настроить ответ бота на callback нажатия ссылки, см. раздел ниже под названием Отслеживание кликов по ссылкам.
Вы можете задать свой домен для генерации ссылок с уведомлениями о клике.
Для этого перейдите в настройки проекта:
Нажмите кнопку «Установить собственный домен...» и введите свой домен в модальном окне:
Когда уведомление о клике включено, ссылка, отправляемая пользователю, будет иметь следующий вид:
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 секунды.
Последнее обновление