Travailler avec les étiquettes MaviBot

Les balises MaviBot s’affichent dans un profil client comme suit :

et dans le « Listes » :

create_label(label_name) crée une balise MaviBot avec le nom spécifié

Paramètres : ! label_name- nom de la balise, spécifié entre apostrophes simples ('').

add_label(label_name, client_id) ajoute une balise MaviBot au client

Paramètres : ! label_name - nom de la balise, spécifié entre apostrophes simples ('') client_id ID du client. S’il est omis, l’ID du client actuel est utilisé

remove_label(label_name, client_id) supprime la balise du client

Paramètres : ! label_name - nom de la balise, spécifié entre apostrophes simples ('') client_id -ID du client. S’il est omis, l’ID du client actuel est utilisé

has_label(label_name, client_id) - vérifie si le client a la balise

Paramètres : ! label_name - nom de la balise, spécifié entre apostrophes simples ('') client_id - ID du client. S’il est omis, l’ID du client actuel est utilisé

remove_label_everywhere(label_name) supprime la balise de tous les clients

Paramètres : ! label_name- nom de la balise, spécifié entre apostrophes simples ('')

count_of_clients_with_label(label_name) obtient le nombre total de clients avec la balise

Paramètres : ! label_name- nom de la balise, spécifié entre apostrophes simples ('')

Voyons donc comment une balise MaviBot est créée.

Il vous suffit d’exécuter la fonction de création une seule fois dans le bloc gris (un bloc sans état), par exemple :

En même temps, la variable a peut être utilisée pour analyser le succès de la fonction de création de balise :

Ensuite, vous pouvez attribuer une balise à n’importe quel client en ajoutant la add_label() fonction dans le bloc approprié de votre tunnel :

Vous pouvez vérifier si un client possède une balise à l’aide de la has_label() fonction :

La fonction renvoie une valeur logique : Vrai ou Faux.

Les autres actions liées aux balises sont effectuées de la même manière— suppression d’une balise d’un client spécifique ou suppression complète d’une balise de tous les clients.

Vous pouvez également compter le nombre de clients ayant une balise donnée en utilisant la count_of_clients_with_label() fonction.

/Créer une balise/ a=create_label('tag1')

/Attribuer une balise au client/ a=add_label('stage 1')

/Vérifier si le client a la balise/ a=has_label('этап 1','73704021')

/Compter le nombre de clients avec la balise donnée/ etap1=count_of_clients_with_label('stage 1') tovar1=count_of_clients_with_label('1')

create_label(label_name) - crée une balise MaviBot avec le nom spécifié

Paramètres :

! label_name- nom de la balise, spécifié entre apostrophes simples ('')

create_label_if_not_exist(name, color) - crée une nouvelle balise si aucune balise portant le même nom n’existe encore et renvoie son identifiant ; sinon, renvoie l’identifiant de la balise existante

name — nom de la balise

color — couleur de la balise (par défaut : 0)

Table des couleurs pour color paramètre :

0 — gris clair

1 — jaune

2 — bleu

3 — rouge

4 — rose

5 — beige

6 — violet

7 — bleu clair

8 — gris

9 - vert

get_all_client_labels(client_id)

Paramètres :

client_id - facultatif ; si non fourni, les balises du client actuel seront récupérées.

La fonction renvoie une réponse au format JSON : {"161":"tag1","228":"tag2"}, où : la clé est l’ID de la balise, et la valeur est le nom de la balise

remove_multiple_client_labels(labels_array, names) - supprime les balises spécifiées dans le tableau

labels_array - tableau des balises. OU ID tableau, OU names tableau.

Si le tableau names est passé, alors❗il est obligatoire de passer le deuxième paramètre (names) défini à 1.

names - défini à 1 si le tableau contient des noms de balises au lieu d’ID. Cela indique que le tableau est constitué de noms.

/*Supprimer des balises par ID*/

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

/*Supprimer des balises par nom de balise*/

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

La variable stocke le résultat de l’exécution de la fonction : soit un message d’erreur, soit un nombre indiquant combien de balises ont été supprimées.

find_clients_by_multiple_labels(labels_array, names) - trouve des clients par plusieurs balises

Paramètres :

labels_array - tableau des balises. OU ID tableau, OU names tableau.

Si le tableau names est passé, alors❗il est obligatoire de passer le deuxième paramètre (names) défini à 1.

names - défini à 1 si le tableau contient des noms de balises au lieu d’ID. Cela indique que le tableau est constitué de noms.

Renvoie un tableau d’ID de clients (client_id) : [41121, 41192, 41522]

/*Trouver les clients qui possèdent toutes les balises spécifiées par ID*/

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

/*Trouver les clients qui possèdent toutes les balises spécifiées par noms de balises*/

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

has_client_multiple_labels(labels_array, names) - vérifie le tableau des balises du client

Paramètres :

labels_array - tableau des balises. OU ID tableau, OU names tableau.

Si le tableau names est passé, alors❗il est obligatoire de passer le deuxième paramètre (names) défini à 1.

names - défini à 1 si le tableau contient des noms de balises au lieu d’ID. Cela indique que le tableau est constitué de noms.

Renvoie soit une erreur, ou True si le client possède toutes les balises du tableau, ou Faux si le client ne possède pas toutes les balises.

/*Vérifier si le client possède toutes les balises spécifiées par ID*/

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

/*Vérifier si le client possède toutes les balises spécifiées par noms de balises*/

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