AmoCRM

Эта инструкция поможет настроить отправку данных из звонков в вашу CRM AmoCRM: что нужно сделать по шагам и как избежать типичных ошибок.

Что умеет интеграция

После каждого звонка система может:

Создать лид в AmoCRM с названием, именем и телефоном клиента.
Обновить существующий лид — если включён режим обновления и в AmoCRM найден контакт с привязанным лидом.
Создать контакт и привязать его к лиду.
Заполнить кастомные поля (площадь, срочность, бюджет и т.п.) — система сама «вытащит» это из разговора с помощью ИИ.
Добавить транскрипт звонка как примечание к лиду.
Прикрепить запись разговора — как примечание типа «звонок» с ссылкой на аудио.

Чтобы всё это работало, нужно один раз подключить интеграцию через OAuth и выбрать основные настройки.

Подключение: как получить данные для авторизации

AmoCRM использует OAuth2 — для подключения потребуется создать интеграцию в вашем аккаунте и получить несколько ключей.

Пошаговая инструкция

Войдите в AmoCRM под учётной записью администратора того аккаунта, в котором будет работать интеграция.
Перейдите в раздел «амоМаркет» (иконка магазина в боковом меню).
Нажмите «Создать интеграцию».
Заполните форму:
- Название интеграции — любое, например «Интеграция звонков».
- Redirect URI: https://app.salesbot.tech
- Описание — любое (обязательное поле).
- Выберите права доступа: CRM — чтение и запись.
Нажмите «Сохранить».
В открывшемся модальном окне на вкладке «Ключи» скопируйте:
- ID интеграции (Integration ID / Client ID)
- Секретный ключ (Secret Key / Client Secret)
- Долгосрочный токен (Long-lived Access Token)
- Код авторизации (Authorization Code)

Что заполнить в настройках интеграции

Поле	Описание
Base URL AmoCRM	Адрес вашего аккаунта, например `https://ваш-домен.amocrm.ru` или `https://ваш-домен.kommo.com`. Без завершающего слеша.
ID интеграции	Client ID из настроек интеграции в AmoCRM.
Секретный ключ	Client Secret из настроек интеграции.
Долгосрочный токен	Long-lived Access Token — постоянный токен, не истекает.
Код авторизации	Authorization Code — действителен только 20 минут. Вставьте сразу после копирования.
Redirect URI	Уже заполнено: `https://app.salesbot.tech`. Менять не нужно.

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

Отправка только заинтересованных диалогов

Опция «Отправлять только заинтересованные диалоги»:

Включено (по умолчанию) — в AmoCRM попадут только те звонки, по которым система пометила исход «Заинтересован». Звонки без интереса в CRM не отправляются.
Выключено — данные отправляются после каждого завершённого звонка, независимо от результата.

Для холодных обзвонов рекомендуется оставить включённым, чтобы не засорять CRM.

Создание контакта

Опция «Создавать контакт в AmoCRM»:

Включено (по умолчанию) — вместе с лидом будет создан контакт (имя, телефон) и привязан к лиду. Если контакт с таким телефоном уже существует в AmoCRM — система найдёт его и привяжет к лиду, не создавая дубликат.
Выключено — создаётся только лид, без контакта.

Шаблон названия сделки

По умолчанию название лида генерирует ИИ из транскрипта. Если нужен фиксированный формат — укажите шаблон в поле titleTemplate.

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

Переменная	Что подставляется
`{{call_id}}`	ID звонка
`{{phone}}`	Нормализованный номер телефона
`{{source}}`	Источник контакта
`{{contact_name}}`	Имя контакта (из транскрипта)

Пример:

Холодная база — {{contact_name}} — #{{call_id}}

Воронка и статус по умолчанию

Поля «ID воронки» (amo_pipeline_id) и «ID статус» (amo_status_id) задают воронку и этап, куда попадёт новый или обновляемый лид.

Если поля оставить пустыми — используются настройки AmoCRM по умолчанию.

Чтобы найти нужные ID, откройте в браузере:

https://ваш-домен.amocrm.ru/api/v4/leads/pipelines

В ответе найдите нужную воронку (id — ID воронки) и нужный этап внутри statuses (id — ID статуса).

Приоритет при записи status_id и pipeline_id: значение из поля «Кастомные поля» → статическая настройка в форме.

Кастомные поля из разговора

