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

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

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

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

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

พารามิเตอร์	คำอธิบาย
description	การส่งสตริงว่างเป็นคำอธิบายบอทจะลบคำอธิบายที่มีอยู่
language_code	รหัสภาษาสองตัวอักษรตามมาตรฐาน ISO 639-1 สำหรับการแปลข้อความ หากปล่อยว่างไว้ คำอธิบายสั้นจะถูกนำไปใช้กับผู้ใช้ทุกคนที่ไม่ได้ตั้งค่าคำอธิบายสั้นเฉพาะ

ตัวอย่าง

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

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

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

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

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

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

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

พารามิเตอร์	คำอธิบาย
description	การส่งสตริงว่างเป็นคำอธิบายบอทจะลบคำอธิบายที่มีอยู่
language_code	รหัสภาษาสองตัวอักษรตามมาตรฐาน ISO 639-1 สำหรับการแปลข้อความ หากปล่อยว่างไว้ คำอธิบายสั้นจะถูกนำไปใช้กับผู้ใช้ทุกคนที่ไม่ได้ตั้งค่าคำอธิบายสั้นเฉพาะ

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

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

พารามิเตอร์	คำอธิบาย
language_code	รหัสภาษาสองตัวอักษรตามมาตรฐาน ISO 639-1 สำหรับการแปลข้อความ หากปล่อยว่างไว้ คำอธิบายสั้นจะถูกนำไปใช้กับผู้ใช้ทุกคนที่ไม่ได้ตั้งค่าคำอธิบายสั้นเฉพาะ

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

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

พารามิเตอร์	คำอธิบาย
language_code	รหัสภาษาสองตัวอักษรตามมาตรฐาน ISO 639-1 สำหรับการแปลข้อความ หากปล่อยว่างไว้ คำอธิบายสั้นจะถูกนำไปใช้กับผู้ใช้ทุกคนที่ไม่ได้ตั้งค่าคำอธิบายสั้นเฉพาะ

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

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

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

พารามิเตอร์	คำอธิบาย
**!** commands	คำสั่งบอทในรูปแบบของรายการของรายการ แต่ละรายการย่อยประกอบด้วย 2 องค์ประกอบ: 1 – ชื่อคำสั่ง, 2 – คำอธิบาย (มีขีดจำกัด 100 คำสั่ง)
language	รหัสภาษาสองตัวอักษรตาม ISO 639-1 เช่น 'ru' หรือ 'en' หากไม่ระบุ คำสั่งจะใช้กับผู้ใช้ทุกคนที่ภาษาไม่มีคำสั่งที่กำหนดไว้เฉพาะ
scope	พารามิเตอร์ที่กำหนดขอบเขตของผู้ใช้ที่สร้างคำสั่งให้ ค่าเริ่มต้นคือ 'default'
platform_id	ตัวระบุแชทภายใน Telegram * ใช้เฉพาะกับค่าที่ระบุของพารามิเตอร์ scope
user_id	ตัวระบุผู้ใช้ภายใน Telegram * ใช้เฉพาะกับค่าที่ระบุของพารามิเตอร์ scope

ตัวอย่าง

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)

พารามิเตอร์	คำอธิบาย
language	รหัสภาษาสองตัวอักษรตาม ISO 639-1 เช่น 'ru' หรือ 'en' หากไม่ระบุ จะแสดงคำสั่งที่ใช้กับผู้ใช้ทั้งหมดในพื้นที่ที่กำหนดซึ่งไม่มีคำสั่งเฉพาะสำหรับภาษาของตน
scope	พารามิเตอร์ที่กำหนดขอบเขตของผู้ใช้ที่ควรแสดงคำสั่ง (พารามิเตอร์เสริม หากไม่ใช้ ค่าเริ่มต้น 'default' จะถูกนำไปใช้)
platform_id	ตัวระบุแชทภายใน Telegram * ใช้เฉพาะกับค่าที่ระบุของพารามิเตอร์ scope
user_id	ตัวระบุผู้ใช้ภายใน Telegram * ใช้เฉพาะกับค่าที่ระบุของพารามิเตอร์ scope

หากคุณไม่ต้องการใช้พารามิเตอร์ภาษาแต่จำเป็นต้องใช้พารามิเตอร์ 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), โดยที่

พารามิเตอร์	คำอธิบาย
language	รหัสภาษาสองตัวอักษรตาม ISO 639-1 เช่น 'ru' หรือ 'en' (พารามิเตอร์เสริม หากไม่ระบุ คำสั่งที่ใช้กับผู้ใช้ทั้งหมดในขอบเขตที่กำหนดซึ่งไม่มีคำสั่งเฉพาะสำหรับภาษาของตนจะถูกลบ)
scope	พารามิเตอร์ที่กำหนดขอบเขตของผู้ใช้ที่คำสั่งจะถูกลบ หากไม่ระบุ ค่าเริ่มต้น 'default' จะถูกนำไปใช้
platform_id	ตัวระบุแชท (พารามิเตอร์เสริม ใช้เฉพาะกับค่าที่ระบุของพารามิเตอร์ scope)
user_id	ตัวระบุผู้ใช้ (พารามิเตอร์เสริม ใช้เฉพาะกับค่าที่ระบุของพารามิเตอร์ scope)

หากคุณไม่ต้องการใช้พารามิเตอร์ภาษาแต่จำเป็นต้องใช้พารามิเตอร์ 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 คือชื่อผู้ใช้ของบอท

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

พารามิเตอร์	ค่า
'default'	พารามิเตอร์เริ่มต้นหมายถึงคำสั่งจะทำงานในข้อความส่วนตัวกับบอท
'all_private_chats'	แชทส่วนตัวทั้งหมด: คำสั่งพร้อมใช้งานสำหรับทุกคนในแชทส่วนตัวที่บอทถูกเพิ่ม
'all_group_chats'	แชทกลุ่มและซูเปอร์กรุ๊ปทั้งหมด: คำสั่งพร้อมใช้งานสำหรับทุกคนในแชทประเภทนี้ที่บอทถูกเพิ่ม
'all_chat_administrators'	คำสั่งสำหรับผู้ดูแลระบบของแชทกลุ่มและซูเปอร์กรุ๊ปทั้งหมดที่บอทถูกเพิ่ม
'chat'	คำสั่งสำหรับแชทเฉพาะ (หากคุณเลือกตัวเลือกนี้ คุณควรระบุ platform_id)
'chat_administrators'	คำสั่งสำหรับผู้ดูแลระบบของแชทเฉพาะ (หากคุณเลือกตัวเลือกนี้ คุณควรระบุ platform_id)
'chat_member'	คำสั่งสำหรับสมาชิกเฉพาะของแชทใดแชทหนึ่ง (หากคุณเลือกตัวเลือกนี้ คุณควรระบุทั้ง platform_id และ user_id; ผู้ใช้ที่ระบุต้องเป็นสมาชิกของแชทนั้น)

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

tg_delete_command('', scope)