การใช้งานบอท

วิธีทำงานกับคำอธิบายบอท Telegram (แบบเต็มและแบบสั้น)

การกำหนดค่าข้อความต้อนรับ

tg_set_bot_description(description, language_code) - คำอธิบายบอทที่แสดงเมื่อแชทกับบอทยังว่างเปล่า

พารามิเตอร์:

ตัวอย่างการกำหนดค่าข้อความต้อนรับและเมนูบอท:

หลังจากเปิดใช้งาน (ควรทำเพียงครั้งเดียวโดยใช้คำสั่งผู้ดูแลระบบ):

ตัวอย่างโค้ดสำหรับคัดลอก:

tg_set_bot_description('ยินดีต้อนรับ! ฉันคือผู้ช่วยเสมือนของคุณ Yurgram.🤖') command = [["private_office", "บัญชีส่วนตัว"]] tg_set_command(command, '', 'default')

การกำหนดค่าคำอธิบายตัวอย่างแบบสั้น

tg_set_bot_short_description(description, language_code) - คำอธิบายสั้นของบอทที่ปรากฏบนหน้าโปรไฟล์ของบอทและถูกส่งไปพร้อมกับลิงก์เมื่อผู้ใช้แชร์บอท

พารามิเตอร์:

การรับคำอธิบายปัจจุบัน

tg_get_bot_description(language_code) - ใช้วิธีนี้เพื่อรับคำอธิบายบอทปัจจุบันสำหรับภาษาผู้ใช้ที่ระบุ

การรับคำอธิบายสั้นปัจจุบัน

tg_get_bot_short_description(language_code) - ใช้วิธีนี้เพื่อรับคำอธิบายสั้นปัจจุบันของบอทสำหรับภาษาผู้ใช้ที่ระบุ

วิธีกำหนดค่าคำสั่งสำหรับบอท

การกำหนดค่าคำสั่ง

tg_set_command(commands, language, scope, platform_id, user_id)

command = [["count", "return count of user"],["unpin", "unpin all message"]] tg_set_command(command, '', 'all_chat_administrators')

ในตัวอย่างนี้ คำสั่งถูกวางไว้ในตัวแปรแยกต่างหาก คุณยังสามารถเพิ่มคำสั่งเหล่านี้ลงในฟังก์ชันได้โดยตรง

tg_set_command('[["count", "return count of user"],["unpin", "unpin all message"]]', '', 'all_chat_administrators')

หากต้องการเรียกใช้คำสั่ง ให้พิมพ์สัญลักษณ์ '/' ในช่องป้อนข้อความ หากกำหนดค่าถูกต้อง คุณจะเห็นรายการคำแนะนำของคำสั่งที่มีอยู่ คำสั่งจะปรากฏเป็นตัวหนา โดยมีคำอธิบายแสดงทางด้านขวา

หากต้องการใช้คำสั่ง ให้กำหนดค่าการตอบสนองต่อข้อความที่มีคำสั่ง

วิธีดูคำสั่งสำหรับบอท

tg_get_command()

เพื่อดูคำสั่ง

tg_get_command(language, scope, platform_id, user_id)

หากคุณไม่ต้องการใช้พารามิเตอร์ภาษาแต่จำเป็นต้องใช้พารามิเตอร์ scope อย่าลืมระบุพารามิเตอร์ว่างก่อน ดังตัวอย่าง:

tg_get_command('', scope)

command = tg_get_command('', 'all_chat_administrators')

กำหนดฟังก์ชันนี้ให้กับตัวแปร และตัวแปรจะมีการตอบสนองจากเซิร์ฟเวอร์พร้อมคำสั่งสำหรับขอบเขตผู้ใช้ที่ระบุในพารามิเตอร์

{"ok":true,"result":[{"command":"count","description":"return count of user"},{"command":"unpin","description":"unpin all message"}]}

หากเรียกใช้ฟังก์ชันโดยไม่มีพารามิเตอร์ ขอบเขตจะถูกตั้งเป็น 'default'

command = tg_get_command()

วิธีลบคำสั่งในบอท

tg_delete_command()

เพื่อลบคำสั่ง

tg_delete_command(language, scope, platform_id, user_id), โดยที่

หากคุณไม่ต้องการใช้พารามิเตอร์ภาษาแต่จำเป็นต้องใช้พารามิเตอร์ scope อย่าลืมระบุค่าว่างสำหรับพารามิเตอร์แรก ดังตัวอย่าง:

tg_delete_command('', scope)

คำสั่งเช่น tg_delete_command() จะลบคำสั่งโดยไม่ระบุพารามิเตอร์ภาษา โดยใช้ค่าเริ่มต้นของขอบเขต

คุณสามารถลบคำสั่งที่ตั้งไว้โดยเรียกใช้ฟังก์ชันพร้อมพารามิเตอร์ในเครื่องคิดเลข:

ตัวอย่างโค้ดสำหรับคัดลอก:

tg_delete_command('', 'all_chat_administrators')

วิธีกำหนดค่าการตอบสนองต่อคำสั่ง

สำหรับคำสั่งในแชทส่วนตัวกับบอท คุณต้องตอบสนองต่อข้อความเช่น: '/command_name' – โดยที่ command_name คือคำสั่ง

สำหรับคำสั่งในกลุ่มและแชท ข้อความจะปรากฏเป็น: '/command_name@bot_username' – โดยที่ command_name คือคำสั่งและ @bot_username คือชื่อผู้ใช้ของบอท

รายการค่าขอบเขต:

หากคุณไม่ต้องการใช้พารามิเตอร์ภาษาแต่จำเป็นต้องใช้พารามิเตอร์ scope อย่าลืมระบุค่าว่างสำหรับพารามิเตอร์แรก ดังตัวอย่าง:

tg_delete_command('', scope)