العمل مع تسميات 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() في الكتلة المناسبة من مسار التحويل الخاص بك:

يمكنك التحقق مما إذا كان العميل لديه تسمية باستخدام دالة has_label():

ترجع الدالة قيمة منطقية: True أو False.

يتم تنفيذ الإجراءات الأخرى المتعلقة بالتسميات بشكل مشابه—إزالة تسمية من عميل معين أو إزالة التسمية بالكامل من جميع العملاء.

يمكنك أيضًا حساب عدد العملاء الذين لديهم تسمية معينة باستخدام دالة 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) - يجد العملاء بواسطة تسميات متعددة

مهم! هذا يجد فقط العملاء الذين لديهم جميع التسميات المحددة.

المعلمات:

labels_array - مصفوفة التسميات. أو مصفوفة المعرفات، أو مصفوفة الأسماء.

إذا تم تمرير مصفوفة الأسماء، فمن**❗الضروري تمرير المعامل الثاني (names) مضبوطًا على 1.**

غير مسموح بدمج كل من معرفات التسميات وأسماء التسميات في نفس الدالة!

ترجع مصفوفة من معرفات العملاء (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) - يتحقق من مصفوفة تسميات العميل

مهم! ترجع True إذا كان العميل لديه جميع التسميات المحددة!

المعلمات:

labels_array - مصفوفة التسميات. أو مصفوفة المعرفات، أو مصفوفة الأسماء.

إذا تم تمرير مصفوفة الأسماء، فمن**❗الضروري تمرير المعامل الثاني (names) مضبوطًا على 1.**

غير مسموح بدمج كل من معرفات التسميات وأسماء التسميات في نفس الدالة!

ترجع إما خطأ، أو True إذا كان العميل لديه جميع التسميات من المصفوفة، أو False إذا لم يكن العميل لديه جميع التسميات.

/*التحقق مما إذا كان العميل لديه جميع التسميات المحددة بواسطة المعرف*/

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. إذا تم حذفه، يتم استخدام معرف العميل الحالي.