Ссылки с уведомлением о клике
proxy() | proxy_date() | proxy_timeout()
ЛЕГЕНДА:
! - Обязательные параметры
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})
или протестируйте, используя следующий формат вывода:
Пример кода в поле "Калькулятор":
link1=proxy('https://mavibot.ai/', 1)
link2=short_date('https://mavibot.ai/#tariff', '11.06.2025', '2pm')
link3=tg_escape(link2)
Когда клиент нажимает на прокси-ссылку, вы получите обратный вызов в виде 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 страницы сайта. Для этого перейдите в раздел "Сайты" и выберите нужный сайт:
Далее в тексте мы будем называть mini_landing_page_id именем переменной.
2. В поле "Калькулятор" используйте одну из следующих функций:
ЛЕГЕНДА:
! - Обязательные параметры
quiz_link_timeout(mini_landing_page_id, minutes) - генерирует ссылку с ограничением времени жизни, заданным в минутах
Параметры:
! mini_landing_page_id - ID страницы сайта
minutes - время жизни ссылки в минутах (тип: число)
quiz_link_date(mini_landing_page_id, date, time) - генерирует ссылку с истечением, ограниченным конкретной датой и временем
Параметры:
! mini_landing_page_id - ID страницы сайта
date - дата действия ссылки (формат: дд.мм.гггг)
time - время действия ссылки (формат: чч:мм)
quiz_link(mini_landing_page_id) - генерирует ссылку без срока действия
Параметры:
! mini_landing_page_id - ID страницы сайта
3. Создайте кнопку Telegram Web App и укажите имя переменной в фигурных скобках с символом решётки.
Важно!
Убедитесь, что значение переменной правильно сохранено в расширенных настройках.
Если вы используете quiz_link_timeout для перенаправления клиента на страницу сайта, вы можете использовать переменные клиента в заголовке и описании страницы. Например, если у клиента есть переменная name со значением "John", а в описании страницы указано "Hi #{name}, how are you?", на выходе будет "Hi John, how are you?". Однако, если у клиента нет такой переменной, значение будет взято из глобальных переменных проекта.
Примечание! Будьте осторожны при использовании ссылок без срока действия. Если ссылка будет передана другому лицу и он пройдёт квиз, результаты будут записаны для клиента, для которого изначально была создана ссылка.