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 - белгілер массиві. НЕМЕСЕ ID массиві****,**** НЕМЕСЕ атаулар массиві.

Егер атаулар массиві берілсе, онда**❗екінші параметрді (names) 1 мәніне орнату міндетті.**

names - Егер массивте идентификаторлардың орнына белгі атаулары болса, 1 мәніне орнатыңыз. Бұл массивтің атаулардан тұратынын көрсетеді.

Бір функцияда белгі идентификаторлары мен белгі атауларын біріктіруге РҰҚСАТ ЕТІЛМЕЙДІ!

/*Белгілерді ID бойынша жою*/

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 - белгілер массиві. НЕМЕСЕ ID массиві****,**** НЕМЕСЕ атаулар массиві.

Егер атаулар массиві берілсе, онда**❗екінші параметрді (names) 1 мәніне орнату міндетті.**

Бір функцияда белгі идентификаторлары мен белгі атауларын біріктіруге РҰҚСАТ ЕТІЛМЕЙДІ!

Клиент идентификаторларының (client_id) массивін қайтарады: [41121, 41192, 41522]

/*Барлық көрсетілген белгілері бар клиенттерді ID бойынша табу*/

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 - белгілер массиві. НЕМЕСЕ ID массиві****,**** НЕМЕСЕ атаулар массиві.

Егер атаулар массиві берілсе, онда**❗екінші параметрді (names) 1 мәніне орнату міндетті.**

Бір функцияда белгі идентификаторлары мен белгі атауларын біріктіруге РҰҚСАТ ЕТІЛМЕЙДІ!

Қатені, немесе егер клиентте массивтегі барлық белгілер болса True, немесе клиентте барлық белгілер болмаса False мәнін қайтарады.

/*Клиентте барлық көрсетілген белгілердің бар-жоғын ID бойынша тексеру*/

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 клиентінің идентификаторы. Егер көрсетілмесе, ағымдағы клиенттің идентификаторы қолданылады.