Система может заполнить ваши дополнительные поля в AmoCRM (площадь, срочность, бюджет и т.д.) — ИИ сам вытащит нужные данные из транскрипта.

Как узнать ID кастомного поля

Откройте в браузере:

https://ваш-домен.amocrm.ru/api/v4/leads/custom_fields

В ответе найдите ваше поле по названию (name) и возьмите его числовой id:

{
  "_embedded": {
    "custom_fields": [
      { "id": 123456, "name": "Площадь объекта" }
    ]
  }
}

Как добавить поля в интеграцию

В блоке «Кастомные поля для отправки в AmoCRM» укажите поля по правилу:

каждая строка начинается со звёздочки и пробела * ;
дальше числовой ID поля (или специальный ключ — см. ниже) и инструкция для ИИ через - (пробел, минус, пробел).

Пример:

* 123456 - Сколько метров площадь объекта или окон
* 789012 - Как срочно нужна услуга
* 345678 - Бюджет клиента в рублях

Важно:

ID полей в AmoCRM — это числа (например, 123456), а не строки как в Bitrix24.
Если звёздочку в начале строки не поставить — строка не учитывается.
Пустые значения (если ИИ не нашёл данные в разговоре) не отправляются в CRM.

Контекст звонка доступен ИИ

При заполнении кастомных полей ИИ видит не только транскрипт, но и данные о звонке: номера телефонов, статус звонка (status), исход (action_status: interested / пусто), длительность, тип звонка. Это позволяет делать условную логику прямо в поле «Кастомные поля».

Управление этапом и тегами

Помимо числовых ID кастомных полей, в блоке «Кастомные поля» можно использовать специальные ключевые слова, которые управляют этапом воронки и тегами лида. ИИ заполняет их динамически на основе итога звонка.

Специальные ключи

Ключ	Что делает	Формат значения
`status_id`	Переводит лид на нужный этап	Числовой ID этапа (или `null`)
`pipeline_id`	Меняет воронку	Числовой ID воронки (или `null`)
`tags_to_add`	Добавляет теги к лиду	Имена тегов через запятую (или `null`)
`tags_to_delete`	Снимает теги с лида	Имена тегов через запятую (или `null`)
`clear_tags`	Очищает все теги	`true` / `null`

Приоритет: значения из блока «Кастомные поля» перекрывают статические настройки «ID воронки» и «ID статуса» из формы.

Пример: смена этапа и тегов по исходу звонка

* status_id - ID статуса сделки. По исходу звонка (action_status): если interested — то 85778090, если пусто или null — то 10080262
* tags_to_add - Теги для добавления (через запятую). Обычно null.
* tags_to_delete - Теги для снятия (через запятую). Если action_status = interested — сними «ИИ_в_работе». Если был разговор, но клиент отказался — тоже сними «ИИ_в_работе». Если недозвон (busy, failed, voicemail или почти нет диалога) — null, теги не трогай.

В этом примере:

при успешном разговоре с заинтересованным клиентом лид переходит на этап 85778090 и снимается тег ИИ_в_работе;
при недозвоне (voicemail, занято, нет ответа) — ни этап, ни теги не меняются, лид остаётся там, где был.

Статические теги (без GPT)

Если нужно всегда добавлять или снимать одни и те же теги — укажите их напрямую в настройках интеграции через поля amo_tags_to_add и amo_tags_to_delete (строка с именами через запятую). Значение из блока «Кастомные поля» перекрывает статические, если задано.

Отправка аудиозаписи

Опция «Отправлять аудиозапись звонка в AmoCRM»:

Включено — к лиду будет добавлено примечание типа «звонок» со ссылкой на аудиозапись.
Выключено (по умолчанию) — запись не отправляется.

Примечание: AmoCRM API поддерживает только ссылки на аудио — загрузить файл напрямую нельзя. Запись доступна по URL, пока хранится на сервере.

Источник контакта

В поле «ID кастомного поля AmoCRM для передачи источника контакта» укажите числовой ID поля в AmoCRM, куда нужно записывать источник контакта из вашей системы (например: «Лендинг», «ВКонтакте», «Telegram»).

Если поле не заполнено — источник в AmoCRM передаваться не будет. Если у контакта источник не указан — поле в CRM останется пустым.

Режим обновления лидов

