Робота з мітками MaviBot

01.12.2025

На цій сторінці

Створення / видалення мітки

Мітки MaviBot відображаються в профілі клієнта так:

і в розділі "Списки":

create_label(label_name)
створює мітку MaviBot із вказаною назвою

Параметри:\ ! label_name- назва мітки, вказується в одинарних лапках ('').

add_label(label_name, client_id)
додає мітку MaviBot клієнту

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

remove_label(label_name, client_id)
видаляє мітку у клієнта

Параметри:\ ! label_name - назва мітки, вказується в одинарних лапках ('')
client_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"}, де: ключ — це ідентифікатор мітки, а значення — назва мітки

Видалити мітки клієнта за масивом

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 міток та назви міток в одній функції!

Повертає масив ідентифікаторів клієнтів (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 — ідентифікатор клієнта Mavibot. Якщо пропущено, використовується ID поточного клієнта.