# Интеграция с AmoCRM

{% hint style="warning" %}
**Внимание.** Интеграция находится на стадии бета-тестирования. Интеграция не хранит персональные данные ваших пользователей дольше, чем требуется для передачи в AmoCRM.
{% endhint %}

### Возможные кейсы использования <a href="#id-42d84e56-5be9-4bc8-aba2-f2bb9698f308" id="id-42d84e56-5be9-4bc8-aba2-f2bb9698f308"></a>

* Автоматическое создание сделки в AmoCRM при заполнении формы в боте Senler.
* Отправка служебных заметок менеджеру (телефон, источник, ответы на вопросы бота).
* Назначение ответственного, проставление тега/статуса, запись поля "Источник" (UTM) из переменных бота.

### Как работает интеграция <a href="#id-09348383-d548-49d0-9025-e5646a309f1c" id="id-09348383-d548-49d0-9025-e5646a309f1c"></a>

Интеграция добавляется **как шаг** в схему чат-бота Senler. Когда подписчик доходит до этого шага, Senler берёт значения из переменных шага и отправляет их в AmoCRM согласно выбранному набору переменных. Подключение к AmoCRM выполняется через авторизацию: администратор один раз даёт доступ "Интеграции с Senler" в интерфейсе AmoCRM и выбирает нужный аккаунт.

### Инструкция по установке и настройке <a href="#eeba9e0e-1fcf-448c-a550-be4bff1ade87" id="eeba9e0e-1fcf-448c-a550-be4bff1ade87"></a>

#### 1) Установка интеграции <a href="#id-45c07587-0810-493a-971a-9b730a9d7f5e" id="id-45c07587-0810-493a-971a-9b730a9d7f5e"></a>

Первым делом необходимо установить интеграцию "AmoCRM" в вашем личном кабинете Senler. Для этого:

1. Перейдите в раздел **Интеграции**.
2. Найдите и установите интеграцию **"AmoCRM"**.

   <figure><img src="https://3357342088-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZN10WvcXgl30afEjLBp4%2Fuploads%2FsxnIvgQv69y3ofFYU9la%2Fimage.png?alt=media&#x26;token=8dec205d-3dd2-48dc-bedf-1c24bab592a3" alt=""><figcaption></figcaption></figure>

#### 2) Подключение аккаунта AmoCRM <a href="#ca666376-3eef-4e29-8202-a3a62b05e54a" id="ca666376-3eef-4e29-8202-a3a62b05e54a"></a>

1. В открывшемся окне AmoCRM нажмите "**Получить токен Senler**"

   <figure><img src="https://3357342088-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZN10WvcXgl30afEjLBp4%2Fuploads%2FxQKLRc8ELQfHKNiEW3mj%2Fimage.png?alt=media&#x26;token=e6accfc6-36fa-43db-a43d-fe401cc426e9" alt=""><figcaption></figcaption></figure>
2. Нажмите "Подключить amoCRM"

   <figure><img src="https://3357342088-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZN10WvcXgl30afEjLBp4%2Fuploads%2FSz9sWpQityUc6U9EvkzN%2Fimage.png?alt=media&#x26;token=47c282e5-843b-4bf0-8160-a13a388557fb" alt=""><figcaption></figcaption></figure>
3. В открывшемся окне AmoCRM выберите нужный аккаунт и нажмите "**Разрешить"** для интеграции с Senler.

   <figure><img src="https://uploads.linear.app/65707cbf-bd9b-4eaf-b973-a32968fd0a8c/973a8dca-b245-4152-bb23-416daf857470/a9382ecf-b570-4eeb-af76-a2a67caacc7e" alt=""><figcaption></figcaption></figure>
4. После успешной авторизации в окне Senler появится блок **Аккаунт в amoCRM** с кнопкой **Сменить аккаунт**.<br>

   <figure><img src="https://3357342088-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZN10WvcXgl30afEjLBp4%2Fuploads%2Fe6l4lwHqXQIBTNz8Mx7J%2Fimage.png?alt=media&#x26;token=9e372bda-aa17-415e-8737-7a3a9750f1b6" alt=""><figcaption></figcaption></figure>

#### 3) Добавление шага интеграции в чат-боте <a href="#a363f6f6-4c0e-46c1-9c5e-6f9ebbc0ff06" id="a363f6f6-4c0e-46c1-9c5e-6f9ebbc0ff06"></a>

