Для работы с метками Salebot

create_label() | add_label() | remove_label() | remove_label_everywhere() | count_of_clients_with_label() | has_label()

Метки 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- имя метки, задается в одинарных кавычках ''

Создание метки из блока: create_label()

create_label(label_name) - создание метки Salebot с указанным именем.

Параметры:

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

Создание метки из блока без создания дубля: create_label_if_not_exist()

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()

get_all_client_labels(client_id)

Параметры:

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

Функция возвращает ответ в формате json: {"161":"metka1","228":"metka2"}, где:

ключ - это id метки, значение - ее название.

Удалить метки клиента массивом: remove_multiple_client_labels()

remove_multiple_client_labels(labels_array, names) - функция удалит те метки, что указаны в массиве.

labels_array - массив меток. ИЛИ массив идентификаторов, ИЛИ массив названий.

Если передается массив НАЗВАНИЙ, то дополнительно ❗Обязательно передать второй параметр(names) равный 1.

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

НЕЛЬЗЯ в одной функции объединять и идентификаторы и названия меток!!!!

Найти клиентов по нескольким меткам: find_clients_by_multiple_labels()

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

ВАЖНО! Найдет только тех клиентов, у которых есть ВСЕ переданные метки.

Параметры:

labels_array - массив меток. ИЛИ массив идентификаторов, ИЛИ массив названий.

Если передается массив НАЗВАНИЙ, то дополнительно ❗Обязательно передать второй параметр(names) равный 1.

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

НЕЛЬЗЯ в одной функции объединять и идентификаторы и названия меток!!!!

Вернет список идентификаторов клиентов (client_id): [41121, 41192, 41522]

Найти клиента по переменной: find_client_id_by_var(search_in)

Ищет до 3-х переменных у клиентов проекта, возвращает список клиентов, у которых есть все заявленные переменные.

search_in - необязательный параметр, если передать, то ищет по переменным сделки

Проверка наличия списка меток у клиента: has_client_multiple_labels()

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

ВАЖНО вернет True, если у клиента есть все переданные метки!

labels_array - массив меток. ИЛИ массив идентификаторов, ИЛИ массив названий.

Если передается массив НАЗВАНИЙ, то дополнительно ❗Обязательно передать второй параметр(names) равный 1.

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

НЕЛЬЗЯ в одной функции объединять и идентификаторы и названия меток!!!!

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

Last updated