Créer / supprimer une étiquette

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

Les étiquettes MaviBot sont affichées dans le profil d'un client comme suit :

et dans la section "Listes" :

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

Paramètres :\ ! label_name - nom de l'étiquette, spécifié entre guillemets simples ('').

add_label(label_name, client_id)
ajoute une étiquette MaviBot au client

Paramètres :\ ! label_name - nom de l'étiquette, spécifié entre guillemets simples ('')
client_id identifiant du client. S'il est omis, l'identifiant du client actuel est utilisé

remove_label(label_name, client_id)
supprime l'étiquette du client

Paramètres :\ ! label_name - nom de l'étiquette, spécifié entre guillemets simples ('')
client_id - identifiant du client. S'il est omis, l'identifiant du client actuel est utilisé

has_label(label_name, client_id) - vérifie si le client possède l'étiquette

Paramètres :\ ! label_name - nom de l'étiquette, spécifié entre guillemets simples ('')
client_id - identifiant du client. S'il est omis, l'identifiant du client actuel est utilisé

remove_label_everywhere(label_name)
supprime l'étiquette de tous les clients

Paramètres :\ ! label_name- nom de l'étiquette, spécifié entre guillemets simples ('')

count_of_clients_with_label(label_name)
obtient le nombre total de clients avec l'étiquette

Paramètres :\ ! label_name- nom de l'étiquette, spécifié entre guillemets simples ('')

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

Il vous suffit d'exécuter la fonction de création une 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 d'étiquette :

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

Vous pouvez vérifier si un client possède une étiquette en utilisant la fonction has_label() :

La fonction renvoie une valeur logique : True ou False.

Les autres actions liées aux étiquettes sont effectuées de manière similaire—suppression d'une étiquette d'un client spécifique ou suppression complète d'une étiquette de tous les clients.

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

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

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

/Vérifier si le client a l'étiquette/ a=has_label('step 1','73704021')

/Compter le nombre de clients avec l'étiquette donnée/ step1=count_of_clients_with_label('stage 1') tovar1=count_of_clients_with_label('1')

Création d'une étiquette

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

Paramètres :

! label_name- nom de l'étiquette, spécifié entre guillemets simples ('')

Création d'une étiquette sans doublon

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

name — nom de l'étiquette

color — couleur de l'étiquette (par défaut : 0)

Tableau des couleurs pour le paramètre color :

0 — gris clair

1 — jaune

2 — bleu

3 — rouge

4 — rose

5 — beige

6 — violet

7 — bleu clair

8 — gris

9 - vert

Obtenir toutes les étiquettes d'un client

get_all_client_labels(client_id)

Paramètres :

client_id - facultatif ; s'il n'est pas fourni, les étiquettes 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 l'étiquette et la valeur est le nom de l'étiquette

Supprimer les étiquettes d'un client par tableau

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

labels_array - tableau d'étiquettes. OU tableau d'ID, OU tableau de noms.

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

names - Défini sur 1, si le tableau contient des noms d'étiquettes au lieu d'IDs. Cela indique que le tableau est composé de noms.

Il n'est PAS autorisé de combiner à la fois des IDs d'étiquettes et des noms d'étiquettes dans la même fonction !

/*Supprimer les étiquettes par ID*/

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

/*Supprimer les étiquettes par nom d'étiquette*/

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 d'étiquettes ont été supprimées.

Trouver des clients par plusieurs étiquettes

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

IMPORTANT ! Cela trouve uniquement les clients qui possèdent TOUTES les étiquettes spécifiées.

Paramètres :

labels_array - tableau d'étiquettes. OU tableau d'ID, OU tableau de noms.

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

names - Défini sur 1, si le tableau contient des noms d'étiquettes au lieu d'IDs. Cela indique que le tableau est composé de noms.

Il n'est PAS autorisé de combiner à la fois des IDs d'étiquettes et des noms d'étiquettes dans la même fonction !

Renvoie un tableau d'IDs clients (client_id) : [41121, 41192, 41522]

/*Trouver les clients qui ont toutes les étiquettes spécifiées par ID*/

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

/*Trouver les clients qui ont toutes les étiquettes spécifiées par noms d'étiquettes*/

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

Vérifier un tableau d'étiquettes d'un client

has_client_multiple_labels(labels_array, names) - vérifie un tableau d'étiquettes d'un client

IMPORTANT ! Renvoie True si un client possède toutes les étiquettes spécifiées !

Paramètres :

labels_array - tableau d'étiquettes. OU tableau d'ID, OU tableau de noms.

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

names - Défini sur 1, si le tableau contient des noms d'étiquettes au lieu d'IDs. Cela indique que le tableau est composé de noms.

Il n'est PAS autorisé de combiner à la fois des IDs d'étiquettes et des noms d'étiquettes dans la même fonction !

Renvoie soit une erreur, soit True si le client possède toutes les étiquettes du tableau, soit False si le client ne possède pas toutes les étiquettes.

/*Vérifier si le client a toutes les étiquettes spécifiées par ID*/

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

/*Vérifier si le client a toutes les étiquettes spécifiées par noms d'étiquettes*/

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

Obtenir tous les IDs d'étiquettes d'un client

get_all_client_label_ids(client_id) — renvoie un tableau contenant les IDs de toutes les étiquettes attribuées au client.

Si le client n'a pas d'étiquettes, la fonction renvoie un tableau vide : [].

Paramètres :

  • client_id — l'ID client Mavibot. S'il est omis, l'ID du client actuel est utilisé.