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

Интеграция с amoCRM связывает вашего AI-консультанта с вашей воронкой: переписки клиентов попадают в сделки, новые заявки превращаются в лиды, а контакты синхронизируются автоматически. Подключение занимает пару минут и не требует навыков программирования.

Что даёт интеграция

После подключения amoCRM платформа начинает:

• Передавать лиды в воронку. Обращения из Telegram, MAX и VK создают сделки и контакты в вашей amoCRM.
• Зеркалировать переписку. Сообщения клиента и ответы AI отображаются прямо в карточке сделки (через Chats API amoCRM).
• Синхронизировать контакты. Телефоны, email и другие поля подтягиваются и сопоставляются с полями формы.
• Автоматически вести воронку. Сделки можно перемещать по этапам и помечать тегами при контакте с ботом (настраивается отдельно, в редакторе форм).
• Поддерживать связь «бот ↔ менеджер». Если менеджер берёт диалог на себя, AI замолкает — и наоборот.

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

Что понадобится

1. Доступ к вашему аккаунту amoCRM с правами администратора (чтобы подтвердить установку интеграции).
2. Домен amoCRM — это адрес вашего кабинета. Например, если вы заходите по адресу myschool.amocrm.ru, то домен — myschool.

Платформа поддерживает три варианта доменов amoCRM:

По умолчанию платформа подставляет .amocrm.ru. Если у вас .amocrm.com или .kommo.com, введите домен полностью (вместе с окончанием).

Где находится подключение

1. Войдите в личный кабинет AlgoAgent.
2. Откройте Настройки (Settings) в левом меню.
3. Перейдите на вкладку AmoCRM.

Вы увидите пошаговый мастер подключения и индикатор прогресса из двух шагов: «Интеграция» и «Форма заявки».

[скриншот: вкладка AmoCRM в Настройках с мастером подключения и шагами «Интеграция» / «Форма заявки»]

Способ 1. Быстрое подключение через окно amoCRM (рекомендуется)

Это основной и самый простой способ. Платформа сама обменяется ключами с amoCRM — вам нужно только подтвердить доступ.

1. На вкладке AmoCRM, на шаге 1, введите домен вашего amoCRM в поле ввода. Введите только название кабинета (часть до .amocrm.ru) — окончание .amocrm.ru уже подписано рядом с полем.

   [скриншот: поле ввода домена с подписью «.amocrm.ru» и кнопкой «Подключить»]

2. Нажмите кнопку «Подключить [ваш домен].amocrm.ru».

3. Откроется всплывающее окно amoCRM, где нужно войти в свой аккаунт (если ещё не вошли) и подтвердить доступ для интеграции AlgoAgent.

   Если браузер заблокировал всплывающее окно, платформа автоматически откроет страницу подтверждения в текущей вкладке — просто продолжите там.

   [скриншот: окно amoCRM с запросом подтверждения доступа интеграции]

4. После подтверждения окно закроется само, а на вкладке появится сообщение «AmoCRM успешно подключён!». Токены доступа настроятся автоматически — вручную ничего вводить не нужно.

   [скриншот: карточка подключённой интеграции со статусом «Активна»]

Готово. Шаг «Интеграция» в индикаторе прогресса станет зелёным.

Какие доступы запрашиваются

При подтверждении amoCRM попросит выдать интеграции доступ к данным аккаунта. Платформе нужен полный доступ — это необходимо, чтобы создавать и читать сделки и контакты, вести переписку в карточке сделки и подписываться на события воронки. Без полного доступа часть функций (например, зеркалирование чата и автоматизация воронки) работать не будет.

Способ 2. Подключение вручную через долгосрочный токен

Этот способ пригодится, если по каким-то причинам не удаётся подключиться через окно подтверждения. Вы создаёте интеграцию в amoCRM сами и вставляете в AlgoAgent её долгосрочный токен.

На шаге 1 мастера нажмите ссылку «Подключить вручную через долгосрочный токен →» внизу — откроются шаги 2 и 3.

Шаг 2 — создайте интеграцию в amoCRM:

1. Нажмите кнопку «Открыть [домен].amocrm.ru → amoMarket» (откроется amoMarket вашего amoCRM).
2. В amoMarket нажмите три точки ⋯ в правом верхнем углу.
3. Выберите «Создать интеграцию» → «Внешняя интеграция».
4. Введите название: AlgoAgent.
5. В разделе доступов отметьте «Предоставить доступ: Все».
6. В поле «Redirect URI» вставьте адрес, который показан в мастере (рядом есть кнопка копирования). Он выглядит так: https://<адрес-платформы>/api/v1/integrations/amocrm/callback
7. Нажмите «Сохранить».
8. Скопируйте «Долгосрочный токен» из раздела авторизации интеграции.

[скриншот: инструкция шага 2 со списком действий и полем Redirect URI с кнопкой копирования]

Шаг 3 — вставьте токен:

1. Нажмите «У меня есть токен — ввести вручную».
2. Проверьте, что домен указан верно (он показан над полем).
3. Вставьте скопированный долгосрочный токен в поле «Долгосрочный токен».
4. Нажмите «Подключить AmoCRM».

Платформа сделает тестовый запрос к amoCRM, чтобы убедиться, что токен рабочий. Если всё в порядке — появится сообщение об успешном подключении.

[скриншот: шаг 3 с полем для долгосрочного токена и кнопкой «Подключить AmoCRM»]

Что появляется после подключения

В карточке подключённой интеграции вы увидите:

• Статус — цветной бейдж: «Активна» (зелёный), «На паузе», «Токен истёк» или «Ошибка».
• Домен и дату подключения.
• Выбор Telegram-бота — какой бот обслуживает эту интеграцию (по умолчанию «Автовыбор — первый активный»).
• Webhook URL — служебный адрес с кнопкой копирования. Обычно его трогать не нужно; он используется при ручной настройке Digital Pipeline в amoCRM.
• Кнопки управления — отключить, переподключить или удалить интеграцию.

[скриншот: развёрнутая карточка интеграции с Telegram-ботом, Webhook URL и статусом]

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

Можно ли подключить несколько аккаунтов amoCRM

Одновременно активной может быть одна интеграция amoCRM. Если попробовать подключить второй аккаунт, пока активен первый, платформа сообщит, что интеграция уже подключена. Чтобы сменить аккаунт — сначала отключите текущий.

Частые вопросы и проблемы

«Платформенные ключи amoCRM не настроены» Это сообщение означает, что на стороне платформы не заданы ключи для подключения через окно. Обратитесь к вашему менеджеру или администратору AlgoAgent — либо воспользуйтесь подключением вручную через долгосрочный токен (Способ 2).

Окно amoCRM не открывается Скорее всего, браузер заблокировал всплывающие окна. Платформа в этом случае откроет страницу подтверждения в текущей вкладке — продолжите там. Также можно разрешить всплывающие окна для сайта платформы и повторить попытку.

Статус «Токен истёк» В обычном режиме платформа автоматически обновляет токен доступа каждые несколько часов, так что это происходит редко — как правило, после длительного простоя интеграции (около трёх месяцев без использования). Нажмите «Переподключить» вверху карточки и заново подтвердите доступ в окне amoCRM. При переподключении того же аккаунта все привязки сделок и контактов сохраняются.

Ошибка при вводе домена Проверьте, что вводите именно название кабинета (например, myschool), а не полный URL со слешами. Для .amocrm.com или .kommo.com укажите домен с полным окончанием.

Следующий шаг

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

[скриншот: блок «2. Форма заявки» с кнопкой «Управление формами»]