การทำงานกับป้ายกำกับ MaviBot

01-12-2025

ในหน้านี้

สร้าง / ลบป้ายกำกับ

ป้ายกำกับ MaviBot จะแสดงในโปรไฟล์ลูกค้าดังนี้:

และในส่วน "รายการ" :

create_label(label_name)
สร้างป้ายกำกับ MaviBot ด้วยชื่อที่ระบุ

พารามิเตอร์:\ ! label_name- ชื่อป้ายกำกับ ระบุในเครื่องหมายคำพูดเดี่ยว ('')

add_label(label_name, client_id)
เพิ่มป้ายกำกับ MaviBot ให้กับลูกค้า

พารามิเตอร์:\ ! label_name - ชื่อป้ายกำกับ ระบุในเครื่องหมายคำพูดเดี่ยว ('')
client_id รหัสลูกค้า หากไม่ระบุ จะใช้รหัสลูกค้าปัจจุบัน

remove_label(label_name, client_id)
ลบป้ายกำกับออกจากลูกค้า

พารามิเตอร์:\ ! label_name - ชื่อป้ายกำกับ ระบุในเครื่องหมายคำพูดเดี่ยว ('')
client_id - รหัสลูกค้า หากไม่ระบุ จะใช้รหัสลูกค้าปัจจุบัน

has_label(label_name, client_id) - ตรวจสอบว่าลูกค้ามีป้ายกำกับหรือไม่

remove_label_everywhere(label_name)
ลบป้ายกำกับออกจากลูกค้าทั้งหมด

พารามิเตอร์:\ ! label_name- ชื่อป้ายกำกับ ระบุในเครื่องหมายคำพูดเดี่ยว ('')

count_of_clients_with_label(label_name)
รับจำนวนลูกค้าทั้งหมดที่มีป้ายกำกับ

พารามิเตอร์:\ ! label_name- ชื่อป้ายกำกับ ระบุในเครื่องหมายคำพูดเดี่ยว ('')

มาดูกันว่า ป้ายกำกับ MaviBot ถูกสร้างขึ้นอย่างไร

คุณเพียงแค่ต้องเรียกใช้ฟังก์ชันการสร้างหนึ่งครั้งในบล็อกสีเทา (บล็อกที่ไม่มีสถานะ) เช่น:

ในเวลาเดียวกัน ตัวแปร a สามารถใช้เพื่อวิเคราะห์ความสำเร็จของฟังก์ชันการสร้างป้ายกำกับ:

จากนั้น คุณสามารถ กำหนดป้ายกำกับให้กับลูกค้าใดก็ได้ โดยเพิ่มฟังก์ชัน add_label() ในบล็อกที่เหมาะสมของ funnel ของคุณ:

คุณสามารถตรวจสอบว่าลูกค้ามีป้ายกำกับหรือไม่โดยใช้ฟังก์ชัน has_label():

ฟังก์ชันจะส่งคืนค่าตรรกะ: จริง หรือ เท็จ

การดำเนินการอื่นๆ ที่เกี่ยวข้องกับป้ายกำกับจะดำเนินการในลักษณะเดียวกัน—การลบป้ายกำกับออกจากลูกค้าเฉพาะราย หรือการลบป้ายกำกับออกจากลูกค้าทั้งหมด

คุณยังสามารถนับจำนวนลูกค้าที่มีป้ายกำกับที่กำหนดได้โดยใช้ฟังก์ชัน count_of_clients_with_label()

/สร้างป้ายกำกับ/ a=create_label('tag1')

/กำหนดป้ายกำกับให้ลูกค้า/ a=add_label('stage 1')

/ตรวจสอบว่าลูกค้ามีป้ายกำกับ/ a=has_label('step 1','73704021')

/นับจำนวนลูกค้าที่มีป้ายกำกับที่กำหนด/ step1=count_of_clients_with_label('stage 1') tovar1=count_of_clients_with_label('1')

การสร้างป้ายกำกับ

create_label(label_name) - สร้างป้ายกำกับ MaviBot ด้วยชื่อที่ระบุ

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

! label_name- ชื่อป้ายกำกับ ระบุในเครื่องหมายคำพูดเดี่ยว ('')

การสร้างป้ายกำกับโดยไม่ซ้ำ

create_label_if_not_exist(name, color) - สร้างป้ายกำกับใหม่หากยังไม่มีป้ายกำกับที่มีชื่อเดียวกัน และส่งคืนตัวระบุของป้ายกำกับนั้น มิฉะนั้นจะส่งคืนตัวระบุของป้ายกำกับที่มีอยู่

name — ชื่อป้ายกำกับ

color — สีของป้ายกำกับ (ค่าเริ่มต้น: 0)

ตารางสีสำหรับพารามิเตอร์ color :