1. Откройте нужного **чат-бота** → на схеме добавьте шаг **AmoCRM**.

   <figure><img src="https://uploads.linear.app/65707cbf-bd9b-4eaf-b973-a32968fd0a8c/67586d92-473f-4674-a635-02303cb86cb1/ee2286a7-e3c2-48f0-806a-3b308fd7b589" alt=""><figcaption></figcaption></figure>

2. Нажмите на шаг и в правой панели выберите "**Настроить**".

   <figure><img src="https://uploads.linear.app/65707cbf-bd9b-4eaf-b973-a32968fd0a8c/b171aefc-9c6a-49a4-a61c-d13f1f514b18/e94f9882-135b-4abc-b3b6-e07a3fc93729" alt=""><figcaption></figcaption></figure>

3. Откроется модальное окно "AmoCRM".

   <figure><img src="https://3357342088-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZN10WvcXgl30afEjLBp4%2Fuploads%2F5dfexeqrfFBn6pzkDF1B%2Fimage.png?alt=media&#x26;token=2e2062eb-7a82-464a-999c-ef411417c2ee" alt="" width="375"><figcaption></figcaption></figure>

4. Направление передачи данных

   Выберите, в какую сторону передавать информацию:

   * **Отправка данных в amoCRM** - Senler передаёт данные в amoCRM (создание/обновление сделки и заполнение полей).
   * **Отправка данных в Senler** - данные из amoCRM передаются в Senler (если используется обратная передача).

   <figure><img src="https://3357342088-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZN10WvcXgl30afEjLBp4%2Fuploads%2Fn0sFgBJ44nfZc4v8jOzI%2Fimage.png?alt=media&#x26;token=5ecaebd7-c9af-4fcf-a014-905634ec11de" alt="" width="375"><figcaption></figcaption></figure>

5. Настройки передачи в amoCRM (Только для отправки в amoCRM)

   В этом блоке настраиваются расширенные параметры сделки, которые будут переданы в amoCRM.

   1. &#x20;**Имя сделки**

      Можно выбрать:

      * **Имя клиента** - в сделку будет подставлено имя клиента;
      * **Своё значение** - вы задаёте шаблон имени вручную.\
        Если выбрано **«Своё значение»**, можно использовать переменные Senler в формате `%...%`.\
        **Пример:**\
        `%username% сенлера амо %fullname%`

      **Доступные системные переменные:**

      * `username`

      * `fullname`

      * `userid`

      * `city`

      * `relation`

      * `country`

      * а также **все пользовательские переменные** Senler.

      > Если значение переменной отсутствует, передаётся пустое значение (**null**).
   2. **Воронка**

      Выберите воронку amoCRM, в которой будет создана/обновлена сделка.
   3. **Статус**

      Выберите этап (статус) сделки в выбранной воронке.\
      Также доступен вариант "**Не изменять"** - статус сделки не будет изменён (актуально при обновлении существующей сделки).
   4. **Ответственный**

      Назначьте ответственного пользователя amoCRM или выберите **"Не назначать"**.
   5. **Цена**

      Укажите сумму сделки (числовое значение), которая будет записана в amoCRM.

   <figure><img src="https://3357342088-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZN10WvcXgl30afEjLBp4%2Fuploads%2Fjsw0QBvV0SpIDIQBoaKT%2Fimage.png?alt=media&#x26;token=6c01fb57-27cd-4c88-b7ea-8fff5649a51e" alt="" width="375"><figcaption></figcaption></figure>

6. Нажмите "**Добавить**" у поля "Передача значений".

7. У вас появилось два поля с возможностью выбора переменных:

   <figure><img src="https://3357342088-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZN10WvcXgl30afEjLBp4%2Fuploads%2FhCplGcZeXFbvrfC68eHu%2Fimage.png?alt=media&#x26;token=bfd55b04-1bcf-4830-86f3-480750025d94" alt="" width="375"><figcaption></figcaption></figure>

8. В первом поле выберите значение, которое хотите отправлять:
   1. **В переменную amoCRM** - выберите поле amoCRM, куда записывать значение (например, `utm_source`, `roistat` или пользовательское поле).

      <figure><img src="https://3357342088-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZN10WvcXgl30afEjLBp4%2Fuploads%2FQkTluxH6tk5PgrytfGMP%2Fimage.png?alt=media&#x26;token=6b5c1b4d-efd0-4441-bc43-6c82434112f1" alt="" width="375"><figcaption></figcaption></figure>
   2. **Из Senler** - укажите текст или переменную Senler (поддерживается формат `%...%`).

