# Битрикс24

Перед настройкой установите приложение и подключите Битрикс24.

# Доступные действия

• Изменить поле сделки, контакта или компании — записывает в выбранное поле данные из диалога, фиксированное значение или переменную.
• Изменить статус сделки — переводит сделку на другой этап воронки.
• Найти сделку — находит сделку по одному или нескольким условиям и возвращает выбранные поля, не изменяя CRM.
• Найти и обновить/создать сделку — ищет сделку, обновляет найденную или создаёт новую в зависимости от выбранного режима.
• Перевести диалог на свободного оператора — передаёт чат первому доступному сотруднику открытой линии.
• Перевести диалог на оператора или очередь — позволяет выбрать конкретного сотрудника либо очередь.
• Поставить задачу — создаёт задачу выбранному пользователю; можно оставить вариант Текущий пользователь и задать текст задачи.
• Изменить стадию смарт-процесса — переводит элемент выбранного смарт-процесса на другую стадию.

# Условия запуска Битрикс24

Во вкладке Каналы и запуск для Битрикс24 можно добавить условия Поле сделки, Поле клиента и Запущен смарт-процесс. Для поля выберите объект, поле CRM, оператор и значение. Интерфейс учитывает тип поля: показывает число, дату, список, пользователя или флаг вместо обычной строки.

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

# Найти сделку

1. Выберите, что делать, если найдено несколько сделок: взять первую, последнюю или вернуть ошибку.
2. Выберите поведение при отсутствии результата: вернуть пустой результат или ошибку.
3. Добавьте одно или несколько условий поиска и объедините их через AND или OR.
4. Выберите поля, которые действие вернёт боту.

В условиях доступны основные и пользовательские поля сделки, а также данные связанных контакта и компании. Для каждого условия выберите оператор и значение; значение можно передать через переменную.

# Найти и обновить/создать сделку

Действие поддерживает четыре режима:

• Найти и обновить — изменить найденную сделку, но не создавать новую;
• Найти или создать — вернуть найденную сделку либо создать новую;
• Всегда создать новую — пропустить поиск;
• Найти, обновить, иначе создать — обновить найденную сделку, а при отсутствии результата создать новую.

После условий поиска настройте правила обновления полей: записывать всегда, только в пустые поля, пропускать заполненные или обновлять только переданные значения. Отдельно заполните поля, которые используются при создании сделки, и выберите данные результата для передачи боту.

В действии изменения стадии смарт-процесса дополнительно укажите, какой элемент менять: найденный условием запуска, последний активный или первый активный элемент клиента.

Пример: сохраните телефон клиента в переменную phone, затем передайте @phone в условие поиска или поле Телефон. Для смены этапа укажите в промпте событие, после которого разрешён переход, например подтверждение интереса или получение обязательных контактов.