Для работы с метками Salebot
Для упрощения понимания какой набор функций доступен на тарифе вводим систему обозначений:
- доступно на Бесплатном тарифе

- доступно на Базовом тарифе

- доступно на тарифе Стандарт

- доступно на тарифе Премиум

Действуют на тарифах

Описание
Пример
Пример кода для копирования
Видеоразбор
Метки Salebot отображаются как в карточке клиента:

Метки в карточке клиента
так и в разде ле "Списки":

Метки в разделе Списки
- create_label(label_name) - создание метки Salebot с указанным именем.
Параметры:
! label_name- имя метки, задается в одинарных кавычках ''
- add_label(label_name, client_id) - добавление метки Salebot клиенту.
Параметры:
! label_name - имя метки, задается в одинарных кавычках ''
client_id - идентификатор клиента. Если не передан, то используется идентификатор текущего клиента
- remove_label(label_name, client_id) - удаление метки у клиента
Параметры:
! label_name - имя метки, задается в одинарных кавычках ''
client_id - идентификатор клиента. Если не передан, то используется идентификатор текущего клиента
- has_label(label_name, client_id) - проверить наличие метки у клиента
Параметры:
! label_name - имя метки, задается в одинарных кавычках ''
client_id - идентификатор клиента. Если не передан, то используется идентификатор текущего клиента
- remove_label_everywhere(label_name) - удаление метки у всех клиентов
Параметры:
! label_name- имя метки, задается в одинарных кавычках ''
- count_of_clients_with_label(label_name) - получение общего количества клиентов с ме ткой
Параметры:
! label_name- имя метки, задается в одинарных кавычках ''
Итак, разберем как же создается метка Salebot.
Достаточно единожды выполнить функцию создания в сером блоке (блоке не состояние), например:

Создание метки через функцию Калькулятора
При этом в переменной a можно проанализировать успех выполнения функции создания метки:

Далее метку можно назначить любому из клиентов, для этого пропишите функцию add_label() в нужном блоке Вашей воронки:

Добавление метки клиенту
Проверить наличие метки у клиента можно при помощи функции has_label():

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

Аналогичным методом выполняются и другие дейс твия над метками - удаление метки у конкретного клиента, удаление метки в целом у всех клиентов.
Можно посчитать количество клиентов с заданной меткой - воспользуйтесь функцией count_of_clients_with_label()

Подсчет количества клиентов по заданной метке
/*Создание метки*/
a=create_label('метка1')
/*Прописать метку клиенту*/
a=add_label('этап 1')
/*Проверить есть ли метка у клиента*/
a=has_label('этап 1','73704021')
/*Подсчет количества клиентов по заданной метке*/
etap1=count_of_clients_with_label('этап 1')
tovar1=count_of_clients_with_label('1')
Описание
create_label(label_name) - создание метки Salebot с указанным именем.
Параметры:
! label_name- имя метки, задается в одинарных кавычках ''
Описание
create_label_if_not_exist('lable_name') - создает новую метку, если с таким именем еще нет и возвращает идентификатор или верн ет идентификатор существующей
! label_name- имя метки, задается в одинарных кавычках ''
Параметры функции
Пример
get_all_client_labels(client_id)
Параметры:
client_id - не обязателен, если не передан, будут получены метки текущего клиента.
Функция возвращает ответ в формате json: {"161":"metka1","228":"metka2"}, где:
ключ - это id метки, значение - ее название.

Получить все метки текущего клиента
Параметры функции
Пример
remove_multiple_client_labels(labels_array, names) - функция удалит те метки, что указаны в массиве.
labels_array - массив меток. ИЛИ массив идентификаторов, ИЛИ массив названий.
Если передается массив НАЗВАНИЙ, то дополнительно ❗Обязательно передать второй параметр(names) равный 1.
names - Указать 1, если список названий меток, а не идентификаторы. Это указание на то, что список имен.
НЕЛЬЗЯ в одной функции объединять и идентификаторы и названия меток!!!!
/*Удалить метки по идентификатору*/
r = remove_multiple_client_labels('[138,169,166]')
/*Удалить метки по названию метки*/
r2 = remove_multiple_client_labels('["newTestTag","metka2"]', 1)
В переменную запишется результат выполнения функции: или вернет текст ошибки, или число, сколько было удалено меток.

Параметры функции
Пример
find_clients_by_multiple_labels(labels_array, names) - Найти клиентов по нескольким меткам
ВАЖНО! Найдет только тех клиентов, у которых есть ВСЕ переданные метки.
Параметры:
labels_array - массив меток. ИЛИ массив идентификаторов, ИЛИ массив названий.
Если передается массив НАЗВАНИЙ, то дополнительно ❗Обязательно передать второй параметр(names) равный 1.
names - Указать 1, если список названий меток, а не идентификаторы. Это указание на то, что список имен.
НЕЛЬЗЯ в одной функции объединять и идентификаторы и названия меток!!!!
Вернет список идентификаторов клиентов (client_id): [41121, 41192, 41522]
/* Найти клиентов у кого есть все указанные метки, по идентификатору*/
r = find_clients_by_multiple_labels('[138,169,166]')
/*Найти клиентов у кого есть все указанные метки, по названию меток*/
r2 = find_clients_by_multiple_labels('["newTestTag","metka2"]', 1)

Параметры функции
Пример
has_client_multiple_labels(labels_array, names) - Проверка наличия списка меток у клиента.
ВАЖНО вернет True, если у клиента есть все переданные метки!
labels_array - массив меток. ИЛИ массив идентификаторов, ИЛИ массив названий.
Если передается массив НАЗВАНИЙ, то дополнительно ❗Обязательно передать второй параметр(names) равный 1.
names - Указать 1, если список названий меток, а не идентификаторы. Это указание на то, что список имен.
НЕЛЬЗЯ в одной функции объединять и идентификаторы и названия меток!!!!
Возвращает либо ошибку, либо True - есть все метки из массива, или False, если не все метки есть у клиента
/*Проверить наличие у клиента всех указанных меткок, по идентификатору*/
r = has_client_multiple_labels('[138,169,166]')
/*Проверить наличие у клиента всех указанных меток, по названию меток*/
r2 = has_client_multiple_labels('["newTestTag","metka2"]', 1)

Last modified 2mo ago