Посилання зі сповіщенням про клік
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?". Однак, якщо клієнт не має цієї змінної, значення буде взято з глобальних змінних проекту.
Примітка! Будьте обережні при використанні посилань без часу закінчення дії. Якщо посилання буде передано іншій особі, і вона пройде вікторину, результати будуть записані для клієнта, для якого спочатку було згенеровано посилання.