> For the complete documentation index, see [llms.txt](https://docs.suvvy.ai/ru/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.suvvy.ai/ru/integracii/crm-sistemy/bitriks24.md).

# Битрикс24

Использование действий в сценариях работы агента добавляет возможность более гибко настроить взаимодействие с CRM.

## Возможности

**Подключить Битрикс24** в режиме интеграции возможно:

* когда CRM уже **подключена** полноценно к агенту
* отдельно, когда CRM к агенту полноценно **не подключена**

В **первом варианте** подключения открываются расширенные возможности управления CRM. Во **втором варианте** подключения появляется возможность выполнять действия в CRM **без прямого подключения к ней.**

Вы можете напрямую подключить агента к каналам, например, к [Савви Виджету](/ru/kanaly/chaty-dlya-saita/savvi-vidzhet.md) и создавать контакты, сделки, либо выполнять другие доступные действия в CRM.

## Подключение

1. Перейдите в раздел **"Интеграции"**, далее на вкладку **"CRM-системы"**, нажмите на **"Bitrix24"**.

<figure><img src="/files/RpUIziMOxfIUqYriodco" alt=""><figcaption></figcaption></figure>

2. Выполните подключение к Bitrix24.

Подробнее о том, как подключить Битрикс можете прочитать [здесь](/ru/kanaly/crm-sistemy/bitriks24.md).

<figure><img src="/files/biJ7E3v6c6VjBKLjS8Hl" alt=""><figcaption></figcaption></figure>

3. Интеграция успешно подключена.

<figure><img src="/files/s41zcoahghNg94NpSiXM" alt=""><figcaption></figcaption></figure>

## Настройка

### Добавление действия

1. Перейдите на вкладку **"Действия"**, нажмите **"Добавить"**.

<figure><img src="/files/z965ZTpIYWUnWMjWuXGM" alt=""><figcaption></figcaption></figure>

2.Выберите действие **"Bitrix24"**.

<figure><img src="/files/D4Km9r0t1OhRVaHB8OPj" alt=""><figcaption></figcaption></figure>

### Возможности действия

<figure><img src="/files/CEdMHvurYMeiiQH7ejYl" alt=""><figcaption></figcaption></figure>

В каждом шаге действия можно настроить только одну функцию. У Вас есть возможность создать **несколько действий** по одному шагу в каждом, либо в одном действии можно настроить **несколько шагов** с разными функциями на стороне CRM. Например, можно создать одно действие и добавить в него шаг для создания контакта, шаг создания сделки и шаг добавления сообщения в заметку. Выбор зависит от Ваших процессов и устройства агента.

**Доступные функции в amoCRM:**

1. Создать контакт.
2. Изменить контакт.
3. Создать сделку/лид.
4. Изменить сделку/лид.

### Создать контакт

Выберите в выпадающем списке вариант **"Создать контакт"**, далее необходимо задать конфигурацию. Заполните только те поля и выставьте те настройки, которые Вам требуются.

<figure><img src="/files/sLOOduWjQMWPVTdNRjSt" alt=""><figcaption></figcaption></figure>

Задайте значения для полей имени и фамилии. Если необходимо задать ответственного пользователя, то задайте id сотрудника, вы можете задать его вручную или выбрать из списка.

{% hint style="info" %}
Значения полей могут быть заданы либо статически, либо динамически. Если значение поля статическое, просто введите его в поле. Если необходимо, чтобы поле заполнялось динамически, в зависимости от контекста диалога, либо подтягивалось из какого-либо источника, то создайте переменные в действии и выберите для поля нужную переменную.
{% endhint %}

Задаем переменную на вкладке **"Переменные действия**".

<figure><img src="/files/BYfRwtUZdUsgfa1dwViY" alt=""><figcaption></figcaption></figure>

Вставляем нужную переменную в поле по нажатию шестеренки.

<figure><img src="/files/pf2jGZwSqwd7fw1XxzLT" alt=""><figcaption></figcaption></figure>

Если все выполнено **корректно**, то в поле будет отображаться **выбранная переменная** на **цветном фоне**.

<figure><img src="/files/O7hVOtYkwDoh8TwliQPd" alt=""><figcaption></figcaption></figure>

Работа со всеми полями **аналогична для всех действий на платформе Савви**.

<figure><img src="/files/wE3hwl5xfXTfRz8Weaqn" alt=""><figcaption></figcaption></figure>

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

#### Переменная для передачи значений между шагами действия

<figure><img src="/files/epGXKkHhFnbWMAnq0Fib" alt=""><figcaption></figcaption></figure>

Если у Вас в действии больше одного шага и необходима передать id контакта в следующий шаг, активируйте флаг **"Сохранить ID контакта в переменную"**, задайте имя переменной и используйте ее в следующих шагах.

### Изменить контакт

Выберите соответствующую функцию в выпадающем списке и заполните поля по аналогии с тем, как описано в разделе [Создать контакт](#sozdat-kontakt).

В данной функции поля аналогичны, добавляется только одно дополнительное поле **"ID контакта"**. Это поле можно заполнить вручную, через [переменную](#peremennaya-dlya-peredachi-znachenii-mezhdu-shagami-deistviya) одного из предыдущих шагов, либо через обычную переменную, которая задается в самом действии в разделе **"Переменные действия"**.

### Создать сделку/лид

Выберите пункт **"Создать сделку/лид"** в выпадающем списке.&#x20;

Выберите тип сущности - **"Сделка"** или **"Лид"**.

<figure><img src="/files/XeVHnedHkhVTnQhZOuC1" alt=""><figcaption></figcaption></figure>

Заполните необходимые поля, либо задайте для них переменные.

<figure><img src="/files/DD5VseDtjO25G2yTp2BP" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/RpVP9R93a8baG1I5g7re" alt=""><figcaption></figcaption></figure>

Блок "Ответственный" настраивается аналогично разделу ["Создать контакт"](#sozdat-kontakt).

### Изменить сделку/лид

Выберите в выпадающем списке пункт **"Изменить сделку/лид"**.

В самом начале выберите необходимую сущность, как в предыдущем пункте. При изменении ссылки доступно дополнительное поле **"ID сущности"**, которое Вы можете заполнить любым доступным способом, включая заполнение [переменной](#peremennaya-dlya-peredachi-znachenii-mezhdu-shagami-deistviya) из предыдущего шага действия.

<figure><img src="/files/iJK2V0vV9WstUO9TZ6xo" alt=""><figcaption></figcaption></figure>

Блок настроек воронки, статуса и ответственного аналогичен [предыдущему пункту](#sozdat-sdelku-lid).

### Задание функции действия

В разделе **"Условия срабатывания"** выберите способ работы с действием. Действие может вызываться LLM, либо вызываться по [триггеру](/ru/deistviya/vyzov-deistvii-po-triggeru.md).

Если необходим вызов LLM, то задайте имя функции и ее описание.

<figure><img src="/files/sqthb83WSRjIeOuHiKbi" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Название функции лучше задавать в соответствии с тем действием, к которому оно задается. Выбранная фраза должна по смыслу подходить к действию, которое выполняется. Такой подходу улучшает стабильность работы.
{% endhint %}

Саму функцию необходимо прописать в инструкции агента. Пример указания на вызов функции действия:

{% code overflow="wrap" %}

```
После получения имени и фамилии клиента, передай их в переменные first_name и last_name соответственно, после этого вызови функцию create_contact и передай переменные в неё.
```

{% endcode %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.suvvy.ai/ru/integracii/crm-sistemy/bitriks24.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.