Trabalhando com tags do MaviBot

As tags do MaviBot são exibidas em um perfil de cliente como:

e em "Listas" :

create_label(label_name) cria uma tag do MaviBot com o nome especificado

Parâmetros: ! label_name- nome da tag, especificado entre aspas simples ('').

add_label(label_name, client_id) adiciona a tag do MaviBot ao cliente

Parâmetros: ! label_name - nome da tag, 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 tag do cliente

Parâmetros: ! label_name - nome da tag, 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 tem a tag

Parâmetros: ! label_name - nome da tag, especificado entre aspas simples ('') client_id - ID do cliente. Se omitido, o ID do cliente atual é usado

remove_label_everywhere(label_name) remove a tag de todos os clientes

Parâmetros: ! label_name- nome da tag, especificado entre aspas simples ('')

count_of_clients_with_label(label_name) obtém o número total de clientes com a tag

Parâmetros: ! label_name- nome da tag, especificado entre aspas simples ('')

Então, vamos ver como uma tag do MaviBot é criada.

Você só precisa 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 da tag:

Em seguida, você pode atribuir uma tag a qualquer cliente adicionando a add_label() função no bloco apropriado do seu funil:

Você pode verificar se um cliente tem uma tag usando a has_label() função:

A função retorna um valor lógico: True ou False.

Outras ações relacionadas a tags são realizadas de forma semelhante—removendo uma tag de um cliente específico ou removendo uma tag completamente de todos os clientes.

Você também pode contar o número de clientes com uma determinada tag usando a count_of_clients_with_label() função.

/Criar tag/ a=create_label('tag1')

/Atribuir tag ao cliente/ a=add_label('stage 1')

/Verificar se o cliente tem a tag/ a=has_label('этап 1','73704021')

/Contar o número de clientes com uma determinada tag/ etap1=count_of_clients_with_label('stage 1') tovar1=count_of_clients_with_label('1')

create_label(label_name) - cria uma tag do MaviBot com o nome especificado

Parâmetros:

! label_name- nome da tag, especificado entre aspas simples ('')

create_label_if_not_exist(name, color) - cria uma nova tag se ainda não existir uma com o mesmo nome e retorna seu identificador; caso contrário, retorna o identificador da tag existente

name — nome da tag

color — cor da tag (padrão: 0)

Tabela de cores para color parâmetro:

0 — cinza claro

1 — amarelo

2 — azul

3 — vermelho

4 — rosa

5 — bege

6 — roxo

7 — azul claro

8 — cinza

9 - verde

get_all_client_labels(client_id)

Parâmetros:

client_id - opcional; se não for fornecido, as tags do cliente atual serão recuperadas.

A função retorna uma resposta em formato JSON: {"161":"tag1","228":"tag2"}, onde: a chave é o ID da tag e o valor é o nome da tag

remove_multiple_client_labels(labels_array, names) - exclui as tags especificadas no array

labels_array - array de tags. OU ID array, OU names array.

Se o array names 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 tags em vez de IDs. Isso indica que o array consiste em nomes.

/*Excluir tags por ID*/

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

/*Excluir tags por nome da tag*/

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

A variável armazena o resultado da execução da função: ou uma mensagem de erro ou um número indicando quantas tags foram excluídas.

find_clients_by_multiple_labels(labels_array, names) - encontra clientes por várias tags

Parâmetros:

labels_array - array de tags. OU ID array, OU names array.

Se o array names 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 tags em vez de IDs. Isso indica que o array consiste em nomes.

Retorna um array de IDs de clientes (client_id): [41121, 41192, 41522]

/*Encontrar clientes que têm todas as tags especificadas por ID*/

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

/*Encontrar clientes que têm todas as tags especificadas por nomes de tags*/

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

has_client_multiple_labels(labels_array, names) - verifica o array de tags do cliente

Parâmetros:

labels_array - array de tags. OU ID array, OU names array.

Se o array names 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 tags em vez de IDs. Isso indica que o array consiste em nomes.

Retorna um erro, ou True se o cliente tiver todas as tags do array, ou Falso se o cliente não tiver todas as tags.

/*Verificar se o cliente tem todas as tags especificadas por ID*/

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

/*Verificar se o cliente tem todas as tags especificadas por nomes de tags*/

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