Для работы со ссылками
(с уведомлением о клике, укорачивание ссылок, удаление ссылок)
Подробнее о работе с ссылками на практике рассказали в статье "Временно доступный контент".
Ссылки с уведомлением о клике
ОБОЗНАЧЕНИЯ:
! - Обязательные параметры
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.
Разберем простой пример:

Мы создали две прокси-ссылки и вывели их в кнопках и в тексте сообщения. Поскольку мы тестируемся в Telegram, то грех не напомнить как следует работать со ссылками в тексте с использованием Markdown. Поэтому понадобилось использовать функцию экранирования tg_escape()
Так созданные нами ссылки выглядят в карточке клиента:

Так клиент их видит, например, в Telegram:

При переходе клиента по ссылке мы получаем коллбэк:

Давайте настроим реакцию на данное событие:

Теперь проверим функции удаления ссылок:

После выполнения функции удаления всех одноразовых ссылок, отправленных клиенту, видим:

Таким образом, при попытке клиента перейти после удаления по одноразовой ссылке он получит ошибку, так как такой ссылки уже не существует:

Удалим ссылку, ограниченную временем:

По итогу исполнения функции в карточке клиента не осталось прокси-ссылок и попытка перехода по ссылке возвращает всё ту же ошибку:

Пример кода из поля Сообщение (не забудьте включить Markdown, если работаете с Telegram):
*Тестируем ссылки:*
[Клац](#{link3})или тестируйте со следующим выводом данных:
Тестируем ссылки:
#{link2}Пример кода из поля Калькулятор:
link1=proxy('https://ya.ru/', 1)
link2=short_date('https://yandex.ru/images', '11.06.2025', '14:00')
link3=tg_escape(link2)Укорачивание ссылок
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}, как твои дела ?", то вывод будет "Привет, Богдан, как твои дела ?". Однако, если такая переменная будет отсутствовать у клиента, то переменная будет взята из общих переменных проекта.
Внимание! Будьте внимательны с использованием ссылок без срока жизни: Если ссылка будет отправлена кому-то еще и этот кто-то пройдет опрос, то результаты будут записаны клиенту, для которого была создана данная ссылка.
Last updated
Was this helpful?