# amoCRM

**amoCRM** - одна из популярнейших CRM-систем. Савви интегрирован с ней и умеет:

1. Отвечать на сообщения клиентов (канал откуда пришло сообщения значения не имеет)
2. Перемещать сделку по воронке, а конкретно менять воронки и статусы внутри нее
3. Получать информацию из полей сделки
4. Заполнять поля сделки информацией полученной из диалога клиента
5. Заполнять хештеги
6. Добавлять задачи
7. Работать с полями бюджета

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

Чтобы подключить Савви к **amoCRM** необходимо перейти в раздел **Каналы** внутри бота и зайти в канал **amoCRM**:

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

В открывшемся окне нажимаем на кнопку **Подключить:**

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

Далее произойдет редирект на страницу авторизации amoCRM, где необходимо указать учетные данные вашей amoCRM:

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

Выбираете нужный аккаунт и нажимаете **Разрешить**.

После этого, окно авторизации закроется и произойдет редирект обратно в настройки **amoCRM** на стороне личного кабинета **Савви.**

Далее выбираем аккаунт **amoCRM** и нажимаем **- Подключить из списка**.

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

### Главное

### Настройка воронок и статусов

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

На первой вкладке **Главное** можно указать в каких воронках и каких статусах бот будет отвечать, а в каких нет.

Если воронки или статусы не выбраны - он будет по умолчанию отвечать во всех.

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

### Дополнительно

В разделе **Дополнительно** можно настроить передачу **саммари** диалога и последних сообщений сотрудника боту для корректного продолжения разговора, назначение задач и режим co-pilot.

### История диалога

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

{% hint style="success" %}
При включении флага **Передавать саммари** будет включена опция передачи боту саммари истории диалога, который состоялся **ДО** момента подключения бота.

**Простыми словами** — если к нам пришло сообщение и мы создали новый диалог (при условии, что данная настройка включена) - перед первой передачей в **LLM** мы сделаем запрос в **amoCRM**, выгрузим предыдущий диалог, сделаем саммари и добавим самым первым сообщением.
{% endhint %}

*Настройка **Ограничить количество сообщений для саммари** позволяет выбрать, какое количество предыдущих сообщений будет передано боту для формирования саммари. Возможный диапазон **1-50 сообщений**. Если флаг выключен, то по умолчанию будет передано **50 сообщений**.*

### Добавление задач

1. Задача типа **"Звонок":**

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

{% hint style="success" %}
При включении переключателя, для того, чтобы бот создавал задачу в **amoCrm/Kommo**, пропишите в инструкции сценарий, когда эту задачу нужно создавать, он создаст.

В случае, если необходимо принудительно указать функцию, то используйте **название функции**: `amo_add_call_task`.
{% endhint %}

2. Задача типа **"Встреча"**:

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

{% hint style="success" %}
При включении переключателя, для того, чтобы бот создавал задачу в **amoCrm/Kommo**, пропишите в инструкции сценарий, когда эту задачу нужно создавать, он создаст.

В случае, если необходимо принудительно указать функцию, то используйте **название функции**:

`amo_add_meet_task`.
{% endhint %}

### Режим "co-pilot"

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

Режим "**co-pilot**" позволяет передавать в **amoCRM** не сообщения, а примечания. Данный режим - это своего рода режим помощника для менеджера по продажам, когда он дает для менеджера быстрые подсказки, при этом исключает вероятность ошибок при ответе конечному клиенту.

{% hint style="info" %}
Данная функция может быть полезна на начальном этапе тестирования, когда еще не все ответы бота выверены, но уже хочется посмотреть как он будет отвечать реальным клиентам.

Кроме того, она может быть полезна в сферах, где цена ошибки в ответе очень высока, и может быть использована на постоянной основе в качестве быстрого предоставления информации для менеджера.
{% endhint %}

Как этот режим **выглядит в чате амосрм:**

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

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

А вот так этот же чат **выглядит в экспорте Савви:**

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

{% hint style="info" %}
Обращаем внимание на то, что на стороне Савви сообщение бота будет зачёркнуто.
{% endhint %}

При наведении курсора на жёлтое окошко с восклицательным знаком появляется название причины, почему сообщение бота не отправлено в канал

### Добавление последних сообщений сотрудника

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

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

### Добавление задержки перед обработкой

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

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

{% hint style="info" %}
Функция применяется ко всем ботам, использующим текущее приложение.
{% endhint %}

### Заполнение сделки

Раздел **Заполнение сделки** отвечает за заполнение полей сделки.

### Заполнять ответственного

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

Эта функция позволяет заполнить поле **ответственного** в сделке.

Чтобы получить полный список доступных сотрудников, нажмите на **Список ID** справа от флага:

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

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

