Pautan dengan pemberitahuan klik
proxy() | proxy_date() | proxy_timeout()
LEGENDA:
! - Parameter wajib
proxy(lnk, one-shot) - menjana pautan dengan pemberitahuan klik. Fungsi ini mengambil parameter berikut:\ ! link - pautan
one-shot - penunjuk bahawa pautan hanya digunakan sekali. Hanya hantar nilai 1.
proxy_date(lnk, date, time) - menjana pautan dengan pemberitahuan klik dan masa tamat yang ditentukan. Fungsi ini mengambil parameter berikut:\ ! link - pautan\ ! date - tarikh tamat pautan \ ! time - masa tamat pautan
one-shot - penunjuk bahawa pautan hanya digunakan sekali. Hanya hantar 1.
proxy_timeout(lnk, minutes, one-shot) - menjana pautan dengan pemberitahuan klik dan pemasa akses yang ditentukan. Fungsi ini mengambil parameter berikut:\ ! link - pautan\ ! minutes - bilangan minit pautan kekal aktif.
one-shot - penunjuk bahawa pautan hanya digunakan sekali. Hanya hantar 1.
Mari kita lihat contoh mudah:
Kami telah mencipta dua pautan proksi dan memasukkannya ke dalam butang dan teks mesej. Memandangkan kami menguji di Telegram, ini adalah peluang yang baik untuk mengingati cara memformat pautan dengan betul menggunakan Markdown. Untuk mengendalikan aksara khas, kami telah menggunakan fungsi tg_escape().
Ini adalah cara pelanggan melihatnya, contohnya, di Telegram:
Apabila pelanggan mengklik pautan, kami menerima panggilan balik:
Mari konfigurasikan respons kepada peristiwa ini:
Sekarang, mari uji fungsi pengalihan pautan:
Oleh itu, jika pelanggan cuba menggunakan pautan sekali guna selepas ia dipadamkan, mereka akan menerima ralat kerana pautan itu sudah tidak wujud.
Mari padamkan pautan terhad masa:
Selepas melaksanakan fungsi, tiada pautan proksi yang tinggal dalam kad pelanggan, dan sebarang percubaan untuk mengikuti pautan akan mengembalikan ralat yang sama.
Contoh kod untuk medan "Mesej" (jangan lupa untuk mengaktifkan Markdown jika anda bekerja dengan Telegram):
*Menguji pautan:*
[Klik](#{link3})
atau uji menggunakan format output berikut:
Contoh kod dalam medan "Kalkulator":
link1=proxy('https://mavibot.ai/', 1)
link2=short_date('https://mavibot.ai/#tariff', '11.06.2025', '2pm')
link3=tg_escape(link2)
Apabila pelanggan mengklik pautan proksi, anda akan menerima panggilan balik dalam bentuk link_was_pressed. Ini membolehkan anda mengkonfigurasi reaksi terhadap klik pautan.
Untuk melakukan ini, masukkan panggilan balik yang diterima ke dalam medan "Keadaan" dan tetapkan jenis padanan kepada Padanan Tepat.
Pemendekan pautan
short() | short_date() | short_timeout()
LEGENDA:
! - Parameter wajib
short(lnk, one-shot) - menjana pautan tanpa pemberitahuan klik. Fungsi ini mengambil parameter berikut:\ ! link - pautan
one-shot - penunjuk bahawa pautan hanya digunakan sekali. Hanya hantar nilai 1.
short_date(lnk, date, time) - menjana pautan tanpa pemberitahuan klik dan masa tamat yang ditentukan. Fungsi ini mengambil parameter berikut:\ ! link - pautan\ ! date - tarikh tamat pautan \ ! time - masa tamat pautan
one-shot - penunjuk bahawa pautan hanya digunakan sekali. Hanya hantar 1.
short_timeout(lnk, minutes, one-shot) - menjana pautan tanpa pemberitahuan klik dan pemasa akses yang ditentukan. Fungsi ini mengambil parameter berikut:\ ! link - pautan\ ! minutes - bilangan minit pautan kekal aktif.
one-shot - penunjuk bahawa pautan hanya digunakan sekali. Hanya hantar 1.
Pengalihan pautan
remove_links() | remove_one_time_links()| remove_timer_links()
LEGENDA:
! - Parameter wajib
remove_links() - penyahaktifan semua pautan yang dipendekkan yang dihantar kepada pelanggan
remove_one_time_links() - penyahaktifan semua pautan sekali guna yang dihantar kepada pelanggan
remove_timer_links() - penyahaktifan semua pautan terhad masa yang dihantar kepada pelanggan
Pautan kuiz bot Telegram
quiz_link_timeout() | quiz_link_date() | quiz_link()
Sila ambil perhatian!
Terdapat had 21 hari pada kesahihan pautan, jadi ia mesti disegarkan semula!
Untuk membolehkan paparan kuiz di Telegram, anda perlu:
1. Salin ID halaman laman web. Untuk melakukan ini, pergi ke bahagian "Laman Web" dan pilih laman web yang dikehendaki:
Seterusnya dalam teks, kami akan merujuk kepada mini_landing_page_id sebagai nama pembolehubah.
2. Dalam medan "Kalkulator", gunakan salah satu fungsi berikut:
LEGENDA:
! - Parameter wajib
quiz_link_timeout(mini_landing_page_id, minutes) - menjana pautan dengan had hayat yang ditetapkan dalam minit
Parameter:
! mini_landing_page_id - ID halaman laman web
minutes - hayat pautan dalam minit (jenis: nombor)
quiz_link_date(mini_landing_page_id, date, time) - menjana pautan dengan tamat tempoh yang terhad kepada tarikh dan masa tertentu
Parameter:
! mini_landing_page_id - ID halaman laman web
date - tarikh aktif pautan (format: dd.mm.yyyy)
time - masa aktif pautan (format: hh:mm)
quiz_link(mini_landing_page_id) - menjana pautan tanpa masa tamat
Parameter:
! mini_landing_page_id - ID halaman laman web
3. Cipta butang Telegram Web App dan nyatakan nama pembolehubah dalam kurungan kerinting dengan simbol hash.
Penting!
Pastikan nilai pembolehubah disimpan dengan betul dalam tetapan lanjutan.
Jika anda menggunakan quiz_link_timeout untuk mengarahkan pelanggan ke halaman laman web, anda boleh menggunakan pembolehubah pelanggan dalam tajuk dan perihalan halaman. Contohnya, jika pelanggan mempunyai pembolehubah name dengan nilai "John", dan perihalan halaman termasuk "Hi #{name}, how are you?", output akan menjadi "Hi John, how are you?". Walau bagaimanapun, jika pelanggan tidak mempunyai pembolehubah itu, nilai akan diambil daripada pembolehubah global projek.
Nota! Berhati-hati apabila menggunakan pautan tanpa masa tamat. Jika pautan dikongsi dengan orang lain dan mereka melengkapkan kuiz, keputusan akan direkodkan di bawah pelanggan yang pautan itu pada asalnya dijana.