Cipta / buang label

create_label() | add_label() | remove_label() | remove_label_everywhere() | count_of_clients_with_label() | has_label()

Label MaviBot dipaparkan dalam profil pelanggan sebagai:

dan dalam bahagian "Senarai":

create_label(label_name)
mencipta tag MaviBot dengan nama yang ditentukan

Parameter:\ ! label_name- nama tag, dinyatakan dalam tanda petik tunggal ('').

add_label(label_name, client_id)
menambah tag MaviBot kepada pelanggan

Parameter:\ ! label_name - nama tag, dinyatakan dalam tanda petik tunggal ('')
client_id ID pelanggan. Jika ditinggalkan, ID pelanggan semasa digunakan

remove_label(label_name, client_id)
buang tag daripada pelanggan

Parameter:\ ! label_name - nama tag, dinyatakan dalam tanda petik tunggal ('')
client_id -ID pelanggan. Jika ditinggalkan, ID pelanggan semasa digunakan

has_label(label_name, client_id) - semak sama ada pelanggan mempunyai tag

Parameter:\ ! label_name - nama tag, dinyatakan dalam tanda petik tunggal ('')
client_id - ID pelanggan. Jika ditinggalkan, ID pelanggan semasa digunakan

remove_label_everywhere(label_name)
buang tag daripada semua pelanggan

Parameter:\ ! label_name- nama tag, dinyatakan dalam tanda petik tunggal ('')

count_of_clients_with_label(label_name)
dapatkan jumlah bilangan pelanggan dengan tag

Parameter:\ ! label_name- nama tag, dinyatakan dalam tanda petik tunggal ('')

Jadi, mari lihat bagaimana tag MaviBot dicipta.

Anda hanya perlu melaksanakan fungsi penciptaan sekali dalam blok kelabu (blok bukan keadaan), contohnya:

Pada masa yang sama, pembolehubah a boleh digunakan untuk menganalisis kejayaan fungsi penciptaan label:

Seterusnya, anda boleh menetapkan label kepada mana-mana pelanggan dengan menambah fungsi add_label() dalam blok yang sesuai dalam corong anda:

Anda boleh menyemak sama ada pelanggan mempunyai label menggunakan fungsi has_label():

Fungsi mengembalikan nilai logik: True atau False.

Tindakan lain yang berkaitan dengan label dilakukan dengan cara yang sama—membuang label daripada pelanggan tertentu atau membuang tag sepenuhnya daripada semua pelanggan.

Anda juga boleh mengira bilangan pelanggan dengan label tertentu menggunakan fungsi count_of_clients_with_label().

/Cipta tag/ a=create_label('tag1')

/Tetapkan tag kepada pelanggan/ a=add_label('stage 1')

/Semak sama ada pelanggan mempunyai tag/ a=has_label('step 1','73704021')

/Kira bilangan pelanggan dengan label tertentu/ step1=count_of_clients_with_label('stage 1') tovar1=count_of_clients_with_label('1')

Mencipta label

create_label(label_name) - mencipta tag MaviBot dengan nama yang ditentukan

Parameter:

! label_name- nama tag, dinyatakan dalam tanda petik tunggal ('')

Mencipta label tanpa pendua

create_label_if_not_exist(name, color) - mencipta label baharu jika label dengan nama yang sama belum wujud dan mengembalikan pengecamnya; jika tidak, mengembalikan pengecam tag sedia ada

name — nama label

color — warna label (lalai: 0)

Jadual warna untuk parameter color:

0 — kelabu muda

1 — kuning

2 — biru

3 — merah

4 — merah jambu

5 — kuning air

6 — ungu

7 — biru muda

8 — kelabu

9 - hijau

Dapatkan semua label pelanggan

get_all_client_labels(client_id)

Parameter:

client_id - pilihan; jika tidak disediakan, tag pelanggan semasa akan diambil.

Fungsi mengembalikan respons dalam format JSON: {"161":"tag1","228":"tag2"}, di mana: kunci ialah ID label, dan nilai ialah nama label

Padam label pelanggan mengikut tatasusunan

remove_multiple_client_labels(labels_array, names) - memadam tag yang dinyatakan dalam tatasusunan

labels_array - tatasusunan tag. ATAU tatasusunan ID,**** ATAU tatasusunan nama.

Jika tatasusunan nama dihantar, maka**❗wajib untuk menghantar parameter kedua (names) ditetapkan kepada 1.**

names - Tetapkan kepada 1, jika tatasusunan mengandungi nama tag dan bukannya ID. Ini menunjukkan bahawa tatasusunan terdiri daripada nama.

Ia TIDAK dibenarkan untuk menggabungkan kedua-dua ID tag dan nama tag dalam fungsi yang sama!

/*Padam tag mengikut ID*/

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

/*Padam tag mengikut nama tag*/

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

Pembolehubah menyimpan hasil pelaksanaan fungsi: sama ada mesej ralat atau nombor yang menunjukkan berapa banyak tag telah dipadam.

Cari pelanggan mengikut pelbagai label

find_clients_by_multiple_labels(labels_array, names) - mencari pelanggan mengikut pelbagai tag

PENTING! Ini hanya mencari pelanggan yang mempunyai SEMUA tag yang ditentukan.

Parameter:

labels_array - tatasusunan tag. ATAU tatasusunan ID,**** ATAU tatasusunan nama.

Jika tatasusunan nama dihantar, maka**❗wajib untuk menghantar parameter kedua (names) ditetapkan kepada 1.**

names - Tetapkan kepada 1, jika tatasusunan mengandungi nama tag dan bukannya ID. Ini menunjukkan bahawa tatasusunan terdiri daripada nama.

Ia TIDAK dibenarkan untuk menggabungkan kedua-dua ID tag dan nama tag dalam fungsi yang sama!

Mengembalikan tatasusunan ID pelanggan (client_id): [41121, 41192, 41522]

/*Cari pelanggan yang mempunyai semua tag yang ditentukan mengikut ID*/

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

/*Cari pelanggan yang mempunyai semua tag yang ditentukan mengikut nama tag*/

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

Semak tatasusunan label pelanggan

has_client_multiple_labels(labels_array, names) - menyemak tatasusunan tag pelanggan

PENTING! Ia mengembalikan True jika pelanggan mempunyai semua tag yang ditentukan!

Parameter:

labels_array - tatasusunan tag. ATAU tatasusunan ID,**** ATAU tatasusunan nama.

Jika tatasusunan nama dihantar, maka**❗wajib untuk menghantar parameter kedua (names) ditetapkan kepada 1.**

names - Tetapkan kepada 1, jika tatasusunan mengandungi nama tag dan bukannya ID. Ini menunjukkan bahawa tatasusunan terdiri daripada nama.

Ia TIDAK dibenarkan untuk menggabungkan kedua-dua ID tag dan nama tag dalam fungsi yang sama!

Mengembalikan sama ada ralat, atau True jika pelanggan mempunyai semua tag daripada tatasusunan, atau False jika pelanggan tidak mempunyai semua tag.

/*Semak sama ada pelanggan mempunyai semua tag yang ditentukan mengikut ID*/

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

/*Semak sama ada pelanggan mempunyai semua tag yang ditentukan mengikut nama tag*/

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

Dapatkan semua ID label pelanggan

get_all_client_label_ids(client_id) — mengembalikan tatasusunan yang mengandungi ID semua label yang ditetapkan kepada pelanggan.

Jika pelanggan tidak mempunyai label, fungsi mengembalikan tatasusunan kosong: [].

Parameter:

  • client_id — ID pelanggan Mavibot. Jika ditinggalkan, ID pelanggan semasa digunakan.