การทำงานกับลิงก์

ลิงก์พร้อมการแจ้งเตือนการคลิก

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 bot

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 - วันที่ลิงก์ทำงาน (รูปแบบ: dd.mm.yyyy)
time - เวลาที่ลิงก์ทำงาน (รูปแบบ: hh:mm)

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?" อย่างไรก็ตาม หากลูกค้าไม่มีตัวแปรนั้น ค่าจะถูกดึงมาจากตัวแปรทั่วโลกของโปรเจกต์

หมายเหตุ! ระวังเมื่อใช้ลิงก์โดยไม่มีเวลาหมดอายุ หากลิงก์ถูกแชร์กับผู้อื่นและพวกเขาทำแบบทดสอบเสร็จ ผลลัพธ์จะถูกบันทึกภายใต้ลูกค้าที่สร้างลิงก์ไว้เดิม