0 — สีเทาอ่อน

1 — สีเหลือง

2 — สีน้ำเงิน

3 — สีแดง

4 — สีชมพู

5 — สีเบจ

6 — สีม่วง

7 — สีฟ้าอ่อน

8 — สีเทา

9 - สีเขียว

รับป้ายกำกับทั้งหมดของลูกค้า

get_all_client_labels(client_id)

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

client_id - ไม่บังคับ; หากไม่ระบุ จะดึงป้ายกำกับของลูกค้าปัจจุบัน

ฟังก์ชันส่งคืนการตอบสนองในรูปแบบ JSON: {"161":"tag1","228":"tag2"} โดยที่: คีย์คือรหัสป้ายกำกับ และค่าคือชื่อป้ายกำกับ

ลบป้ายกำกับลูกค้าตามอาร์เรย์

remove_multiple_client_labels(labels_array, names) - ลบป้ายกำกับที่ระบุในอาร์เรย์

labels_array - อาร์เรย์ของป้ายกำกับ หรือ อาร์เรย์ของ รหัส, หรือ อาร์เรย์ของ ชื่อ

หากส่งอาร์เรย์ชื่อ ดังนั้น**❗จำเป็นต้องส่งพารามิเตอร์ที่สอง (names) โดยตั้งค่าเป็น 1**

names - ตั้งค่าเป็น 1 หากอาร์เรย์มีชื่อป้ายกำกับแทนรหัส ซึ่งบ่งชี้ว่าอาร์เรย์ประกอบด้วยชื่อ

ไม่อนุญาตให้รวมทั้งรหัสป้ายกำกับและชื่อป้ายกำกับในฟังก์ชันเดียวกัน!

/*ลบป้ายกำกับตามรหัส*/

r = remove_multiple_client_labels('[138,169,166]')

/*ลบป้ายกำกับตามชื่อป้ายกำกับ*/

r2 = remove_multiple_client_labels('["newTestTag","tag2"]', 1)

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

ค้นหาลูกค้าตามป้ายกำกับหลายรายการ

find_clients_by_multiple_labels(labels_array, names) - ค้นหาลูกค้าตามป้ายกำกับหลายรายการ

สำคัญ! ฟังก์ชันนี้จะค้นหาเฉพาะลูกค้าที่มีป้ายกำกับที่ระบุทั้งหมดเท่านั้น

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

ไม่อนุญาตให้รวมทั้งรหัสป้ายกำกับและชื่อป้ายกำกับในฟังก์ชันเดียวกัน!

ส่งคืนอาร์เรย์ของรหัสลูกค้า (client_id): [41121, 41192, 41522]

/*ค้นหาลูกค้าที่มีป้ายกำกับที่ระบุทั้งหมดตามรหัส*/

r = find_clients_by_multiple_labels('[138,169,166]')

/*ค้นหาลูกค้าที่มีป้ายกำกับที่ระบุทั้งหมดตามชื่อป้ายกำกับ*/

r2 = find_clients_by_multiple_labels('["newTestTag","tag2"]', 1)

ตรวจสอบอาร์เรย์ของป้ายกำกับลูกค้า

has_client_multiple_labels(labels_array, names) - ตรวจสอบอาร์เรย์ของป้ายกำกับลูกค้า

สำคัญ! ฟังก์ชันจะส่งคืน จริง หากลูกค้ามีป้ายกำกับที่ระบุทั้งหมด!

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

ไม่อนุญาตให้รวมทั้งรหัสป้ายกำกับและชื่อป้ายกำกับในฟังก์ชันเดียวกัน!

ส่งคืน ข้อผิดพลาด หรือ จริง หากลูกค้ามีป้ายกำกับทั้งหมดจากอาร์เรย์ หรือ เท็จ หากลูกค้าไม่มีป้ายกำกับทั้งหมด

/*ตรวจสอบว่าลูกค้ามีป้ายกำกับที่ระบุทั้งหมดตามรหัส*/

r = has_client_multiple_labels('[138,169,166]')

/*ตรวจสอบว่าลูกค้ามีป้ายกำกับที่ระบุทั้งหมดตามชื่อป้ายกำกับ*/

r2 = has_client_multiple_labels('["newTestTag","tag2"]', 1)

รับรหัสป้ายกำกับทั้งหมดของลูกค้า

get_all_client_label_ids(client_id) — ส่งคืนอาร์เรย์ที่มีรหัสของป้ายกำกับทั้งหมดที่กำหนดให้กับลูกค้า

หากลูกค้าไม่มีป้ายกำกับ ฟังก์ชันจะส่งคืนอาร์เรย์ว่าง: []

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

client_id — รหัสลูกค้า Mavibot หากไม่ระบุ จะใช้รหัสของลูกค้าปัจจุบัน