Работа с вложениями и ссылками

В статье расскажем, как отправлять вложения в чат-боте

Как отправить вложения

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

Все настройки вложений находятся в настройках блока, которые открываются при клике на кнопку "Вложения":

Давайте подробнее рассмотрим появившиеся кнопки с типами вложений:

Ссылка

Первый кнопка - ссылка:

При клике на кнопку появляются поля для указания URL вложения либо загрузки вложения, где вы можете добавить ссылку (URL вложения) для перехода клиентом или соответственно загрузить тот файл, который хотите передать (он будет показан в отдельной ссылке).

Прикрепленный файл будет отправлен ссылкой с сервера salebot.pro.

Загруженный файл имеет приоритет перед ссылкой на файл. Если вы укажите ссылку и одновременно прикрепите файл, то будет отправлен файл.

Под полем для URL есть три чекбокса:

  1. С уведомлением о клике - значит, что когда пользователь перейдет по ссылке, бот вернет ответ в виде: link_was_pressed и ссылки через пробел.

Для чего это нужно?

С помощью этого события можно разделять пользователей на тех, кто перешел по ссылке и тех, кто не перешел. Если активировать чекбокс, то в диалоге с клиентом будет приходить колбек следующего вида: "link_was_pressed https://salebot.pro", где link_was_pressed - неизменяемая часть колбека, https://salebot.pro - URL, который был указан Вами в блоке.

Например, можно "догревать", отправляя клиентам напоминания.

Как настроить реакцию бота на колбек перехода по ссылке, читайте ниже в разделе "Отслеживание клика по ссылке"

По умолчанию ссылка с уведомлением о клике имеет вид "https://sblnk.ru/{proxy_id}". Вы можете задать свой домен для формирования ссылок с уведомлением.

Для этого перейдите в настройки проекта:

Кликните по кнопке "Установить собственный домен..." и в модальном окне укажите домен:

Подробнее о создании и настройке собственного домена рассказали здесь.

Тогда ссылка с уведомлением о клике примет вид: "https://{ваш домен}/{proxy_id}/s":

Пример использования своего домена для формирования коротких ссылок
  1. Чекбокс "Показывать превью ссылок"

Значит, что в месседжерах помимо самой ссылки будет видно, что за файл вы отправляете.

  1. Чекбокс "Изображение ниже текста"

Видео-вложение

Кнопка Видео-вложение:

Выбирайте при отправке видео. В Whatsapp видео отображается только ссылкой. Если вам нужно и в других мессенджерах, чтобы видео с Ютуба приходило просто ссылкой, то можно ссылку прогнать через любой сократитель ссылок или отправить как вложение с уведомлением о клике.

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

Важно! У Telegram есть особенность: если размер видео слишком маленький (примерно до 2 мб), то видео-вложение отправляется в формате .gif.

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

Картинка

Кнопка "Изображение" - выбирайте при отправке необходимых изображений в боте.

Как и любое другое вложение, изображение можно загрузить прямо с компьютера или указать его URL.

Файл

Значок - файл - используйте при отправке документов и любых других файлов.

Аудио

Значок - Аудио - используйте, если тип отправляемого файла имеет аудио формат.

Отправка множественных файлов

Для отправки нескольких видеовложений/файлов/картинок/аудио в разделе "Вложения" редактора блока укажите нужный тип вложений и выполните загрузку необходимых файлом по одному:

Не забывайте про ограничения при отправке нескольких файлов!

  • Добавить можно одновременно до 10 файлов одного типа

  • Каждый файл не должен превышать размер 20Мб

  • При отправке нескольких вложений в Телеграм важно учесть: - При отправке более одного файла не работает разметка текста markdown, html - При множественной отправке файлов нельзя отправить кнопки

В Телеграм:

  • кнопки НЕ придут при отправке более одного вложения в блоке.

Исключение: Если в блоке текст > 1024 символов, такая отправка будет разделена на 2 сообщения и кнопки придут вместе с текстом, а вложения отдельным сообщением.

  • Разметка текста markdown и html не работает при отправке более одного вложения в блоке

