# amoCRM

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

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

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

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

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

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

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

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

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

2. Выполните подключение к amoCRM.&#x20;

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

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

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

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

## Настройка

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

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

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

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

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

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

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

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

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

1. Создать контакт.
2. Изменить контакт.
3. Создать сделку.
4. Изменить сделку.
5. Отправить summary-примечание в заметки сделки.
6. Отправить сообщение в заметки сделки.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Ниже Вы можете задать теги, которые будут проставляться при выполнении действия, что весьма удобно для работы со статистикой в разедел [Аналитика](/ru/analitika/analitika-v-savvi.md).

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

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

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

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

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

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

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

При необходимости удалить теги Вы можете задать их в поле **"Список тегов для удаления"**.

<figure><img src="/files/6Y58z4k80XaRrAWLmMpJ" alt=""><figcaption></figcaption></figure>

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

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

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

Можно прикрепить контакт к сделке. Для этого активируйте флаг **"Добавить контакт"** и задайте значение для id контакта.

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

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

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

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

<figure><img src="/files/5lTaQh4oxQDwoSj7pCjv" alt=""><figcaption></figcaption></figure>

При необходимости удалить теги, выберите их в поле **"Список тегов для удаления"**.

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

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

### Отправить summary-примечание в заметки сделки

Выберите соответствующий пункт в выпадающем списке и заполните доступные поля.&#x20;

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

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

### Отправить сообщение в заметки сделки

Выберите пункт в выпадающем меню и заполните поля.

Введите id сделки, к которой будет добавлена заметка. В поле текста введите текст, который необходимо отправить в заметку, либо задайте переменную, через которую будет заполняться заметка, более подробно механизм рассмотрен в пункте ["Создать контакт"](#sozdat-kontakt).

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

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

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

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

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

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

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

{% code overflow="wrap" %}

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

{% endcode %}


---

# 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.suvvy.ai/ru/integracii/crm-sistemy/amocrm.md?ask=<question>
```

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.