การทำงานกับรายการ

30-11-2025

ในหน้านี้

สร้างรายการใหม่

create_list()

คำอธิบาย

ป้อนฟังก์ชันในช่อง "เครื่องคิดเลข" ในการตั้งค่าบล็อก:

create_list(name) - สร้างรายการใหม่ ผลลัพธ์คือ ID ของรายการ

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

! name - ชื่อรายการ ระบุชื่อในเครื่องหมายคำพูดเดี่ยว

ตัวอย่าง

list_id = create_list("registered")

การสร้างรายการจากบล็อกโดยไม่มีรายการซ้ำ

create_list_if_not_exist()

คำอธิบาย

create_list_if_not_exist('list_name') - สร้างรายการใหม่หากยังไม่มีรายการที่มีชื่อที่กำหนด และส่งคืนตัวระบุของรายการนั้น หรือส่งคืนตัวระบุของรายการที่มีอยู่

พารามิเตอร์ที่จำเป็น:

list_name - ชื่อสำหรับรายการใหม่ที่จะสร้าง

ตัวอย่าง

new_list = create_list_if_not_exist('List of participants')

การเพิ่มลูกค้าไปยังรายการ

add_to_list()

คำอธิบาย

add_to_list(list_id, client_id) - เพิ่มลูกค้าไปยังรายการ ฟังก์ชันไม่ส่งคืนค่าใดๆ

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

! list_id - ID ของรายการ

client_id - ID ลูกค้า MaviBot หากไม่ได้ระบุ จะใช้ ID ของลูกค้าปัจจุบัน

การย้ายลูกค้าไปยังรายการ

move_to_list()

คำอธิบาย

move_to_list(list_id, client_id) - ย้ายลูกค้าไปยังรายการ (สำคัญ! ลูกค้าจะถูกลบออกจากรายการอื่นทั้งหมดและย้ายไปยังรายการที่ระบุ) ผลลัพธ์เป็นค่าบูลีน (True หรือ False)

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

! list_id - ID ของรายการ

client_id - ID ลูกค้า MaviBot หากไม่ได้ระบุ จะใช้ ID ของลูกค้าปัจจุบัน

การลบลูกค้าออกจากรายการ

remove_from_list()

คำอธิบาย

remove_from_list(list_id, client_id) - ลบลูกค้าที่มี client_id ที่ระบุออกจากรายการ

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

! list_id - ID ของรายการ

client_id - ID ลูกค้า MaviBot หากไม่ได้ระบุ จะใช้ ID ของลูกค้าปัจจุบัน

การลบรายการ

remove_list_from_project(list_id, clear_list)

คำอธิบาย
! list_id - พารามิเตอร์ที่จำเป็น; ID ของรายการที่จะลบ

clear_list — พารามิเตอร์เสริม; รับค่าสองค่า: True หรือ False (ค่าเริ่มต้นคือ False)

หากคุณไม่ได้ระบุพารามิเตอร์นี้และรายการมีลูกค้าอยู่ คุณจะได้รับการตอบกลับดังนี้:
"Can't delete list, list not empty"

หากรายการว่างเปล่า รายการจะถูกลบโดยไม่มีปัญหา อย่างไรก็ตาม หากคุณตั้งค่า clear_list เป็น True รายการจะถูกลบไม่ว่าจะมีลูกค้าอยู่หรือไม่ก็ตาม

การลบแท็ก

remove_label_from_project(list_id, clear_list)

คำอธิบาย
! list_id - พารามิเตอร์ที่จำเป็น; ID ของแท็กที่จะลบ

clear_list - พารามิเตอร์เสริม; รับค่าสองค่า: True หรือ False (ค่าเริ่มต้นคือ False)

หากไม่ได้ระบุพารามิเตอร์นี้และแท็กถูกกำหนดให้กับลูกค้า คุณจะได้รับการตอบกลับดังนี้:
"Can't delete list, list not empty"

หากแท็กไม่ได้ถูกกำหนดให้กับลูกค้าใดๆ แท็กจะถูกลบโดยไม่มีปัญหา อย่างไรก็ตาม หากตั้งค่า clear_list เป็น True แท็กจะถูกลบไม่ว่าจะถูกกำหนดให้กับลูกค้าหรือไม่ก็ตาม

การล้างรายการลูกค้า

clear_list()

คำอธิบาย

clear_list(list_id) - ล้างรายการลูกค้า

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

! list_id - ID ของรายการ หลังจากใช้งาน ลูกค้าทั้งหมดจะถูกลบออกจากรายการที่ระบุ

การรับจำนวนลูกค้าในรายการ

list_size()

คำอธิบาย

list_size(list_id) – นับจำนวนลูกค้าทั้งหมดในรายการ

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

! list_id- ID ของรายการ

การนับจำนวนรายการลูกค้าที่ไม่ซ้ำกันในหลายรายการ

lists_joint_count()

คำอธิบาย

lists_joint_count(massive_list) – นับจำนวนรายการลูกค้าที่ไม่ซ้ำกันทั้งหมดในหลายรายการ ฟังก์ชันรับอาร์เรย์ของ ID รายการเป็นอินพุตและส่งคืนตัวเลข

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

! massive_list - อาร์เรย์ที่ประกอบด้วย ID ของรายการที่จะนับรายการลูกค้าที่ไม่ซ้ำกัน รูปแบบคือ: ['list_id1', 'list_id2', ..., 'list_idN']

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

/*Creating a list*/
list_id = create_list('New list')

/*Check if the client is in the list*/
k=inlist(list_id, client_id)

/*Get the size of the list — total number of clients in the list*/
razm=list_size(1)

/*Get the total number of unique client entries across multiple lists*/
k=lists_joint_count('[144636,144634]')

การตรวจสอบว่าลูกค้าอยู่ในรายการหรือไม่

inlist()

คำอธิบาย

inlist(list_id,client_id) - ตรวจสอบว่าลูกค้าอยู่ในรายการหรือไม่ ผลลัพธ์เป็นค่าบูลีน (True หรือ False)

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

! list_id - ID ของรายการ

client_id - ID ลูกค้า MaviBot หากไม่ได้ระบุ จะใช้ ID ของลูกค้าปัจจุบัน

การตรวจสอบว่าผู้เข้าร่วมแชทอยู่ในรายการที่ระบุหรือไม่

some_client_in_list()

คำอธิบาย

some_client_in_list(list_id, recepient)

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

! list_id - ID ของรายการ;

! recepient - ID ผู้ใช้ของแอปส่งข้อความที่กำลังตรวจสอบ (platform_id) สำหรับแชท ค่าของตัวแปรคือ chat_member_id

ส่งคืนค่า:

True - ลูกค้าอยู่ในรายการ;

False - ลูกค้าไม่อยู่ในรายการที่ระบุ

ตัวอย่าง

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

/*Example of checking if a chat participant is in the list, where the first parameter is the list ID, and the second is the user's chat ID*/

r = some_client_in_list(123456, chat_member_id)