Пример отправки вложений

Перейдем к примерам.

Добавим в бота автоматическую отправку каждые 2 секунды. В каждом блоке добавим разные типы вложений и посмотрим, как это выглядит в мессенджере Телеграм.

В каждом из блоков в схеме, представленной на примере выше, загружены разные типы вложений: файл, ссылка, видео, изображение и аудио. Интервал отправки - 2 секунды.

Отслеживание клика по ссылке

Создадим блок, в который вложим ссылку:

Далее создадим из блока первостепенной проверки условия создадим еще два блока: в одном напишем "Перешел по ссылке" во втором "НЕ перешел по ссылке":

Переходим в настройки стрелки, ведущей от блока первостепенной проверки к блоку "Перешел по ссылке":

В поле Условие в настройках стрелки нужно указать коллбек "link_was_pressed #{ВАША ССЫЛКА}":

Чтобы скопировать колбек, отправьте блок с ссылкой и перейдите по ссылке в чате с ботом. Тогда колбек придет в диалоге с клиентом:

Либо пропишите вручную в формате "link_was_pressed пробел ссылка".

В настройках второй стрелки:

  1. Ставим задержку отправки блока: это даст время клиенту перейти по ссылке;

  2. Активируем чекбокс "Не отправлять, если покинул блок": это нужно для того, если клиент нажмет на ссылку и перейдет в блок "Перешел по ссылке", второй блок "Не перешел по ссылке" спустя установленное в стрелке время НЕ отработал.

Тестируем бота:

Теперь вы умеете отправлять различные типы файлов/вложений, а также отслеживать переходы по ссылкам с помощью чат-бота. Использовать данный функционал можно как в повседневных целях (рассылки, отправка чек листов и т.д.), так и в более сложных воронках с дальнейшем "подогревом" клиентов в зависимости от их действий в боте.

Как разместить ссылку со слежением в кнопку

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

Для создания ссылки со слежением необходимо вызвать функцию proxy('ВАША ССЫЛКА') в калькуляторе.

Для этого пропишите переменную, например, link, значение которой равно функции с вашей ссылкой:

Теперь переменную, в которой записана ссылка с уведомлением о клике, можно разместить в тексте или поставить в кнопку.

ПРИМЕР: ссылка с уведомление о клике в тексте сообщения:

Обратите внимание, переменная передана через конструкцию #{ВАША ССЫЛКА} - это обязательно.

ПРИМЕР: ссылка с уведомление о клике добавлена в настройки кнопки:

  1. Создайте кнопку

  1. В поле URL укажите вашу переменную через конструкцию #{ВАША ССЫЛКА}, функция кнопки "По умолчанию":

Полезные статьи:

  1. Функции для создания ссылок с уведомлением о клике и сроком действия можно прочитать в статье "Для работы с ссылками"

  2. Подобнее о том, как разместить ссылку в кнопке, вы можете прочитать в статье "Кнопки"

Видеоинструкция

Получение изображений и файлов от пользователя

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

Чтобы определить, что пользователь отправил какое-либо вложение (изображение, файл, видео и пр.), необходимо в условии указать attachment_message:

Настройки стрелки для получения файлов от клиента

После того, как отправлен файл, появляются две переменные: #{attachments} - url вложений к сообщению пользователя в формате JSON массива #{attachment_url} - в этой переменной содержится обычная url ссылка на вложение, например, для последующего использования в боте.

Чтобы понять, чем отличаются attachments и attachment_url друг от друга, выведите их на экран:

Если в вашем проекте используется несколько вложений от пользователя, то удобно присваивать для url каждого из них собственную переменную. Для этого в редакторе блока в поле Калькулятор объявите переменную, в которую сохраните полученный url вложения.

Ваша_переменная = #{attachment_url}, как на Рисунке 3.

Присвоить переменной url_image1 значение attachment_url

Видео-урок "Получение файлов от пользователя"

Last updated

Was this helpful?