Вкладка вкладень
Цей блок підтримує такі типи вкладень:
Посилання
Відео
Зображення
Файл
Аудіо
В одному блоці ВИ НЕ МОЖЕТЕ поєднувати різні типи вкладень!
Вкладення, завантажені в конструктор, не повинні перевищувати 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 за допомогою будь-якого скорочувача URL або
Надішліть його як вкладення з сповіщенням про клік увімкненим.
Увага!
Telegram автоматично перетворює невеликі відеовкладення (менші за ~2 МБ) на GIF.
Для великих відео, що зберігаються у зовнішньому сховищі, краще додавати їх як посилання. У блоці є прямий ліміт завантаження 20 МБ для відеофайлів.
Зверніть увагу!
Відео додається у форматі MP4.
Зображення
кнопка «Зображення» — використовуйте її, щоб надсилати потрібні зображення в боті.
Як і будь-яке інше вкладення, зображення можна завантажити безпосередньо з комп’ютера або вказавши його URL.
Файл
Файл іконка — використовуйте її, щоб надсилати документи та будь-які інші файли.
Аудіо
Іконка аудіо: використовуйте цю іконку під час додавання або надсилання файлу в аудіоформаті (наприклад, MP3, WAV).
Для Instagram формат файлу має бути .m4a.
Надсилання кількох файлів
Щоб надіслати кілька вкладень (відео, файли, зображення або аудіо):
Перейдіть до «Вкладення» розділу в редакторі блоку.
Виберіть потрібний тип вкладення.
Завантажуйте потрібні файли по одному.
Будь ласка, зверніть увагу на такі обмеження під час надсилання кількох вкладень:
Загальні обмеження:
Кількість: ви можете додати до 10 файлів одного типу одночасно.
Розмір: кожен окремий файл не повинен перевищувати 20 МБ.
Особливості Telegram:
Форматування тексту: форматування markdown або HTML вимкнено в повідомленнях, що містять кілька файлів.
Кнопки: інтерактивні кнопки не надсилаються разом із кількома вкладеннями файлів.
У Telegram:
Кнопки вимикаються, коли блок містить більше ніж одне вкладення.
Виняток: Якщо текст блоку перевищує 1024 символи, повідомлення розділяється. Кнопки буде надіслано разом із текстом, а вкладення — в окремому повідомленні.
Форматування тексту Markdown і HTML не працює під час надсилання більш ніж одного вкладення в блоці.
Надсилання вкладень: приклади
Перейдемо до практичних прикладів. Ми налаштуємо бота на автоматичне надсилання повідомлень із 2-секундними інтервалами.
У кожному прикладному блоці ми включимо різний тип вкладення, щоб показати, як вони відображаються в Telegram.
У прикладному сценарії послідовно демонструються різні типи вкладень — файл, посилання, відео, зображення та аудіо — із 2-секундною затримкою.
Last updated