> 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/amocrm.md).

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

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

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

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

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

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

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

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

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

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

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FkGOfIG8N5tcfBLEwumAZ%2Fimage.png?alt=media&amp;token=d70172e8-e3c9-4008-bb40-08568f09b8f6" alt=""><figcaption></figcaption></figure>

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

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FRTK9c1cdPNXYBwpHPTpg%2Fimage.png?alt=media&amp;token=86e22568-478a-4241-b362-d48b7b80a6d3" 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%2FMGNQbG3VFEjcAAT9ARvR%2Fimage.png?alt=media&amp;token=a1711b84-f11d-4be4-8ddc-a6abb25a6ca7" 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%2FS4KSiqCNPZFWUAgbaTaZ%2Fimage.png?alt=media&amp;token=c1b63058-14f7-46c8-88cb-9e02fd918a2d" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2Ff9hwcmN1tolfwiL9FFaL%2Fimage.png?alt=media&amp;token=3d6db2fa-6bdd-4baf-ac50-4eef513b55e5" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FdlhagHtAQiRPJOyP3Nf1%2Fimage.png?alt=media&amp;token=fdab5c22-fb45-4b90-bfbf-72961c0cbf38" alt=""><figcaption></figcaption></figure>

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

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

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

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

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2Fduhwg16GH1yEbxo0dwVD%2Fimage.png?alt=media&amp;token=20cb79bc-05c3-4699-8cfb-21beab55e34b" 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%2FZg8TxYDvIzpX2i9eaJez%2Fimage.png?alt=media&amp;token=abf98ec5-cdc9-41c8-bd8e-8d21c78b1908" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FjpekX0bpUywH6jfXVnHW%2Fimage.png?alt=media&amp;token=4037bfc1-7b26-4b72-8ec4-4f4b87477a95" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2Fh62NeooHvPyWPEHQi2n9%2Fimage.png?alt=media&amp;token=5257e701-2179-4aa1-9b57-6f898a7c69dc" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FsrjjTolwUr7Iyd3JxBCd%2Fimage.png?alt=media&amp;token=b6c03e6a-4086-433f-b107-e9fbe594a69c" alt=""><figcaption></figcaption></figure>

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

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

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FVbO3E3eTnn6BmXtaIKVh%2Fimage.png?alt=media&amp;token=84e58759-d6a6-48d3-a9a7-a99c1131dc57" alt=""><figcaption></figcaption></figure>

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

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

Выберите соответствующую функцию в выпадающем списке и заполните поля по аналогии с тем, как описано в разделе [Создать контакт](#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%2FCwhnePvglIj7eX46AyOb%2Fimage.png?alt=media&amp;token=b0a24fe6-8f66-4a48-a3f2-3f1abe726c62" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FSJopmZrFRLQ5cdjz6V9i%2Fimage.png?alt=media&amp;token=7eb2fc76-baa3-4411-a40a-1e0e028619ae" 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%2FZRHAvffYdkmLaO1n0CgF%2Fimage.png?alt=media&amp;token=4c851221-5a8f-406f-bb58-ba54279354ca" 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%2FIFSjcgMHwcLDFF0V8NRd%2Fimage.png?alt=media&amp;token=89c7b595-1249-4fba-b66d-bd0b5af6a03e" 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%2FTqwzkG5BM0LuiFXTuIqc%2Fimage.png?alt=media&amp;token=ede7e92e-9b53-4245-9cd2-3b2e45539419" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FSJopmZrFRLQ5cdjz6V9i%2Fimage.png?alt=media&amp;token=7eb2fc76-baa3-4411-a40a-1e0e028619ae" alt=""><figcaption></figcaption></figure>

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

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

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

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FvPfY7us2jtFcudarNpGx%2Fimage.png?alt=media&amp;token=e72bdbb3-52fb-40e6-b3ea-e0d04501c1c8" alt=""><figcaption></figcaption></figure>

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

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

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FccAdl3Nr8Sl1ssvxs8Ul%2Fimage.png?alt=media&amp;token=aa7948cf-9dfb-41f3-8fed-cf0909922b53" alt=""><figcaption></figcaption></figure>

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

В разделе "Условия срабатывания" выберите способ работы с действием. Действие может вызываться 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%2FUWXvoCV01NPJzhRSlrxq%2Fimage.png?alt=media&amp;token=ad844245-ecbd-4122-83d0-c124bda8f373" 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 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/amocrm.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 `automate deployments from our CI pipeline` 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.