# Битрикс24

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

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

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

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

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

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

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

В поле Как искать сделку выберите способ поиска.

По условиям поиска выбран по умолчанию. Добавьте условия поиска и объедините их через AND или OR. Укажите, что делать, если найдено несколько сделок или ни одной, и выберите поля результата. В условиях доступны основные и пользовательские поля сделки, а также данные связанных контакта и компании. Значение условия можно передать через переменную.

Связанная сделка с текущим разговором возвращает сделку, к которой привязан разговор Битрикс24. Условия поиска в этом режиме не используются. Бот получает ID сделки, её текущую стадию, воронку и признак закрытия, а также выбранные дополнительные поля. Закрытая сделка тоже возвращается, если разговор связан с ней.

Если у разговора нет привязки к сделке, действие завершится ошибкой. Другие сделки клиента не выбираются, следующие операции этого действия не выполняются.

Проверяйте этот режим в разговоре Битрикс24, связанном с тестовой сделкой. В тестовом чате внутри ChatRex такой привязки нет.

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

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

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

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

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

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