Работа с вложениями и ссылками
В статье расскажем, как отправлять вложения в чат-боте
Как отправить вложения
Чтобы отправить вложение, создаем пустой блок и открываем редактор блоков (правое меню).
Обращаем внимание!
Загруженное вложение должно быть не больше 20 Mb. Допустима отправка до 10 вложений одного типа в одном блоке;
Не рекомендуется отправлять блок с несколькими вложениями в рассылке, чтобы не упереться в лимит API разных мессенджеров;
НЕЛЬЗЯ присваивать одно и то же имя разным вложениям в рамках одного проекта! Если вы загрузите другое вложение с тем же именем, которое присвоено уже существующему вложению в проекте, отправится то, которое вы загрузили в систему раньше. Для правильной работы блоков присваивайте вложениям различные названия во избежание ошибок!
Обращаем внимание!
Особенности в Telegram:
кнопки НЕ придут при отправке более одного вложения в блоке.
Исключение: Если в блоке текст > 1024 символов, то такая отправка будет разделена на 2 сообщения, и кнопки придут вместе с текстом, а вложения отдельным сообщением.
Разметка текста markdown и html не работает при отправке более одного вложения в блоке.
Все настройки вложений находятся в настройках блока, которые открываются при клике на кнопку "Вложения":

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

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

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

С уведомлением о клике - значит, что когда пользователь перейдет по ссылке, бот вернет ответ в виде: 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":


Чекбокс "Показывать превью ссылок"

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

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

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

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

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

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

Аудиофайл должен иметь формат .ogg и быть менее 1Мб
Для Instagram формат файла .m4a
Отправка множественных файлов
Для отправки нескольких видеовложений/файлов/картинок/аудио в разделе "Вложения" редактора блока укажите нужный тип вложений и выполните загрузку необходимых файлом по одному:

В Телеграм:
кнопки НЕ придут при отправке более одного вложения в блоке.
Исключение: Если в блоке текст > 1024 символов, такая отправка будет разделена на 2 сообщения и кнопки придут вместе с текстом, а вложения отдельным сообщением.
Разметка текста markdown и html не работает при отправке более одного вложения в блоке
Пример отправки вложений
Перейдем к примерам.
Добавим в бота автоматическую отправку каждые 2 секунды. В каждом блоке добавим разные типы вложений и посмотрим, как это выглядит в мессенджере Телеграм.

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

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

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

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

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

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

Либо пропишите вручную в формате "link_was_pressed пробел ссылка".
В настройках второй стрелки:
Ставим задержку отправки блока: это даст время клиенту перейти по ссылке;
Активируем чекбокс "Не отправлять, если покинул блок": это нужно для того, если клиент нажмет на ссылку и перейдет в блок "Перешел по ссылке", второй блок "Не перешел по ссылке" спустя установленное в стрелке время НЕ отработал.


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

Теперь вы умеете отправлять различные типы файлов/вложений, а также отслеживать переходы по ссылкам с помощью чат-бота. Использовать данный функционал можно как в повседневных целях (рассылки, отправка чек листов и т.д.), так и в более сложных воронках с дальнейшем "подогревом" клиентов в зависимости от их действий в боте.
Как разместить ссылку со слежением в кнопку
Ссылка с уведомлением о клике выглядит специфично, поэтому есть смысл размещать эти ссылки в кнопках. Для этого вам нужно создать переменную со ссылкой со слежением и разместить ее в кнопке.
Для создания ссылки со слежением необходимо вызвать функцию proxy('ВАША ССЫЛКА') в калькуляторе.
Для этого пропишите переменную, например, link, значение которой равно функции с вашей ссылкой:

Теперь переменную, в которой записана ссылка с уведомлением о клике, можно разместить в тексте или поставить в кнопку.
ПРИМЕР: ссылка с уведомление о клике в тексте сообщения:

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

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

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

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

Если в вашем проекте используется несколько вложений от пользователя, то удобно присваивать для url каждого из них собственную переменную. Для этого в редакторе блока в поле Калькулятор объявите переменную, в которую сохраните полученный url вложения.
Ваша_переменная = #{attachment_url}
, как на Рисунке 3.

attachment_url
Last updated
Was this helpful?