> **Важно.** Обратное действие **из amoCRM в Senler** работает **только** для тех лидов/сделок, которые были **созданы интеграцией Senler → amoCRM**.

<figure><img src="https://3357342088-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZN10WvcXgl30afEjLBp4%2Fuploads%2F34OkGl7JDmuRtMQM4Mu4%2Fimage.png?alt=media&#x26;token=b014dc6e-6abf-41cd-ae8a-d66dd598d79b" alt="" width="375"><figcaption></figcaption></figure>

{% hint style="info" %}
**Ограничение:** максимальная длина значения в поле **«Из Senler»** - **2000 символов**.
{% endhint %}

**Пример:**

* В переменную amoCRM: `utm_source`\
  Из Senler: `%utm_source%`

9. Во втором поле вы можете указать текст и множество переменных соединив их, исходя из ваших задач.
10. Для добавления переменной в текст нажмите кнопку "**Добавления**" "**+**" - В открывшемся окне из списка выберите нужную переменную и нажмите "**Вставить**" - Нажмите "**Сохранить**"

    <figure><img src="https://uploads.linear.app/65707cbf-bd9b-4eaf-b973-a32968fd0a8c/7e3964a6-7451-45fe-873e-d9ea06bedbe0/b5d880c5-de03-47d4-9668-dfa64ea2b1c6" alt="" width="375"><figcaption></figcaption></figure>
11. Максимальное количество символов в одной переменной 2000, это ограничение AmoCRM, если символов в значении переменной окажется больше - значение обрежется до 2000<br>

    <figure><img src="https://3357342088-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZN10WvcXgl30afEjLBp4%2Fuploads%2FHdYjzuF47M71DMACF20V%2Fimage.png?alt=media&#x26;token=d53d58f1-5817-4b2c-9bdc-86c32ddaaa92" alt="" width="375"><figcaption></figcaption></figure>

{% hint style="info" %}
⚠️  Важная информация по сопоставлению полей и доступным типам данных переменных: На данный момент в интеграции Senler с AmoCRM реализована передача данных переменных для полей со следующими типами:

* Числовые поля: Поля Senler, содержащие числовые значения (например, баллы, сумма заказа), могут быть сопоставлены с числовыми полями в AmoCRM.
* Текстовые (строковые) поля: Поля Senler, содержащие текстовые данные (например, имя, комментарий, UTM-метки), могут быть сопоставлены с текстовыми или строковыми полями в AmoCRM.
  {% endhint %}

#### 4) Шаблон настроек <a href="#a95cc8fa-7d3a-4def-adcd-2ed1eafd5c26" id="a95cc8fa-7d3a-4def-adcd-2ed1eafd5c26"></a>

**Что это:** сохранённый набор переменных для шага интеграции. Создаётся в одном чат-боте канала и может повторно использоваться в других ботах этого же канала.

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

1. В модальном окне интеграции найдите блок **Шаблон настроек**.
2. Нажмите кнопку "**+ Добавить**"

#### Как выбрать, переименовать или удалить шаблон <a href="#a344ca7c-6915-4317-995c-a86d50aeae82" id="a344ca7c-6915-4317-995c-a86d50aeae82"></a>

1. Кликните по полю "**Выберите шаблон"** — раскроется список доступных шаблонов.
2. Выберите нужный шаблон, чтобы применить его к шагу.
3. Для управления шаблоном "Переименовать" "Удалить" используйте иконки действий рядом с его названием в выпадающем списке.

<figure><img src="https://3357342088-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZN10WvcXgl30afEjLBp4%2Fuploads%2FpyJaDHoHccgpMkybKlRR%2Fimage.png?alt=media&#x26;token=625c1e65-e06d-420f-a66f-0ba4494ea01a" alt="" width="375"><figcaption></figcaption></figure>

> Примечание: шаблоны доступны только в пределах текущего канала и видны во всех чат-ботах этого канала.

#### 5) Тестирование <a href="#b9a5db5c-5cf3-4224-a216-ba730b88b785" id="b9a5db5c-5cf3-4224-a216-ba730b88b785"></a>

* Пройдите сценарий бота сами: введите тестовые данные → проверьте, что в AmoCRM появилась сделка и заполнены нужные поля.
* При необходимости отредактируйте шаблон и формат подстановок переменных.

#### 6) Удаление интеграции

