Эта статья — про вторую половину интеграции с amoCRM: беседы (Chats API, она же «amojo»). Если первая интеграция (OAuth) отвечает за передачу лидов и сделок, то беседы отвечают за то, чтобы вся переписка клиента с ботом попадала прямо в карточку amoCRM, а ответ менеджера из amoCRM возвращался клиенту в его мессенджер.
Здесь нет «магии»: каждый бот регистрируется в amoCRM как отдельный источник, и платформа сама следит, чтобы эти источники не разъезжались. Разберём по шагам.
Что такое «беседы amoCRM» и зачем это нужно
Представьте: клиент пишет вашему Telegram-боту, бот его консультирует, а менеджер при этом видит весь диалог в привычной карточке сделки amoCRM — и может вмешаться прямо оттуда. Его сообщение тут же уходит клиенту в Telegram. Вот это и есть беседы.
Под капотом работают три связанных механизма:
| Механизм | Что делает | Когда срабатывает |
|---|---|---|
| Канал бесед (amojo) | Один общий «провод» между вашим аккаунтом amoCRM и платформой | Подключается один раз |
| Источники | Каждый бот (Telegram / MAX / WhatsApp / Avito / VK) = отдельный «Источник» в amoCRM | Создаются и синхронизируются |
| Зеркалирование | Сообщения летают в обе стороны: клиент → amoCRM и менеджер → клиент | Автоматически, на каждое сообщение |
Важно: канал бесед работает поверх обычной интеграции amoCRM (OAuth). Сначала должна быть подключена основная интеграция amoCRM — без активного OAuth-подключения беседы не включатся. Если вы ещё не подключили amoCRM, начните со статьи про OAuth-подключение.
[скриншот: схема — мессенджер ↔ платформа ↔ карточка amoCRM]
Шаг 1. Подключение канала бесед (amojo)
Канал бесед подключается из вашего кабинета amoCRM, а не из дашборда платформы. Это сделано специально: только сам amoCRM знает технический идентификатор вашего аккаунта (amojo_id), и виджет AlgoAgent внутри amoCRM считывает его автоматически.
Как это происходит:
- Вы заходите в свой кабинет amoCRM, в раздел с виджетом / интеграцией AlgoAgent.
- Нажимаете кнопку подключения канала бесед. Виджет сам берёт
amojo_idвашего аккаунта — вручную ничего вводить не нужно. - Платформа подписывает запрос защищённой подписью и устанавливает соединение с серверами бесед amoCRM (amojo).
- В ответ приходит технический ключ канала (
scope_id), который платформа сохраняет у себя. С этого момента канал в статусе «Подключён» (connected).
[скриншот: виджет AlgoAgent в кабинете amoCRM с кнопкой подключения канала бесед]
Несколько важных свойств этого шага:
- Один канал на один аккаунт amoCRM. У партнёра может быть только один активный канал бесед на один аккаунт amoCRM.
- Повторное нажатие безопасно. Если канал уже подключён к тому же аккаунту, повторное подключение ничего не сломает — платформа просто вернёт существующий канал и заодно перепроверит источники (см. шаг 3). Это удобный способ «починить» рассинхрон.
- Переподключение OAuth не рвёт беседы. Если вы заново прошли OAuth-авторизацию amoCRM, платформа узнаёт ваш канал бесед по
amojo_idи аккуратно «перецепляет» его на новое подключение — переподключать беседы заново не требуется.
Возможные сообщения об ошибке
| Сообщение | Что значит | Что делать |
|---|---|---|
| «Нет активной интеграции AmoCRM. Сначала подключите AmoCRM (OAuth)…» | Не подключена основная интеграция amoCRM | Сначала подключите amoCRM по OAuth |
| «Подключение канала чатов уже выполняется…» | Два запроса на подключение пришли одновременно | Подождите пару секунд и повторите |
| «Канал чатов уже подключён к другому amojo-аккаунту…» | Канал привязан к другому аккаунту amoCRM | Сначала отключите канал, затем подключите заново |
| «Этот аккаунт amoCRM уже подключён к каналу AlgoAgent под другим партнёрским аккаунтом…» | Тот же аккаунт amoCRM уже используется в другом кабинете платформы | Отключите канал в той интеграции и подключите здесь |
Шаг 2. Что такое «источник» и как он связан с ботом
После подключения канала каждый ваш бот должен стать отдельным источником в amoCRM (раздел Настройки → Источники в amoCRM). Именно источник позволяет amoCRM понимать, через какой конкретно бот пришёл клиент, и правильно раскладывать переписку.
Платформа создаёт источники автоматически. Имя источника собирается по формату «Тип: название», например:
Telegram: Школа — основной TGMAX: bot_42
Здесь «название» — это display_name канала (то, что вы задали при подключении бота), а «Тип» — мессенджер. Имя обрезается до 50 символов, чтобы влезть в amoCRM.
Где это видно в дашборде
Откройте в дашборде раздел Каналы мессенджеров (Каналы). Каждый бот — это карточка. Под основными полями карточки платформа показывает статус источника amoCRM:
| Статус в карточке | Что значит |
|---|---|
| amoCRM: источник подключён (зелёный) | Бот зарегистрирован как источник, всё работает |
| amoCRM: ожидает синхронизации (жёлтый, крутится) | Бот ещё не зарегистрирован — нужна синхронизация |
| amoCRM: ошибка регистрации источника (красный) | Регистрация не удалась — под статусом покажется текст ошибки |
[скриншот: карточка канала в разделе «Каналы мессенджеров» с зелёным статусом «amoCRM: источник подключён»]
В карточке также видны технические поля, по которым можно свериться с amoCRM:
- ID в мессенджере (
external_id) — идентификатор бота на стороне мессенджера. - ID в amoCRM (
source_external_id) — технический идентификатор канала; приходит в каждом webhook от amoCRM и используется для обратной маршрутизации ответа менеджера нужному клиенту. - amoCRM source.id — внутренний номер источника в amoCRM (появляется после успешной регистрации).
Когда бот добавлен ПОСЛЕ подключения канала. Если вы подключили новый бот уже после того, как канал бесед был подключён, источник для него обычно регистрируется автоматически. Но если он почему-то завис в статусе «ожидает синхронизации» — поможет ручная синхронизация (следующий шаг).
Шаг 3. Синхронизация источников
Синхронизация — это «привести в порядок всё разом»: платформа сверяет список ваших ботов со списком источников в amoCRM и устраняет расхождения.
Как запустить
На странице Каналы мессенджеров, в правом верхнем углу, появляется кнопка «Синхронизировать источники» — но только если у вас уже есть хотя бы один бот со статусом источника. Рядом с кнопкой может гореть жёлтый счётчик — это количество ботов, которые ещё не синхронизированы или с ошибкой.
[скриншот: шапка раздела «Каналы» с кнопкой «Синхронизировать источники» и жёлтым счётчиком]
Нажмите кнопку. Платформа выполнит полную сверку:
- Соберёт все активные боты (со статусом «Активен» или «На паузе»).
- Запросит у amoCRM список существующих источников.
- Для каждого бота:
- если источник уже есть в amoCRM — привяжет его (восстановит связь, если она потерялась);
- если источника нет — создаст его.
- Удалит «осиротевшие» источники в amoCRM — те, что остались от удалённых или переименованных ботов и больше не соответствуют ни одному активному боту.
После завершения вы увидите всплывающее уведомление с итогом, например: «Источники amoCRM синхронизированы: 3 зарегистрировано, 1 удалено». Карточки обновятся, статусы поменяются на зелёные.
Когда синхронизация полезна
- Бот завис в статусе «ожидает синхронизации».
- Источник показывает «ошибка регистрации» — синхронизация повторит попытку.
- Вы переименовали или удалили бота и хотите навести порядок в источниках amoCRM.
- После переподключения канала на всякий случай.
Если синхронизация не находит OAuth-подключения (основная интеграция amoCRM отключена), управлять источниками платформа не сможет — сначала восстановите OAuth-подключение amoCRM.
Шаг 4. Зеркалирование: переписка клиента → amoCRM
Когда канал подключён и источник зарегистрирован, каждое входящее сообщение клиента автоматически зеркалируется в amoCRM.
Что происходит за кулисами при сообщении клиента боту:
- Платформа находит ваш бот и подключённый канал бесед.
- Отправляет сообщение клиента в amoCRM через канал бесед.
- В amoCRM появляется карточка нового клиентского сообщения — в разделе «Неразобранное» или сразу в нужной сделке (зависит от настроек воронки в amoCRM).
- Вместе с сообщением передаются доступные данные клиента: имя, аватар, ссылка на профиль (username), а если известны — телефон и e-mail. Это помогает amoCRM не плодить дубли, а привязать сообщение к уже существующему контакту.
[скриншот: карточка нового сообщения в разделе «Неразобранное» amoCRM]
Дополнительно платформа ставит на сделку тег с названием канала (например, отметку, что клиент пришёл из Telegram-бота) — чтобы менеджер с первого взгляда понимал, откуда клиент.
На этом этапе зеркалируется текст. Картинки, голосовые и файлы в текущей версии в amoCRM по этому каналу не передаются.
Шаг 5. Ответ менеджера → клиент (и пауза AI)
Обратное направление — самое интересное для продаж. Когда менеджер пишет ответ прямо из карточки amoCRM, платформа доставляет это сообщение клиенту в его мессенджер.
Что при этом происходит автоматически:
- amoCRM присылает платформе ответ менеджера (через защищённый webhook).
- Платформа определяет, какому клиенту и в какой бот доставить ответ, и отправляет его.
- Диалог переводится в режим «передан менеджеру» (handoff). Это значит, что AI-бот перестаёт отвечать сам — чтобы не «говорить поверх» живого менеджера.
- На сделку в amoCRM ставится тег
stop_ai— публичный флаг того, что AI поставлен на паузу. Тег виден в карточке сделки и в фильтрах списков.
[скриншот: карточка сделки в amoCRM с тегом stop_ai]
Как снова включить AI
Поскольку stop_ai — это обычный тег amoCRM, чтобы вернуть AI-ответы, достаточно убрать этот тег со сделки прямо в amoCRM. Платформа это увидит и возобновит работу бота. Никаких дополнительных кнопок в дашборде нажимать не нужно.
Если менеджер пишет из другой сделки (например, контакт связан сразу с несколькими сделками), платформа аккуратно «перецепляет» диалог на ту сделку, из которой реально пришёл ответ. Это важно, чтобы снятие тега
stop_aiсрабатывало именно там, где вы его сняли.
Шаг 6. Отключение канала и источников
Канал бесед отключается так же, из кабинета amoCRM — кнопкой отключения в виджете AlgoAgent. После отключения:
- Канал переходит в статус «Отключён» (disconnected).
- amoCRM каскадно удаляет все дочерние источники, а платформа сбрасывает статусы источников у ботов на нейтральные (бейджи «источник подключён» в карточках пропадают).
- Зеркалирование переписки и доставка ответов менеджера прекращаются.
Чтобы всё вернуть — подключите канал заново тем же amojo_id (см. шаг 1). При повторном подключении источники зарегистрируются автоматически.
Не путайте с отключением бота. В разделе «Каналы мессенджеров» кнопки «Отключить» и «Удалить навсегда» относятся к самому боту-каналу на платформе, а не к каналу бесед amoCRM. Отключение канала бесед делается из amoCRM.
Частые вопросы
Бот отвечает клиенту, но в amoCRM ничего не появляется. Скорее всего, не зарегистрирован источник. Проверьте статус в карточке канала и нажмите «Синхронизировать источники». Также убедитесь, что канал бесед подключён (статус «Подключён»), а основная интеграция amoCRM активна.
В карточке канала — «amoCRM: ошибка регистрации источника». Под статусом будет текст ошибки. Чаще всего помогает повторная синхронизация. Если ошибка повторяется — проверьте, что OAuth-интеграция amoCRM активна и не истёк токен.
Я снял тег stop_ai, но бот всё ещё молчит.
Убедитесь, что сняли тег именно с той сделки, из которой менеджер писал клиенту (платформа привязывает паузу к актуальной сделке). Если сделок несколько — проверьте каждую.
Можно ли подключить несколько мессенджеров к одному amoCRM? Да. Канал бесед — один на аккаунт amoCRM, но через него работает сколько угодно ботов (Telegram + WhatsApp + MAX и т.д.) — каждый как отдельный источник.
[скриншот: общий вид раздела «Каналы мессенджеров» с несколькими каналами и зелёными статусами источников]