Crear / eliminar etiqueta
create_label() | add_label() | remove_label() | remove_label_everywhere() | count_of_clients_with_label() | has_label()
Las etiquetas de MaviBot se muestran en el perfil del cliente como:
y en la sección "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ñade una 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)
elimina la 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) - comprueba 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)
elimina la etiqueta de todos los clientes
Parámetros:\ ! label_name- nombre de la etiqueta, especificado entre comillas simples ('')
count_of_clients_with_label(label_name)
obtiene 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 se puede usar 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 función add_label() en el bloque correspondiente de tu embudo:
Puedes comprobar si un cliente tiene una etiqueta usando la función has_label():
La función devuelve un valor lógico: Verdadero o Falso.
Otras acciones relacionadas con etiquetas se realizan de manera 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 función count_of_clients_with_label().
/Crear etiqueta/ a=create_label('tag1')
/Asignar etiqueta al cliente/ a=add_label('stage 1')
/Comprobar si el cliente tiene la etiqueta/ a=has_label('step 1','73704021')
/Contar número de clientes con la etiqueta dada/ step1=count_of_clients_with_label('stage 1') tovar1=count_of_clients_with_label('1')
Crear una etiqueta
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 ('')
Crear una etiqueta sin duplicados
create_label_if_not_exist(name, color) - crea una nueva etiqueta si aún 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 (por defecto: 0)
Tabla de colores para el parámetro color:
0 — gris claro
1 — amarillo
2 — azul
3 — rojo
4 — rosa
5 — beige
6 — púrpura
7 — azul claro
8 — gris
9 - verde
Obtener todas las etiquetas del cliente
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
Eliminar etiquetas del cliente por array
remove_multiple_client_labels(labels_array, names) - elimina las etiquetas especificadas en el array
labels_array - array de etiquetas. O array de ID, O array de nombres.
Si se pasa un array de nombres, entonces**❗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.
¡NO está permitido combinar tanto IDs de etiquetas como nombres de etiquetas en la misma función!
/*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.
Encontrar clientes por múltiples etiquetas
find_clients_by_multiple_labels(labels_array, names) - encuentra clientes por múltiples etiquetas
¡IMPORTANTE! Esto encuentra solo aquellos clientes que tienen TODAS las etiquetas especificadas.
Parámetros:
labels_array - array de etiquetas. O array de ID, O array de nombres.
Si se pasa un array de nombres, entonces**❗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.
¡NO está permitido combinar tanto IDs de etiquetas como nombres de etiquetas en la misma función!
Devuelve un array de IDs de clientes (client_id): [41121, 41192, 41522]
/*Encontrar clientes que tengan todas las etiquetas especificadas por ID*/
r = find_clients_by_multiple_labels('[138,169,166]')
/*Encontrar clientes que tengan todas las etiquetas especificadas por nombres de etiqueta*/
r2 = find_clients_by_multiple_labels('["newTestTag","tag2"]', 1)
Comprobar array de etiquetas del cliente
has_client_multiple_labels(labels_array, names) - comprueba el array de etiquetas del cliente
¡IMPORTANTE! ¡Devuelve True si un cliente tiene todas las etiquetas especificadas!
Parámetros:
labels_array - array de etiquetas. O array de ID, O array de nombres.
Si se pasa un array de nombres, entonces**❗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.
¡NO está permitido combinar tanto IDs de etiquetas como nombres de etiquetas en la misma función!
Devuelve un error, o True si el cliente tiene todas las etiquetas del array, o False 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)
Obtener todos los IDs de etiquetas del cliente
get_all_client_label_ids(client_id) — devuelve un array que contiene los IDs de todas las etiquetas asignadas al cliente.
Si el cliente no tiene etiquetas, la función devuelve un array vacío: [].
Parámetros:
-
client_id— el ID del cliente en Mavibot. Si se omite, se usa el ID del cliente actual.