> 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-nastroika-deistvii.md).

# Битрикс24: настройка действий

Режим подключения Битрикс24 в статусе интеграции позволяет создавать и добавлять в сценарии работы агента действия в CRM.

Подключение Битрикс24 через раздел **Интеграции** позволяет создавать действия для работы с CRM и включать их в сценарии агента. Например, агент может создавать и изменять контакты, сделки и лиды.

{% hint style="info" %}
Эта статья описывает настройку отдельных операций через вкладку **Действия**.

Подключение ответов на сообщения клиентов и встроенные настройки канала описаны в статье [Битрикс24: подключение канала](https://docs.suvvy.ai/ru/kanaly/crm-sistemy/bitriks24).
{% endhint %}

#### Варианты использования

Интеграцию можно использовать в двух вариантах:

* **Вместе с каналом Битрикс24.** Агент получает сообщения клиентов и отвечает через CRM. Помимо встроенных настроек канала, вы можете создавать отдельные действия для работы с контактами, сделками и лидами.
* **Без подключения Битрикс24 как канала.** Агент общается с клиентами через другой канал, например [Савви Виджет](https://docs.suvvy.ai/ru/kanaly/chaty-dlya-saita/savvi-vidzhet) или [Wazzup](https://docs.suvvy.ai/ru/kanaly/omnikanalnye-platformy/wazzup), а интеграция позволяет выполнять операции в Битрикс24: создавать контакты, сделки и лиды, изменять их данные.

Во втором варианте CRM всё равно необходимо подключить через раздел **Интеграции**, но подключать её как канал общения не требуется.

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

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FP3pgR2J8A01zEfpCkvOF%2Fimage.png?alt=media&amp;token=f8a6078b-1e3a-4a87-8afb-40cd56648485" alt=""><figcaption></figcaption></figure>

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

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FmXcmUAWcFzEXE4sU73Xl%2Fimage.png?alt=media&amp;token=1481aaa3-a3a7-4edc-9f74-0a15f96bb3e4" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FF32IelFegg1MBRNIYp2C%2Fimage.png?alt=media&amp;token=755a0a18-d09b-48ce-a4e0-6b3246e6f4d0" alt=""><figcaption></figcaption></figure>

## Настройка

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

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FUUsY1jGKJDqaRJHcyNdJ%2Fimage.png?alt=media&amp;token=50fa5c66-8dbb-430b-b3cf-e8ab1c0f0975" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FYi1mGKaZwPQqBPKUSNJY%2Fimage.png?alt=media&amp;token=2613e49b-c488-46cf-b203-503c8de53a86" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FX4S5rvMZDAhOSCWHAb5V%2Fimage.png?alt=media&amp;token=fafcc064-02d4-4787-bbf2-a92f0868068f" alt=""><figcaption></figcaption></figure>

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

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

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

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

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FUrLfuiJs7jriMg13nsrI%2Fimage.png?alt=media&amp;token=4a4ef9d1-3d8e-4bf3-9689-aaf64936fa8c" alt=""><figcaption></figcaption></figure>

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

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

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FuDIMdimfPZwr7Ewv2TRI%2Fimage.png?alt=media&amp;token=2e172701-41e4-4a72-b161-90a9b01e2ba7" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FzJldrfxQCZlti28Bzdgl%2Fimage.png?alt=media&amp;token=1b3743e2-6e90-42d5-b926-7a24b7a61533" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FhTAEmd9i1gAgAVM0kaEQ%2Fimage.png?alt=media&amp;token=3f44f281-b81e-4eff-a7f0-1ca0cdbe66a5" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2Fk7ceyvLEP7Apf2M7P245%2Fimage.png?alt=media&amp;token=c5b634b7-2e30-455f-92f6-fc3ece9cac8e" alt=""><figcaption></figcaption></figure>

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

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FFngxad2f4ec7SAZzTwEv%2Fimage.png?alt=media&amp;token=ab9fa4b4-8e2e-4866-9809-dcd84b681e33" alt=""><figcaption></figcaption></figure>

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

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

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

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

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

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

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2F0OSdRXNFd4YXtrU83GjZ%2Fimage.png?alt=media&amp;token=7f8fa6e7-2842-47fe-9e44-3dd1df0d4af9" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FGZfArYFLja0SlxYFANdU%2Fimage.png?alt=media&amp;token=00ef1dc6-74e9-4083-ac08-ec689bab7580" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FhWM3uHMbhrlaORB6AGue%2Fimage.png?alt=media&amp;token=d88bf55d-6c71-4ba6-932e-9dcb5712bf2d" alt=""><figcaption></figcaption></figure>

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

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

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

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FQE0bhNnvAusaRyYawPhj%2Fimage.png?alt=media&amp;token=cc45599b-dfbb-4fc2-9003-435fd93e23b6" alt=""><figcaption></figcaption></figure>

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

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

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

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FLRAVg1UdDTyXgq31I1pN%2Fimage.png?alt=media&amp;token=7b09a711-d77e-4882-bf7a-430101163852" 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 following URL with the `ask` and `goal` query parameters:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `build a script that syncs our docs to a CMS` lets GitBook tailor the answer to that use case.

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.