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

01.12.2025

На этой странице

Создание / удаление метки

Метки 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) - проверяет, есть ли у клиента метка

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('step 1','73704021')

/Подсчитать количество клиентов с заданной меткой/ step1=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) равным 1.**

names - Установите 1, если массив содержит имена меток вместо ID. Это указывает на то, что массив состоит из имен.

НЕ ДОПУСКАЕТСЯ одновременное использование 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) равным 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) - проверяет массив меток клиента

ВАЖНО! Возвращает True, если у клиента есть ВСЕ указанные метки!

Параметры:

labels_array - массив меток. ИЛИ массив ID, ИЛИ массив имен.

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

НЕ ДОПУСКАЕТСЯ одновременное использование ID меток и имен меток в одной функции!

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

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

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

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

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

Получить все ID меток клиента

get_all_client_label_ids(client_id) — возвращает массив, содержащий ID всех меток, назначенных клиенту.

Если у клиента нет меток, функция возвращает пустой массив: [].

Параметры:

client_id — ID клиента Mavibot. Если не указан, используется ID текущего клиента.