Робота з тегами 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 - масив міток. OR ID масив, OR 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 - масив міток. OR ID масив, OR 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 - масив міток. OR ID масив, OR 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)