По умолчанию после каждого звонка создаётся новый лид. Если нужно обновлять существующий лид при повторных звонках одного клиента, включите режим обновления (updateMode = true).

Как это работает

Система проверяет карточку контакта: если в «Деталях контакта» есть атрибут amocrm_lead_id — обновляет именно эту сделку (PATCH).
Если сохранённого ID нет, но включено «Создавать контакт» — ищет контакт по телефону в AmoCRM, затем находит привязанный к нему лид.
Если лид найден — обновляется: поля, кастомные значения, транскрипт и запись.
Если лид не найден ни одним из способов — создаётся новый.

Для схем без дублей (например, обзвон из CRM) рекомендуется указывать amocrm_lead_id в «Деталях контакта» при добавлении контакта. Тогда обновление всегда гарантированно попадёт в нужную сделку.

Как указать amocrm_lead_id вручную

В карточке контакта в разделе «Детали контакта» нажмите + и добавьте:

Атрибут	Значение
`amocrm_lead_id`	Числовой ID сделки из AmoCRM
`amocrm_contact_id`	Числовой ID контакта из AmoCRM (опционально)

ID сделки виден в URL открытой карточки в AmoCRM:

https://ваш-домен.amocrm.ru/leads/detail/123456789
                                                ↑ amocrm_lead_id

После этого при каждом звонке этого контакта интеграция будет обновлять именно эту сделку.

Когда уместен

Повторные звонки одного клиента должны обогащать один лид.
Нужно избегать дублирования лидов от одного номера.
Контакты импортируются из AmoCRM с уже известным ID сделки.

Когда лучше выключить

Каждый звонок должен давать отдельный лид.

Проверка подключения

После заполнения всех обязательных полей и сохранения настроек нажмите кнопку «Протестировать подключение».

Система создаст в AmoCRM тестовый лид с тестовыми данными и контактом, добавит примечание. Если тест прошёл успешно — интеграция настроена верно.

Что делать, если что-то не работает

Что происходит	Что проверить
Ошибка авторизации (401)	Код авторизации (Authorization Code) мог устареть — он действителен 20 минут. Создайте новую интеграцию в AmoCRM и вставьте свежий код.
Кастомные поля не заполняются	Каждая строка в блоке кастомных полей начинается со звёздочки и пробела (`*` ). ID поля — число, а не строка. Убедитесь, что ИИ смог найти нужные данные в разговоре.
Запись звонка не появляется в лиде	Включена опция «Отправлять аудиозапись». AmoCRM сохраняет ссылку на аудио, а не файл — убедитесь, что запись доступна по URL.
При режиме обновления каждый раз создаётся новый лид	Убедитесь, что в «Деталях контакта» указан атрибут `amocrm_lead_id`. Если его нет — включите «Создавать контакт» и убедитесь, что у контакта есть телефон, а в AmoCRM к найденному контакту привязан существующий лид.
Контакт создаётся заново вместо поиска существующего	Контакт ищется по нормализованному телефону. Убедитесь, что номер в вашей системе совпадает с форматом в AmoCRM.
Этап лида не меняется	Проверьте, что в блоке «Кастомные поля» используется ключ `status_id` (не числовой ID поля), а значение — корректный числовой ID этапа из воронки.
Тег не снимается / не добавляется	Убедитесь, что в блоке «Кастомные поля» используются ключи `tags_to_add` / `tags_to_delete`, а значение — точное имя тега как в AmoCRM. При недозвоне (voicemail, нет ответа) ИИ должен вернуть `null` — не пустую строку.

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

Что умеет интеграция​

Подключение: как получить данные для авторизации​

Пошаговая инструкция​

Что заполнить в настройках интеграции​

Отправка только заинтересованных диалогов​

Создание контакта​

Шаблон названия сделки​

Воронка и статус по умолчанию​

Кастомные поля из разговора​

Как узнать ID кастомного поля​

Как добавить поля в интеграцию​

Контекст звонка доступен ИИ​

Управление этапом и тегами​

Специальные ключи​

Пример: смена этапа и тегов по исходу звонка​

Статические теги (без GPT)​

Отправка аудиозаписи​

Источник контакта​

Режим обновления лидов​

Как это работает​

Как указать amocrm_lead_id вручную​

Когда уместен​

Когда лучше выключить​

Проверка подключения​

Что делать, если что-то не работает​