Для работы со ссылками

(с уведомлением о клике, укорачивание ссылок, удаление ссылок)

Ссылки с уведомлением о клике

proxy() | proxy_date() | proxy_timeout()

ОБОЗНАЧЕНИЯ:

! - Обязательные параметры

Разберем простой пример:

Мы создали две прокси-ссылки и вывели их в кнопках и в тексте сообщения. Поскольку мы тестируемся в 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 день.

Поэтому ссылку необходимо обновлять!

Для того, чтобы подключить возможность отображения квиза в телеграмме, необходимо:

1. Скопировать 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 - идентификатор страницы сайта

3. Создать кнопку Telegram Web Application и указать в фигурных скобках с решеткой название переменной

Важно! Проверьте, чтобы значение переменной правильно записалось в расширенные настройки:

Если вы используете quiz_link_timeout для перехода клиента на страницу сайта, то вы можете пользоваться переменными клиента внутри описания и заголовка. Например, если у клиента есть переменная name со значением "Богдан" и в описании страницы сайта вы напишите "Привет #{name}, как твои дела ?", то вывод будет "Привет, Богдан, как твои дела ?". Однако, если такая переменная будет отсутствовать у клиента, то переменная будет взята из общих переменных проекта.

Внимание! Будьте внимательны с использованием ссылок без срока жизни: Если ссылка будет отправлена кому-то еще и этот кто-то пройдет опрос, то результаты будут записаны клиенту, для которого была создана данная ссылка.

PreviousМатематические функции NextДля работы с Salebot-таблицами

Last updated 18 days ago

Was this helpful?