# Сделки в 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, если не требуется делать временно активной сделку, по которой пришел колбек) --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.salebot.pro/crm-sistema/sdelki-v-crm.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.