Работа с тегами MaviBot

Теги MaviBot отображаются в профиле клиента как:

и в "Списки" :

create_label(label_name) создаёт тег MaviBot с указанным именем

Параметры: ! label_name- имя тега, указанное в одинарных кавычках ('').

add_label(label_name, client_id) добавляет тег MaviBot клиенту

Параметры: ! label_name - имя тега, указанное в одинарных кавычках ('') client_id ID клиента. Если не указан, используется ID текущего клиента

remove_label(label_name, client_id) удаляет тег у клиента

Параметры: ! label_name - имя тега, указанное в одинарных кавычках ('') client_id -ID клиента. Если не указан, используется ID текущего клиента

has_label(label_name, client_id) - проверить, есть ли у клиента тег

Параметры: ! label_name - имя тега, указанное в одинарных кавычках ('') client_id - ID клиента. Если не указан, используется ID текущего клиента

remove_label_everywhere(label_name) удаляет тег у всех клиентов

Параметры: ! label_name- имя тега, указанное в одинарных кавычках ('')

count_of_clients_with_label(label_name) получить общее количество клиентов с тегом

Параметры: ! label_name- имя тега, указанное в одинарных кавычках ('')

Итак, давайте посмотрим как создаётся тег MaviBot.

Вам нужно только один раз выполнить функцию создания в сером блоке (блоке без состояния), например:

При этом переменную a можно использовать для анализа успешности функции создания тега:

Далее вы можете назначить тег любому клиенту добавив add_label() функцию в соответствующий блок вашей воронки:

Вы можете проверить, есть ли у клиента тег, используя has_label() функцию:

Функция возвращает логическое значение: True или False.

Другие действия, связанные с тегами, выполняются аналогично—удаление тега у конкретного клиента или полное удаление тега у всех клиентов.

Вы также можете подсчитать количество клиентов с определённым тегом, используя count_of_clients_with_label() .

/Создать тег/ a=create_label('tag1')

/Назначить тег клиенту/ a=add_label('stage 1')

/Проверить, есть ли у клиента тег/ a=has_label('этап 1','73704021')

/Подсчитать количество клиентов с заданным тегом/ etap1=count_of_clients_with_label('stage 1') tovar1=count_of_clients_with_label('1')

create_label(label_name) - создаёт тег MaviBot с указанным именем

Параметры:

! label_name- имя тега, указанное в одинарных кавычках ('')

create_label_if_not_exist(name, color) - создаёт новый тег, если тег с таким именем ещё не существует, и возвращает его идентификатор; в противном случае возвращает идентификатор существующего тега

name — имя тега

color — цвет тега (по умолчанию: 0)

Таблица цветов для color параметра:

0 — светло-серый

1 — жёлтый

2 — синий

3 — красный

4 — розовый

5 — бежевый

6 — фиолетовый

7 — светло-голубой

8 — серый

9 - зелёный

get_all_client_labels(client_id)

Параметры:

client_id - необязательно; если не указано, будут получены теги текущего клиента.

Функция возвращает ответ в формате JSON: {"161":"tag1","228":"tag2"}, где: ключ — ID тега, а значение — имя тега

remove_multiple_client_labels(labels_array, names) - удаляет теги, указанные в массиве

labels_array - массив тегов. ИЛИ ID массив, ИЛИ names массив.

Если передан массив names, тогда❗обязательно передать второй параметр (names), установленный в 1.

names - установить в 1, если массив содержит имена тегов вместо ID. Это означает, что массив состоит из имён.

/*Удалить теги по ID*/

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

/*Удалить теги по имени тега*/

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

Переменная хранит результат выполнения функции: либо сообщение об ошибке, либо число, указывающее, сколько тегов было удалено.

find_clients_by_multiple_labels(labels_array, names) - находит клиентов по нескольким тегам

Параметры:

labels_array - массив тегов. ИЛИ ID массив, ИЛИ names массив.

Если передан массив names, тогда❗обязательно передать второй параметр (names), установленный в 1.

names - установить в 1, если массив содержит имена тегов вместо ID. Это означает, что массив состоит из имён.

Возвращает массив ID клиентов (client_id): [41121, 41192, 41522]

/*Найти клиентов, у которых есть все указанные теги, по ID*/

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

/*Найти клиентов, у которых есть все указанные теги, по именам тегов*/

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

has_client_multiple_labels(labels_array, names) - проверяет массив тегов клиента

Параметры:

labels_array - массив тегов. ИЛИ ID массив, ИЛИ names массив.

Если передан массив names, тогда❗обязательно передать второй параметр (names), установленный в 1.

names - установить в 1, если массив содержит имена тегов вместо ID. Это означает, что массив состоит из имён.

Возвращает либо ошибку, или True если у клиента есть все теги из массива, либо False если у клиента нет всех тегов.

/*Проверить, есть ли у клиента все указанные теги по ID*/

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

/*Проверить, есть ли у клиента все указанные теги по именам тегов*/

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