Criar / remover etiqueta
create_label() | add_label() | remove_label() | remove_label_everywhere() | count_of_clients_with_label() | has_label()
As etiquetas do MaviBot são exibidas no perfil do cliente como:
e na seção "Listas":
create_label(label_name)
cria uma etiqueta MaviBot com o nome especificado
Parâmetros:\ ! label_name- nome da etiqueta, especificado entre aspas simples ('').
add_label(label_name, client_id)
adiciona uma etiqueta MaviBot ao cliente
Parâmetros:\ ! label_name - nome da etiqueta, especificado entre aspas simples ('')
client_id ID do cliente. Se omitido, o ID do cliente atual é usado
remove_label(label_name, client_id)
remove a etiqueta do cliente
Parâmetros:\ ! label_name - nome da etiqueta, especificado entre aspas simples ('')
client_id - ID do cliente. Se omitido, o ID do cliente atual é usado
has_label(label_name, client_id) - verifica se o cliente possui a etiqueta
Parâmetros:\ ! label_name - nome da etiqueta, especificado entre aspas simples ('')
client_id - ID do cliente. Se omitido, o ID do cliente atual é usado
remove_label_everywhere(label_name)
remove a etiqueta de todos os clientes
Parâmetros:\ ! label_name- nome da etiqueta, especificado entre aspas simples ('')
count_of_clients_with_label(label_name)
obtém o número total de clientes com a etiqueta
Parâmetros:\ ! label_name- nome da etiqueta, especificado entre aspas simples ('')
Então, vamos ver como uma etiqueta MaviBot é criada.
Basta executar a função de criação uma vez no bloco cinza (um bloco sem estado), por exemplo:
Ao mesmo tempo, a variável a pode ser usada para analisar o sucesso da função de criação de etiqueta:
Em seguida, você pode atribuir uma etiqueta a qualquer cliente adicionando a função add_label() no bloco apropriado do seu funil:
Você pode verificar se um cliente possui uma etiqueta usando a função has_label():
A função retorna um valor lógico: True ou False.
Outras ações relacionadas a etiquetas são realizadas de forma similar—removendo uma etiqueta de um cliente específico ou removendo uma etiqueta completamente de todos os clientes.
Você também pode contar o número de clientes com uma determinada etiqueta usando a função count_of_clients_with_label().
/Criar etiqueta/ a=create_label('tag1')
/Atribuir etiqueta ao cliente/ a=add_label('stage 1')
/Verificar se o cliente possui a etiqueta/ a=has_label('step 1','73704021')
/Contar número de clientes com a etiqueta fornecida/ step1=count_of_clients_with_label('stage 1') tovar1=count_of_clients_with_label('1')
Criando uma etiqueta
create_label(label_name) - cria uma etiqueta MaviBot com o nome especificado
Parâmetros:
! label_name- nome da etiqueta, especificado entre aspas simples ('')
Criando uma etiqueta sem duplicatas
create_label_if_not_exist(name, color) - cria uma nova etiqueta se uma com o mesmo nome ainda não existir e retorna seu identificador; caso contrário, retorna o identificador da etiqueta existente
name — nome da etiqueta
color — cor da etiqueta (padrão: 0)
Tabela de cores para o parâmetro color:
0 — cinza claro
1 — amarelo
2 — azul
3 — vermelho
4 — rosa
5 — bege
6 — roxo
7 — azul claro
8 — cinza
9 - verde
Obter todas as etiquetas do cliente
get_all_client_labels(client_id)
Parâmetros:
client_id - opcional; se não for fornecido, as etiquetas do cliente atual serão recuperadas.
A função retorna uma resposta no formato JSON: {"161":"tag1","228":"tag2"}, onde: a chave é o ID da etiqueta e o valor é o nome da etiqueta
Excluir etiquetas do cliente por array
remove_multiple_client_labels(labels_array, names) - exclui as etiquetas especificadas no array
labels_array - array de etiquetas. OU array de ID, OU array de nomes.
Se um array de nomes for passado, então**❗é obrigatório passar o segundo parâmetro (names) definido como 1.**
names - Defina como 1, se o array contiver nomes de etiquetas em vez de IDs. Isso indica que o array consiste em nomes.
NÃO é permitido combinar IDs de etiquetas e nomes de etiquetas na mesma função!
/*Excluir etiquetas por ID*/
r = remove_multiple_client_labels('[138,169,166]')
/*Excluir etiquetas por nome da etiqueta*/
r2 = remove_multiple_client_labels('["newTestTag","tag2"]', 1)
A variável armazena o resultado da execução da função: uma mensagem de erro ou um número indicando quantas etiquetas foram excluídas.
Encontrar clientes por múltiplas etiquetas
find_clients_by_multiple_labels(labels_array, names) - encontra clientes por múltiplas etiquetas
IMPORTANTE! Isso encontra apenas os clientes que possuem TODAS as etiquetas especificadas.
Parâmetros:
labels_array - array de etiquetas. OU array de ID, OU array de nomes.
Se um array de nomes for passado, então**❗é obrigatório passar o segundo parâmetro (names) definido como 1.**
names - Defina como 1, se o array contiver nomes de etiquetas em vez de IDs. Isso indica que o array consiste em nomes.
NÃO é permitido combinar IDs de etiquetas e nomes de etiquetas na mesma função!
Retorna um array de IDs de clientes (client_id): [41121, 41192, 41522]
/*Encontrar clientes que possuem todas as etiquetas especificadas por ID*/
r = find_clients_by_multiple_labels('[138,169,166]')
/*Encontrar clientes que possuem todas as etiquetas especificadas por nomes de etiquetas*/
r2 = find_clients_by_multiple_labels('["newTestTag","tag2"]', 1)
Verificar array de etiquetas do cliente
has_client_multiple_labels(labels_array, names) - verifica o array de etiquetas do cliente
IMPORTANTE! Retorna True se o cliente possuir todas as etiquetas especificadas!
Parâmetros:
labels_array - array de etiquetas. OU array de ID, OU array de nomes.
Se um array de nomes for passado, então**❗é obrigatório passar o segundo parâmetro (names) definido como 1.**
names - Defina como 1, se o array contiver nomes de etiquetas em vez de IDs. Isso indica que o array consiste em nomes.
NÃO é permitido combinar IDs de etiquetas e nomes de etiquetas na mesma função!
Retorna um erro, ou True se o cliente possuir todas as etiquetas do array, ou False se o cliente não possuir todas as etiquetas.
/*Verificar se o cliente possui todas as etiquetas especificadas por ID*/
r = has_client_multiple_labels('[138,169,166]')
/*Verificar se o cliente possui todas as etiquetas especificadas por nomes de etiquetas*/
r2 = has_client_multiple_labels('["newTestTag","tag2"]', 1)
Obter todos os IDs de etiquetas do cliente
get_all_client_label_ids(client_id) — retorna um array contendo os IDs de todas as etiquetas atribuídas ao cliente.
Se o cliente não tiver etiquetas, a função retorna um array vazio: [].
Parâmetros:
-
client_id— o ID do cliente Mavibot. Se omitido, o ID do cliente atual é usado.