Цей блок підтримує такі типи вкладень:

  • Посилання
  • Відео
  • Зображення
  • Файл
  • Аудіо

В одному блоці НЕ МОЖНА комбінувати різні типи вкладень!

Вкладення, завантажені в конструктор, не повинні перевищувати 20 МБ.

Дозволяється надсилати до 10 вкладень одного типу в одному блоці.

Ви також можете згенерувати зображення за допомогою кнопки «Згенерувати зображення» та надіслати його клієнту.

Як надсилати вкладення

Щоб надіслати вкладення, створіть порожній блок і відкрийте редактор блоку (праве меню).

Важливо!

  1. Завантажене вкладення не повинно перевищувати 20 МБ. Дозволяється надсилати до 10 вкладень одного типу в одному блоці.
  2. Не рекомендується надсилати блок із кількома вкладеннями у розсилці, щоб уникнути перевищення лімітів API різних месенджерів.
  3. НЕ призначайте однакові назви різним вкладенням в межах одного проєкту!
  4. Якщо ви завантажите нове вкладення з такою ж назвою, як у наявного, система доставить оригінальний файл. Щоб уникнути помилок і забезпечити коректну роботу блоку, завжди давайте вкладенням унікальні назви.

Зверніть увагу!

Особливості Telegram:

  • Кнопки НЕ з'являться під час надсилання більше одного вкладення в блоці.
  • Виняток: Якщо текст блоку перевищує 1024 символи, повідомлення буде розділено на два — кнопки з'являться з текстом, а вкладення будуть надіслані окремим повідомленням.
  • Форматування тексту Markdown і HTML не працює під час надсилання більше одного вкладення в блоці.

Усі налаштування вкладень знаходяться в налаштуваннях блоку, доступ до яких здійснюється натисканням кнопки «Вкладення».

Розглянемо детальніше нові кнопки для типів вкладень.

Посилання

Перша кнопка — Посилання:

  1. Натисніть кнопку, щоб відкрити налаштування вкладення.
  2. Варіант A: введіть URL у відповідне поле, щоб поділитися посиланням.
  3. Варіант B: завантажте файл; він буде представлений клієнту як окреме посилання для завантаження.

Прикріплений файл буде надіслано як посилання з сервера mavibot.ai.

Завантажений файл має пріоритет над посиланням. Якщо вказано обидва, буде надіслано завантажений файл.

Під полем URL є три прапорці:

  1. Сповіщення про натискання: Якщо ввімкнено, бот реєструватиме натискання користувача, надсилаючи повідомлення у форматі link_was_pressed [link1] [link2].

Для чого це використовується?

Ця подія дозволяє відстежувати, які користувачі натиснули посилання. Коли прапорець увімкнено, система надсилає зворотний виклик у діалог у форматі:

link_was_pressed {url}

У цьому зворотному виклику link_was_pressed — це фіксований префікс, а {url} — змінна, що представляє конкретний URL, який ви налаштували в блоці.

Наприклад, ви можете надсилати нагадування клієнтам.

Щоб дізнатися, як налаштувати відповідь бота на зворотний виклик натискання посилання, перегляньте розділ нижче під назвою Відстеження натискань посилань.

Ви можете встановити власний домен для генерації посилань зі сповіщеннями про натискання.

Для цього перейдіть у налаштування вашого проєкту:

Натисніть кнопку «Встановити власний домен...» і введіть свій домен у модальному вікні:

Процес створення та налаштування власного домену описано тут.

Коли сповіщення про натискання ввімкнено, посилання, надіслане користувачеві, матиме такий формат:

https://{your_domain}/{proxy_id}/s

  1. Прапорець «Показати попередній перегляд посилання»

Це генерує багатий попередній перегляд посилання в месенджері, дозволяючи користувачеві побачити фрагмент вмісту файлу (наприклад, заголовок, зображення або опис) перед відкриттям.

  1. Прапорець «Зображення під текстом»

Вкладення відео

Кнопка вкладення відео

Використовуйте цю опцію під час надсилання відео. За замовчуванням WhatsApp відображає відео лише як посилання.

Щоб відображати відео з YouTube як посилання в усіх месенджерах:

  • Скоротіть URL за допомогою будь-якого скорочувача посилань, або
  • Надішліть його як вкладення з увімкненим сповіщенням про натискання.

Зверніть увагу!

Telegram автоматично перетворює невеликі відеовкладення (менше ~2 МБ) на GIF.

Для великих відео, що зберігаються у зовнішньому сховищі, краще прикріплювати їх як посилання. Блок має ліміт прямого завантаження 20 МБ для відеофайлів.

Зверніть увагу!

Відео прикріплюється у форматі MP4.

Зображення

Кнопка «Зображення» — використовуйте її для надсилання потрібних зображень у боті.

Як і будь-яке інше вкладення, зображення можна завантажити безпосередньо з комп'ютера або вказавши його URL.

Файл

Значок «Файл» — використовуйте для надсилання документів та будь-яких інших файлів.

Аудіо

Значок «Аудіо»: використовуйте цей значок під час прикріплення або надсилання файлу в аудіоформаті (наприклад, MP3, WAV).

Для Instagram формат файлу має бути .m4a.

Надсилання кількох файлів

Щоб надіслати кілька вкладень (відео, файли, зображення або аудіо):

  1. Перейдіть до розділу «Вкладення» в редакторі блоку.
  2. Виберіть потрібний тип вкладення.
  3. Завантажте необхідні файли один за одним.

Зверніть увагу на наступні обмеження під час надсилання кількох вкладень:

Загальні ліміти:

  • Кількість: ви можете додати до 10 файлів одного типу одночасно.
  • Розмір: кожен окремий файл не повинен перевищувати 20 МБ.

Специфіка Telegram:

  • Форматування тексту: форматування markdown або HTML вимкнено в повідомленнях, що містять кілька файлів.
  • Кнопки: інтерактивні кнопки не доставляються з кількома вкладеними файлами.

У Telegram:

  • Кнопки вимкнено, коли блок містить більше одного вкладення.

Виняток: Якщо текст блоку перевищує 1024 символи, повідомлення розділяється. Кнопки будуть надіслані з текстом, а вкладення доставляються окремим повідомленням.

  • Форматування тексту Markdown і HTML не працює під час надсилання більше одного вкладення в блоці.

Надсилання вкладень: приклади

Перейдемо до практичних прикладів. Ми налаштуємо бота на автоматичне надсилання повідомлень з інтервалом у 2 секунди.

У кожному прикладі блоку ми включимо різний тип вкладення, щоб продемонструвати, як вони відображаються в Telegram.

Приклад потоку демонструє різні типи вкладень — файл, посилання, відео, зображення та аудіо — надіслані послідовно із затримкою в 2 секунди.