{% hint style="info" %}
Нажмите на строку с именем нужного сотрудника, чтобы скопировать функцию с ID (amo\_assign\_manager) и вставьте её `amo_assign_manager(12132526)` в основную инструкцию в нужное место, где необходимо изменить ответственного.
{% endhint %}

### Заполнять бюджет

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

**Разрешить боту заполнять бюджет** означает, что бот сможет заполнять поле с бюджетом сделки. При этом при включенном переключателе мы можем дополнительно описать для бота более понятным языком, что означает это поле для компании, чтоб он мог лучше ориентироваться при его заполнении.

### Функция изменения бюджета

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

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

{% hint style="warning" %}
Это поле должно содержать инструкции, касающиеся исключительно заполнения поля.

Не должно быть инструкций типа :"Спроси...", "Узнай у клиента...", "Ты должен задать вопрос...". "Вызови функцию...", и т.д.
{% endhint %}

### Заполнять карточку

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

**Разрешить боту заполнять карточку** - это еще один переключатель включающий саму функцию. Поскольку любые такие действия неизбежно увеличивают стоимость диалога, т.к. в модель передается вся информация об этих плановых действиях, по умолчанию, данный переключатель выключен.

{% hint style="info" %} <mark style="color:blue;">**Важно!**</mark>

Если вы указали поля для заполнения ботом, чтобы он понял, что нужно заполнять карточку, пропишите в общей инструкции текст следующего содержания:

`Заполняй карточку клиента по мере получения ответов от него.`
{% endhint %}

### Заполнение контакта

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

**Разрешить боту заполнять карточку контакта** - позволяют заполнять выбранные поля в карточке контакта клиента

{% hint style="info" %} <mark style="color:blue;">**Важно!**</mark>

Если вы указали поля для заполнения ботом, чтобы он понял, что нужно заполнять карточку, пропишите в общей инструкции текст следующего содержания:

`Заполняй карточку контакта по мере получения ответов от него.`
{% endhint %}

### Информация из сделки

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

Раздел **Информация из сделки** позволяет Савви знать значения выбранных полей из сделки. Это может быть полезно, когда Савви должен понимать контекст сделки и какие-то данные по ней, чтобы использовать эту информацию в контексте разговора.

### Информация из контакта

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

Раздел **Информация из контакта** позволяет Савви знать значения выбранных полей из **карточки контакта** . Это может быть полезно, когда Савви должен понимать информацию связанную с клиентом, чтобы использовать эту информацию в контексте разговора.

### Движение сделки по воронке

После подключения amoCRM и Савви внутри файлов базы знаний появляется дополнительная вкладка Действия в amoCRM:

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

В данном разделе есть три блока:

1. **Смена статуса** — здесь можно выбрать воронку и статус на который поменяется текущий статус сделки при срабатывании данного файла базы знаний.
2. **Заполнение карточки** — это возможность установить фиксированное значение конкретного поля, при срабатывании данного файла базы знаний.
3. **Установка тегов** — это возможность установить конкретный тег для сделки, при срабатывании данного файла базы знаний.
4. **Создание саммари** — это позволяет создать саммари диалога до момента срабатывания файла для того, чтобы передать это саммари в заметку к диалогу в **amoCRM**.

{% hint style="warning" %}
Из-за ограничений amoCRM, нельзя сменить статус на Неразобранные.
{% endhint %}

### Поиск по каталогу

Бот может работать с товарами в CRM. После активации работы с каталогом товаров бот сможет отвечать с учетом информации о товаре.

Для активации функции выполните следующие шаги:

1. Перейдите на вкладку "Поиск по каталогу" в настройках канала amoCRM. И активируйте флаг "Включить поиск по каталогу".

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

2. После активации флага станут доступны настройки работы с каталогами товаров. Выберите нужный Вам каталог и выставьте ограничение на максимальное количество результатов, нажмите "Сохранить".

<figure><img src="/files/3brYzDtB4rGI7gyqOCef" alt=""><figcaption></figcaption></figure>

За работу с каталогом товаров отвечает функция amo\_product\_search\_in\_catalog(). Если необходимо обращаться к товарам при определенных условиях, то укажите данную функцию в инструкции, прописав условия, при которых ее нужно вызывать. Пример:

{% code overflow="wrap" %}

```
При вопросах по нашим продуктам, доступным для самовывоза, вызови функцию amo_product_search_in_catalog().
```

{% endcode %}

### Подключение при мультиагентной схеме

Как правильно настроить работу ботов в случае использования мультиагентности в режиме [Переключение активного бота](/ru/deistviya/multiagentnost/pereklyuchenie-aktivnogo-bota.md)

*Правильное подключение выглядит следующим образом:*

* **Бот-администратор** — подключён канал, включены ответы, выключены дополнительные функции (заполнение сделки и т.п.)
* **Бот, на который переключаем** — подключён канал, выключены ответы, включены дополнительные функции


---

# 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/kanaly/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.