Подробнее о работе с ссылками на практике рассказали в статье "Временно доступный контент".
Ссылки с уведомлением о клике
ОБОЗНАЧЕНИЯ:
! - Обязательные параметры
Описание
Разберем простой пример:
Мы создали две прокси-ссылки и вывели их в кнопках и в тексте сообщения. Поскольку мы тестируемся в Telegram, то грех не напомнить как следует работать со ссылками в тексте с использованием Markdown. Поэтому понадобилось использовать функцию экранирования tg_escape()
Так созданные нами ссылки выглядят в карточке клиента:
Так клиент их видит, например, в Telegram:
При переходе клиента по ссылке мы получаем коллбэк:
Давайте настроим реакцию на данное событие:
Теперь проверим функции удаления ссылок:
После выполнения функции удаления всех одноразовых ссылок, отправленных клиенту, видим:
Таким образом, при попытке клиента перейти после удаления по одноразовой ссылке он получит ошибку, так как такой ссылки уже не существует:
Удалим ссылку, ограниченную временем:
По итогу исполнения функции в карточке клиента не осталось прокси-ссылок и попытка перехода по ссылке возвращает всё ту же ошибку:
Пример кода для копирования
Пример кода из поля Сообщение (не забудьте включить Markdown, если работаете с Telegram):
*Тестируем ссылки:*
[Клац](#{link3})
или тестируйте со следующим выводом данных:
Пример кода из поля Калькулятор:
link1=proxy('https://ya.ru/', 1)
link2=short_date('https://yandex.ru/images', '11.06.2025', '14:00')
link3=tg_escape(link2)
Параметры
proxy(lnk, one-shot) - для получения ссылки с уведомлением о клике. На вход передаются параметры:
! link - ссылка
one-shot - признак того, что ссылка одноразовая. Достаточно передать 1.
proxy_date(lnk, date, time) - для получения ссылки с уведомлением о клике с заданным временем окончания доступа к ней. На вход передаются параметры:
! link - ссылка
! date - дата окончания действия ссылки
! time - время окончания действия ссылки
one-shot - признак того, что ссылка одноразовая. Достаточно передать 1.
proxy_timeout(lnk, minutes, one-shot) - для получения ссылки с уведомлением о клике с заданным таймером доступа к ней. На вход подаются параметры:
! link - ссылка
! minutes - количество минут, которые действует ссылка.
one-shot - признак того, что ссылка одноразовая. Достаточно передать 1.
В результате перехода клиента по прокси-ссылкам Вы получите колбек вида link_was_pressed <ссылка>
Таким образом можно настроить реакцию на переход по ссылке. Для этого в поле Условие введите получаемый колбек и укажите тип сопоставления Полное совпадение
Укорачивание ссылок
short() | short_date() | short_timeout()
ОБОЗНАЧЕНИЯ:
! - Обязательные параметры
Описание
short(lnk, one-shot) — для получения ссылки без уведомления о клике. На вход передаются параметры:
! link - ссылка
one-shot — признак того, что ссылка одноразовая. Достаточно передать 1.
short_date(lnk, date, time) — для получения ссылки без уведомления о клике с заданным временем окончания доступа к ней. На вход передаются параметры:
! link — ссылка
! date — дата окончания действия ссылки
! time — время окончания действия ссылки
one-shot — признак того, что ссылка одноразовая. Достаточно передать 1.
short_timeout(lnk, minutes, one-shot) — для получения ссылки без уведомления о клике с заданным таймером доступа к ней. На вход подаются параметры:
! link — ссылка
! minutes — количество минут, которые действует ссылка.
one-shot — признак того, что ссылка одноразовая. Достаточно передать 1.
Удаление ссылок
remove_links() | remove_one_time_links()| remove_timer_links()
ОБОЗНАЧЕНИЯ:
! - Обязательные параметры
Параметры
remove_links() - деактивация всех коротких ссылок, отправленных клиенту. Функция без параметров.
remove_one_time_links() - деактивация всех одноразовых ссылок, отправленных клиенту, без параметров.
remove_timer_links() - деактивация всех временно доступных ссылок, отправленных клиенту, без параметров.
Ссылка на квиз для Telegram-бота
quiz_link_timeout() | quiz_link_date() | quiz_link()
Обращаем внимание!
Существует ограничение на время действительности ссылки - 21 день, поэтому ссылку необходимо обновлять!
Для подключения возможности отображения квиз-ссылки в Telegram необходимо:
1. Скопировать id сайта: для этого перейдите в раздел "Сайты", затем выберите нужный сайт. На карточке с информацией о сайте вы найдете его ID.
ID сайта передается в параметр mini_landing_page_id.
2. В поле калькулятор используется одна из функций:
ОБОЗНАЧЕНИЯ:
! - Обязательные параметры
Параметры
quiz_link_timeout(mini_landing_page_id, minutes) - создает ссылку с ограничением срока жизни ссылки в минутах
Параметры:
! mini_landing_page_id - идентификатор страницы сайта
minutes - минуты жизни ссылки, тип число
quiz_link_date(mini_landing_page_id, date, time) - создает ссылку с ограничением срока жизни ссылки до конкретного дня и часа
Параметры:
! mini_landing_page_id - идентификатор страницы сайта
date - дата действия ссылки, формат: дд.мм.гггг
time - время действия ссылки, формат: чч:мм
quiz_link(mini_landing_page_id) - создает ссылку без ограничения срока жизни ссылки
Параметры:
! mini_landing_page_id - идентификатор страницы сайта
Далее короткую срочную ссылку можно передать с помощью переменной в сообщении:
Если вы используете quiz_link_timeout для перехода клиента насайта, то вы можете пользоваться переменными клиента внутри описания и заголовка. Например, если у клиента есть переменная name со значением "Богдан" и в описании страницы сайта вы напишите "Привет #{name}, как твои дела ?", то вывод будет "Привет, Богдан, как твои дела ?". Однако, если такая переменная будет отсутствовать у клиента, то переменная будет взята из общих переменных проекта.
Внимание! Будьте внимательны с использованием ссылок без срока жизни: Если ссылка будет отправлена кому-то еще и этот кто-то пройдет опрос, то результаты будут записаны клиенту, для которого была создана данная ссылка.