> For the complete documentation index, see [llms.txt](https://docs.salebot.pro/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.salebot.pro/crm-sistema/sdelki-v-crm.md). # Сделки в CRM Сделки в CRM отображаются в виде карточек с информацией о клиенте, названии сделок, описании и суммы.

При необходимости можно добавить и другие поля (например, переменные) (см. рис. 8 — 12). ## Кнопка "Создать сделку"

Рис. 20. Кнопка "Создать сделку"

Создать сделку - модальное окно создания новой сделки:

Рис. 21. Модальное окно создания сделки

Вы можете заполнить все данные в форме и создать клиента. Если клиент есть в базе клиентов, то salebot предложит выбрать данного клиента:

Рис. 22. Выбор клиента из существующих в системе
(p.s. все данные вымышлены, совпадения случайны)

В случае, если клиента нет, то для создания клиента в проекте должен быть подключен или WhatsApp или email-бот - в эти каналы вы можете писать первым, поэтому создание клиента пройдет успешно, даже если клиент не найден в базе. Также можно выбрать состояние воронки, в которое будет добавлена сделка:

Рис. 23. Выбор воронки и состояния, где будет создана сделка

Также в окне модальной формы можно добавить переменные сделки:

Рис. 24. Вкладка "Переменные сделки" в окне создания сделки

Далее нажмите "Создать", чтобы сделка была добавлена в систему. ## Кнопка "Быстрое добавление" Данная кнопка также поможет добавить нового клиента в CRM-систему вручную.

Рис. 25. Кнопка "Быстрое добавление"
(p.s. все данные вымышлены, совпадения случайны)

Кликните по кнопке (рис. 25), чтобы открылось окно с полями для заполнения информации о клиенте:

Рис. 26. Окно для быстрого добавления сделки
(p.s. все данные вымышлены, совпадения случайны)

Таким образом, сделка будет создана в состоянии "Заинтересовались":

Рис. 27. Сделка, созданная с
помощью кнопки "Быстрое добавление"

{% hint style="success" %} Готово! Теперь вы знаете, как создавать сделки. {% endhint %} ## Создать сделку из чат-бота

Рис. 28. Пример схемы чат-бота
для создания сделки с помощью функции

Порядок действий: 1. Создайте блок с условием ("Стартовое условие"):

Рис. 29. Настройки блока "Стартовое условие"

В этом блоке обозначим простую информацию для клиента. 2. Создайте блок ниже, соединенный стрелкой с предыдущим блоком:

Рис. 30. Настройки блока с кнопками

В данном блоке созданы кнопки с функцией "По умолчанию" и текстом "Многостраничный сайт", "Одностраничный сайт". При выборе клиентом кнопки он перейдет в один из блоков "Состояние", а с помощью стрелок мы передали переменную description и активировали чекбокс "Пользователь вводит данные":

Рис. 31. Настройки стрелки

3. Далее в блоках, к которым ведут стрелки "Многостраничный сайт" и "Одностраничный" сайт запрашиваем номер телефона клиента и сразу объявляем переменную budget со стоимостью услуги (сделки):

Рис. 32. Настройки блока с объявлением переменной budget

4. Далее создадим два блока: "Состояние" и "Не состояние". Данные блоки нам понадобятся для проверки номера телефона клиента.

Рис. 33. Настройки стрелки: проверка номера телефона и
объявление переменной для сохранения номера клиента в системе

В условии стрелки указываем регулярное выражение для проверки валидности номера телефона, а выбор соответствия выбираем "Регулярное выражение". Также активируем чекбокс "Пользователь вводит данные" и указываем переменную phone. Если клиент введет номер телефона с ошибкой, например, 89938383ааа, то отработается блок "Не состояние" — клиенту будет необходимо повторно ввести номер телефона. Если номер телефона пройдет проверку, то клиент перейдет в следующий блок "Как вас зовут?" 5. Предпоследним блоком в схеме будет блок "Состояние", в котором будем спрашивать у клиента его имя.

Рис. 34. Блок "Состояние" для запроса имени клиента

Из данного блока (рис. 34) протягиваем стрелку со сбором данных:

Рис. 35. Настройки стрелки со сбором данных в виде
имени клиента

В стрелке активируем чекбокс "Пользователь вводит данные" и указываем переменную client\_name. 6. В последнем блоке прописываем функцию для создания сделки в CRM системе:

Рис. 36. Блок "Состояние" с функцией для создания сделки

**Функция create\_order(name, budget, description, client\_name, phone, email, state\_id) - для создания сделки из чат-бота в CRM**

Параметры

Текущая активная сделка в воронке вместе с переменными станет доступна только в функциях для работы со сделками и в CRM.

Параметры	Значение
name	название сделки. Необязательный параметр, если не передан, то применит к текущей активной сделке клиента
budget	стоимость сделки (число). Необязательный параметр, если не передан, то применит к текущей активной сделке клиента Если передать в параметре budget не число, функция вернет ответ: 'budget must be a number'
description	Описание сделки. Необязательный параметр;
client_name	(необязательный параметр) строка, имя для нового клиента
phone	(необязательный параметр) строка, телефон для нового клиента
email	(необязательный параметр) строка, емейл для нового клиента
state_id	число, позволяет указать состояние, в котором будет сделка после создания, необязательный параметр

{% hint style="info" %} Для создания клиента должна быть указана переменная phone или email. Если указана phone, и клиента с таким телефоном в проекте нет, то будет создан новый. Если указана переменная email без переменной phone, и клиента в проекте с таким адресом нет, будет создан новый. {% endhint %}

В схеме мы поэтапно собрали следующие данные: * Name - название сделки (в примере это "Многостраничный сайт" или "Одностраничный лендинг" — рис. 30-31); * Budget — стоимость сделки, которую объявили в блоках после выбора клиентом типа сайта (рис. 32); * Phone — номер телефона клиента (рис. 33); * Client\_name — имя клиента (рис. 34-35).

Рис. 37. Блок "Состояние" с функцией для создания сделки

При необходимости создания сделки в определенном состоянии сделки, передайте параметр state\_id:

Рис. 38. Передача id состояния сделки

{% hint style="info" %} Важно! Если вы не передаете какие-либо параметры, то вместо параметра передайте none (как на рис. 36, где вместо параметра email указан none). {% endhint %} Где найти id состояния (параметр state\_id):

Рис. 39. Меню дополнительных настроек состояния

ID состояния:

Рис. 40. ID состояния

Теперь бот будет отрабатывать следующим образом:

Рис. 41. Тестирование бота в Telegeam

После чего вы можете найти сделку в том состоянии воронки, ID которого передали в функции create\_order:

Рис. 42. Пример созданной
сделки с помощью функции

В разделе "Клиенты" вы сможете увидеть созданного клиента, посмотреть с ним переписку и увидеть сделки. ## Другие настройки * Строка поиска - поиск сделки по имени клиента.

Рис. 43. Строка поиска сделки

* Фильтр - позволяет фильтровать сделки с указанием различных параметров. Так же вы можете сохранить созданный фильтр, если часто его используете.

Рис. 44. Фильтр для сделок

## Запуск бота при смене состояния воронки Вы можете запустить бота при перемещении сделки по этапу воронки в CRM. Для включения данной функции перейдите в настройки проекта:

Рис. 45. Вкладка с настройками
проекта

\ Далее перейдите в раздел Callback's:

Рис. 46. Вкладка Calbacks в настройках проекта

Нажмите на "Настройки колбеков при переходе между этапами CRM":

Рис. 47. Переход в настройки колбеков для CRM

После чего вам откроется модальное окошко со всеми воронками, которые существуют в проекте, где необходимо выбрать всю воронку или только определенное состояние:

Рис. 48. Выбор воронки или состояний воронки

Затем сохраните настройки. Теперь при смене состояния сделки (в автоматическом или ручном режиме) из любого места на сайте сгенерируется уведомление, с помощью которого можно настроить реакцию в боте. {% hint style="info" %} Уведомление умеет вид: **crm\_state\_changed Имя воронки:Название этапа** {% endhint %} Также в карточке клиента появится переменная **callback\_query\_id**, в которой будет сохранен идентификатор сделки, для которой отправлено уведомление

Рис. 49. Вид колбека при смене состояния

Чтобы запустить бота на это событие, необходимо указать текст колбека (уведомления) в поле Условие стрелки или любого блока с условием ("Стартовое условие", "Не состояние с условием").

Рис. 50. Настройка реакции с помощью блока "Не состояние с условием"

Рис. 51. Настройка реакции с помощью блока "Стартовое условие"

{% hint style="info" %} Если вы не хотите выбивать клиента из основной схемы чат-бота, воспользуйтесь блоком "Не состояние с условием" — в этот блок нельзя перейти, поэтому клиента после реакции на уведомление (колбек) не выбьет из основной воронки, но сообщение все равно будет отправлено. А если вам нужно продолжить воронку с реакции на смену состояния, то используйте блок "Стартовое условие", тогда клиент перейдет в блок "Стартовое условие" с реакцией на колбек, с которого вы можете продолжить воронку. {% endhint %} ### Перемещение сделок Для перемещения сделки в любое состояние воронки достаточно захватить ее левой кнопки мыши и переместить в необходимое состояние:

При перемещении сделки в "Проваленные" или "Архив" появляется модальное окно с просьбой указать причину перемещения, далее создается переменная сделки failed\_reason или achived\_reason соответственно. В failed\_reason или achived\_reason и вписывается текст причина перемещения в проваленные, при восстановлении сделки обратно будет добавляться переменная restored\_from\_failed или restored\_from\_archived со значением "true" ## Установить запрет на перемещение сделки в указанное состояние Если необходимо ограничить стадии в которые сделки будет перемещена при ручном перемещении, то настройте запрет в настройках состояния. \ Откройте воронку и перейдите в настройки состояния.

В настройках состояния вы можете задать состояния, в которые сделку нельзя будет перенести. Отмечать выбранные этапы воронки необходимо в чек-боксе. Вы можете указать несколько состояний. После того, как все необходимые состояния будут выбраны, сохраните изменения.

После того, как настройки будут сохранены, при перемещении сделки в разделе SalebotCRM недоступные состояния будут визуально отличаться по цвету. Они станут темнее, и возможность переноса будет ограничена. В диалоге с клиентом, запрещенные состояния отображаться не будут если установлен запрет на перенос. ## Реакция на удаление сделки в CRM При удалении сделки в CRM в бот клиенту приходит колбек об этом **crm\_lead\_removed**

## Функции API Salebot {% hint style="info" %} Для работы со сделками в чат-боте можно использовать функции API в калькуляторе. Подробнее о функциях читайте в статье "[Для работы со сделками](/chatbots/peremennye-i-funkcii/kalkulyator/dlya-raboty-so-ssylkami.md)". {% endhint %} ## Переключение сделок Если на странице CRM происходят действия со сделками, то приходят колбеки со следующими ключевыми словами: 1. change\_responsible\_order - у сделки поменяли ответственного 2. crm\_state\_changed - сделку перенесли по стадиям воронки 3. crm\_system\_state\_changed - сделку перенесли в Проваленные, Успешные или Архивные 4. crm\_lead\_removed - сделку удалили Также в переменные клиента записывается переменная "callback\_order\_id", содержащая id сделки, с которой происходили действия на странице CRM.

При обработке такого колбека в блоке сделка временно становится активной - то есть в этом блоке можно обращаться к её переменным. При переходе в следующий блок работает стандартная логика Salebot - при обращении к переменным сделки пользователь получит значения для последней сделки клиента. ### Переключение сделки в активное состояние в боте **switch\_order(order\_id)** - позволяет переключить сделку в активное состояние, чтобы обращаться к её переменным order\_id - необязательный параметр, id сделки. Если не передавать, то активной станет последняя сделка Клиента. В функцию switch\_order(order\_id) нужно передать id сделки, тем самым сделать эту сделку активной. Если вызвать эту функцию в калькуляторе и передать id желаемой сделки, то далее в блоке можно обращаться к переменным этой сделки.

Если в функцию switch\_order передать id удалённой или несуществующей сделки, то переключения не произойдет, и функция вернет id той сделки, которая сейчас установлена активной у Клиента (или None, если у Клиента нет активной сделки). Таким образом можно проверить, произошло ли переключение сделки, сравнив order\_id, который был передан в функцию, с тем результатом, что она вернула: `switch_result = switch_order(order_id)` `РЕЗУЛЬТАТ = if(switch_result == order_id, value_if_true, value_if_false)`

Если в функцию switch\_order не передавать ничего, то функция сделает активной последнюю сделку Клиента, таким образом можно откатывать переключение сделки (после переключения сделки или в блоке, обрабатывающем колбеки от CRM, если не требуется делать временно активной сделку, по которой пришел колбек)