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

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

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

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

ОБОЗНАЧЕНИЯ:
! - Обязательные параметры
Описание
Примеры
Пример кода для кописрования
Видеоразбор
was_in_state(message_id) – для проверки был ли клиент в выбранном состоянии(блоке). Номер блока можно взять из редактора:

Верхняя строка редактора блока: номер блока
days_from_last_message() - для определения количества дней с момента последней реплики клиента. Создана для проверки попадания в 24часовое окно.
Пример:
d = days_from_last_message()
free_client() - для снятия ответственного оператора Пример:
free_client()
assign_to_user(email) - для назначения диалога оператору.
Пример:
assign_to_user('email оператора')
Если написать так:
assign_to_user()
то диалог назначится случайному оператору, который в данный момент находится на смене
distribute_client() - для назначения диалога оператору согласно настроек автораспределения. Пример:
distribute_client()
get_operator() - для получения email ответственного оператора.
Пример:
get_operator()
Можно использовать для постановки задачи ответственному и т.д. или проверки есть ли ответственный оператор. Если ответственного нет, то вернется None.
get_operator_name() - для получения имени ответственного оператора.
Пример:
get_operator_name()
Можно использовать для вывода информации клиенту. Если ответственного нет, то вернется None. Если у оператора не назначено имя, то вернется email.
delete_pended_messages() - для удаления всех запланированных сообщений для текущего клиента. По умолчанию удаляет и сообщения, созданные стрелками "Не отменять". Чтобы не отменять сообщения со стрелок "Не отменять" необходимо передать параметр False:
delete_pended_messages(False)
set_note(comment) - для добавления комментария к диалогу.
Пример:
set_note
('Переделать')
add_unread(count) — для пометки непрочитанным диалога с клиентом
Параметр count можно не передавать или передать значение 1, тогда в диалоге с клиентом будет отметка +1 непрочитанное сообщение.


Если передать любое другое число оно отобразиться в разделе Клиенты как количество непрочитанных сообщений от клиента:


clear_unread() — для пометки диалога прочитанным
Функции работы с задачами возвращают статус выполнения операции True или идентификатор задачи в случае успеха. В случае неудачи возвращается False или None.
Salebot работает с датами в формате "dd.mm.yyyy", а с временем в формате "HH:MM"
Описание
Примеры
Пример кода для копирования
Видеоразбор
create_task(email, naim, date_srok, description, time_srok) – для создания задачи
Параметры:
! email - еmail ответственного
! naim - название задачи
! date_srok - срок выполнения, дата
description - описание
time_srok - срок выполнения, время
update_task(task_id,email, naim, date_srok, description, time_srok) - для обновления задачи
Параметры:
! task_id- id задачи
! email - еmail от ветственного
! naim - название задачи
! date_srok - срок выполнения, дата
description - описание
time_srok - срок выполнения, время
done_task(task_id)- для отметки задачи - выполнено
Параметры:
! task_id- id задачи
delete_task(task_id) – для удаления задачи
Параметры:
! task_id- id задачи
Создадим задачу оператору:


Пункт меню Задачи
Обновим срок исполнения и описание

Обновление задачи

Задача после обновления
Отметим как выполненную задачу

Отмечаем задачу выполненной

Задача выполнена
Удаление задачи

task_id=create_task('[email protected]', 'Test', '22.01.2023', 'тестовая задача', '08:00')
status=delete_task(task_id)
get_order_id() | create_order() | get_active_orders_ids() | get_success_orders_ids() | get_fail_orders_ids() | get_order_var() | get_order_vars() | set_order_var() | set_order_vars() | move_order_to_next_state() | set_order_status_success() | set_order_status_fail(order_id)| get_state_id() | change_state()
Описание
Примеры
Пример кода для копирования
Получение идентификатора текущей сделки
get_order_id()
Создание новой сделки
create_order()
Текущая активная сделка в воронке вместе с переменными станет доступна только в функциях для работы со сделками и в CRM.
Действие аналогично действию красного блока, за исключением отправки заявки на почту, указанную в настройках проекта
Получение списка активных сделок
(исключая архивные*, успешные или проваленные сделки)
get_active_orders_ids()
Получение списка идентификаторов успешных сделок
get_success_orders_ids()
Получение списка идентификаторов проваленных сделок
get_fail_orders_ids()
Получение значения переменной сделки
get_order_var(order_id, variable)
Параметры:
! order_id - идентификатор сделки
! variable - имя переменной, значение которой необходимо получить
Получение данных сделки
get_order_vars(order_id, names)
Параметры:
! order_id - идентификатор сделки
names - массив переменных, данные которых необходимо получить. Если не указан, то функция вернет все данные указанной сделки
Функция возвращает словарь с переменными, перечисленными в массиве names, для сделки order_id. Если names не указано, то функция вернет словарь всех переменных указанной сделки
Добавление переменной сделки
set_order_var(order_id, variable, value)
Параметры:
! order_id - идентификатор сделки
! variable - имя переменной, которую будем добавлять в сделку
! value - значение переменной
Добавление нескольких переменных сделки
set_order_vars(order_id, variables_dict)
Параметры:
! order_id - идентификатор сделки.
! variables_dict - словарь переменных
Перенос на следующий этап воронки
move_order_to_next_state(order_id)
Параметры:
order_id - идентификатор сделки. Если параметр не указан, то будет перемещена текущая активная сделка
Порядок состояний сделки устанавливается в соответствии с заданным порядком в SalebotCRM
.png?alt=media&token=5f57991d-6f43-45af-ae99-07786be93b6f)
Порядок состояний сделки в SalebotCRM
Получение id состояния воронки в SalebotСRM
get_state_id(client_id,order_id)
Также id состояния воронки можно скопировать в Настройках состояния

Настройки состояния
Параметры:
! client_id - id клиента, по умолчанию текущий клиент
order_id - id сделки клиента
Перемещение лида по воронке SalebotCRM по id состояния
change_state(state_id, order_id)
Параметры:
! state_id - id состояния воронки
order_id - id сделки, которрую перемещаем по воронке
Все функции просты в своем применении.
Например, создадим новую сделку, отправим ее номер клиенту:

Создание новой сделки

Регистрация обращения клиента
Вы можете получить идентификатор текущей активной сделки клиента, используя функцию get_order_id(), или весь перечень сделок клиента, используя get_active_orders_ids()

Получение идентификатора текущей активной сделки

Получение списка активных сделок
Зная идентификатор сделки, мы можем назначать, получать переменные:

Назначение и получение переменных
/* Создание сделки */
oid = create_order()
/*Получение ид сделки клиента*/
oid = get_order_id()
/*Получение списка активных сделок*/
res = get_active_orders_ids()
/*Добавление/получение переменных сделки*/
res = set_order_var('40630', 'обновлено', '#{current_date}')
vars = {"VAR1": "V111", "VAR2": "V222"}
res2 = set_order_vars('40630', vars)
ovar = get_order_vars('40630')
Описание
set_order_status_success(order_id)
Параметры:
order_id - идентификатор сделки. Если параметр не указан, то метка будет установленая для текущей активной сделки
Описание
set_order_status_fail(order_id)
Параметры:
order_id - идентификатор сделки. Если параметр не указан, то метка б удет установленая для текущей активной сделки
Описание
Примеры
set_order_status_archive(order_id)
Параметры:
order_id - идентификатор сделки. Если параметр не указан, то метка будет установлена для текущей активной сделки
/*Отправить текущую активную сделку в архив*/
res_arh = set_order_status_archive()
Last modified 12d ago