Trabajar con etiquetas de MaviBot

Las etiquetas de MaviBot se muestran en un perfil de cliente como:

y en el "Listas" :

create_label(label_name) crea una etiqueta de MaviBot con el nombre especificado

Parámetros: ! label_name- nombre de la etiqueta, especificado entre comillas simples ('').

add_label(label_name, client_id) añadir etiqueta de MaviBot al cliente

Parámetros: ! label_name - nombre de la etiqueta, especificado entre comillas simples ('') client_id ID del cliente. Si se omite, se usa el ID del cliente actual

remove_label(label_name, client_id) eliminar etiqueta del cliente

Parámetros: ! label_name - nombre de la etiqueta, especificado entre comillas simples ('') client_id - ID del cliente. Si se omite, se usa el ID del cliente actual

has_label(label_name, client_id) - comprobar si el cliente tiene la etiqueta

Parámetros: ! label_name - nombre de la etiqueta, especificado entre comillas simples ('') client_id - ID del cliente. Si se omite, se usa el ID del cliente actual

remove_label_everywhere(label_name) eliminar etiqueta de todos los clientes

Parámetros: ! label_name- nombre de la etiqueta, especificado entre comillas simples ('')

count_of_clients_with_label(label_name) obtener el número total de clientes con la etiqueta

Parámetros: ! label_name- nombre de la etiqueta, especificado entre comillas simples ('')

Entonces, veamos cómo se crea una etiqueta de MaviBot.

Solo necesitas ejecutar la función de creación una vez en el bloque gris (un bloque sin estado), por ejemplo:

Al mismo tiempo, la variable a puede usarse para analizar el éxito de la función de creación de etiquetas:

A continuación, puedes asignar una etiqueta a cualquier cliente añadiendo la add_label() función en el bloque correspondiente de tu embudo:

Puedes comprobar si un cliente tiene una etiqueta usando la has_label() función:

La función devuelve un valor lógico: True o False.

Otras acciones relacionadas con etiquetas se realizan de forma similar—eliminar una etiqueta de un cliente específico o eliminar una etiqueta por completo de todos los clientes.

También puedes contar el número de clientes con una etiqueta determinada usando la count_of_clients_with_label() función.

/Crear etiqueta/ a=create_label('tag1')

/Asignar etiqueta al cliente/ a=add_label('stage 1')

/Comprobar si el cliente tiene etiqueta/ a=has_label('этап 1','73704021')

/Contar el número de clientes con una etiqueta determinada/ etap1=count_of_clients_with_label('stage 1') tovar1=count_of_clients_with_label('1')

create_label(label_name) - crea una etiqueta de MaviBot con el nombre especificado

Parámetros:

! label_name- nombre de la etiqueta, especificado entre comillas simples ('')

create_label_if_not_exist(name, color) - crea una nueva etiqueta si todavía no existe una con el mismo nombre y devuelve su identificador; de lo contrario, devuelve el identificador de la etiqueta existente

name — nombre de la etiqueta

color — color de la etiqueta (predeterminado: 0)

Tabla de colores para color parámetro:

0 — gris claro

1 — amarillo

2 — azul

3 — rojo

4 — rosa

5 — beige

6 — morado

7 — azul claro

8 — gris

9 - verde

get_all_client_labels(client_id)

Parámetros:

client_id - opcional; si no se proporciona, se recuperarán las etiquetas del cliente actual.

La función devuelve una respuesta en formato JSON: {"161":"tag1","228":"tag2"}, donde: la clave es el ID de la etiqueta y el valor es el nombre de la etiqueta

remove_multiple_client_labels(labels_array, names) - elimina las etiquetas especificadas en el array

labels_array - array de etiquetas. O ID arreglo, O names array.

Si se pasa el array namesa otro servicio❗es obligatorio pasar el segundo parámetro (names) establecido en 1.

names - Establecer en 1 si el array contiene nombres de etiquetas en lugar de IDs. Esto indica que el array consiste en nombres.

/*Eliminar etiquetas por ID*/

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

/*Eliminar etiquetas por nombre de etiqueta*/

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

La variable almacena el resultado de la ejecución de la función: ya sea un mensaje de error o un número que indica cuántas etiquetas se eliminaron.

find_clients_by_multiple_labels(labels_array, names) - encuentra clientes por múltiples etiquetas

Parámetros:

labels_array - array de etiquetas. O ID arreglo, O names array.

Si se pasa el array namesa otro servicio❗es obligatorio pasar el segundo parámetro (names) establecido en 1.

names - Establecer en 1 si el array contiene nombres de etiquetas en lugar de IDs. Esto indica que el array consiste en nombres.

Devuelve un array de IDs de clientes (client_id): [41121, 41192, 41522]

/*Encontrar clientes que tienen todas las etiquetas especificadas por ID*/

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

/*Encontrar clientes que tienen todas las etiquetas especificadas por nombres de etiqueta*/

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

has_client_multiple_labels(labels_array, names) - comprueba el array de etiquetas del cliente

Parámetros:

labels_array - array de etiquetas. O ID arreglo, O names array.

Si se pasa el array namesa otro servicio❗es obligatorio pasar el segundo parámetro (names) establecido en 1.

names - Establecer en 1 si el array contiene nombres de etiquetas en lugar de IDs. Esto indica que el array consiste en nombres.

Devuelve ya sea un error, o True si el cliente tiene todas las etiquetas del array, o Falso si el cliente no tiene todas las etiquetas.

/*Comprobar si el cliente tiene todas las etiquetas especificadas por ID*/

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

/*Comprobar si el cliente tiene todas las etiquetas especificadas por nombres de etiqueta*/

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