Чтобы удалить интеграцию **AmoCRM**:

1. Откройте раздел **Интеграции** и выберите карточку **AmoCRM**.
2. В открывшемся окне нажмите кнопку "**Действия"** (в правом верхнем углу модального окна).
3. В выпадающем списке выберите "**Удалить"**.
4. Подтвердите действие в появившемся диалоговом окне.

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

### Пример использования <a href="#id-6426bf4d-1104-415c-b656-313d82ad4c41" id="id-6426bf4d-1104-415c-b656-313d82ad4c41"></a>

1. Воронка "Онлайн-заявки", начальный статус "Новая".
2. В боте после шага с формой (Имя + Телефон) — шаг **AmoCRM** с выбранным шаблоном.
3. В заметку сделки выводим: *Имя, Телефон, Ссылка на профиль/диалог, Ответы на вопросы, UTM.*
4. Менеджеру прилетает готовая сделка — остаётся только позвонить.

### Результат <a href="#a688e14a-355b-49c6-97fc-31eb27622ad5" id="a688e14a-355b-49c6-97fc-31eb27622ad5"></a>

После прохождения пользователем шага интеграции в AmoCRM автоматически создаётся/обновляется сделка, а в примечании фиксируются ответы из бота.

### Ошибки <a href="#id-387cdc65-d73f-4e39-b382-9c6c704701bf" id="id-387cdc65-d73f-4e39-b382-9c6c704701bf"></a>

#### 1. Ожидание обработки <a href="#id-64f0280f-e4b8-4054-b238-7b1e49abe10a" id="id-64f0280f-e4b8-4054-b238-7b1e49abe10a"></a>

После запуска интеграции данные **обрабатываются до 24 часов**.

#### 2. Как перезапустить обработку неудавшихся записей <a href="#id-1b2cb54b-48b8-43d9-93ca-1cec70d3b24f" id="id-1b2cb54b-48b8-43d9-93ca-1cec70d3b24f"></a>

1. Откройте нужного чат-бота.
2. Перейдите к шагу **Интеграция → Статистика**.
3. Нажмите **Повторить** (перезапуск произойдёт только для записей, упавших в ошибку они снова пойдут на обработку 24 часов).

#### 3. Ошибка "Переполнены лимиты" <a href="#b1ab94a2-aa64-4883-b3e0-0d915a58d17b" id="b1ab94a2-aa64-4883-b3e0-0d915a58d17b"></a>

**Что значит:**\
в вашем аккаунте АmoCRM количество **открытых сделок** превысило лимит.

**Почему возникает:**\
в АmoCRM лимит считается **на пользователя** *(например: 1 пользователь = 500 открытых сделок)*. Когда лимит исчерпан, новые сделки создать нельзя — интеграция возвращает ошибку.

#### Как исправить (выберите вариант) <a href="#id-6f4abd98-5b33-4c5b-9d1a-63b67a7bdda5" id="id-6f4abd98-5b33-4c5b-9d1a-63b67a7bdda5"></a>

**a. Закройте или удалите часть сделок**, чтобы освободить место.

* Если были созданы “пустые” сделки **без переменных**, и они приводят к переполнению — удалите их.
* После этого интеграция **попробует создать их повторно** при следующем прогоне.

**b. Увеличьте лимит в АmoCRM**\
(расширьте тариф / докупите слоты), чтобы поднять допустимое количество открытых сделок.\
Подробнее о лимитах АmoCRM можно посмотреть **здесь**.

**c. Повысить лимит запросов в секунду**\
Для одной интеграции действует ограничение **до 7 запросов/сек**.\
Если ваш лимит выше, необходимо написать обращение в техническую поддержку для его увеличения.

#### 4. Если вы удалили API-ключ <a href="#id-1e3cda4a-2ba5-4dbd-86c4-34b4ca42c14c" id="id-1e3cda4a-2ba5-4dbd-86c4-34b4ca42c14c"></a>

1. **Создайте новый API-ключ** в вашем аккаунте.
2. **Свяжитесь с технической поддержкой** и укажите новый ключ.
3. Мы **добавим ключ в интеграцию** и подтвердим, когда всё снова заработает.

> ⚠️ Без добавления нового ключа в интеграцию запросы будут отклоняться.

### Примечания

* Создать сделку или вернуть сделку в **«Неразобранное»** нельзя.
* Если этап (статус) сделки не выбран, по умолчанию сделка создаётся в статусе **«Первичный контакт»**.