Эта статья объясняет, как ваш бот связывается с amoCRM, чтобы переписка из мессенджера попадала в карточки сделок, а ответы менеджеров возвращались клиенту в тот же мессенджер. Если коротко: бот — это приёмник сообщений, а источник (source) — это «розетка» на стороне amoCRM, в которую этот бот включён.
Что такое канал и источник
В разделе «Каналы мессенджеров» (дашборд → «Каналы») каждая карточка — это один канал: привязка конкретного бота или аккаунта к платформе. Например: «Школа — основной Telegram», «Иван — личный WhatsApp». Через эту привязку ответы менеджеров из amoCRM уходят обратно клиенту в его мессенджере.
У одного партнёра может быть несколько каналов сразу — скажем, Telegram-бот плюс WhatsApp Business. Все они показаны карточками на одной странице.
[скриншот: страница «Каналы мессенджеров» с несколькими карточками каналов и сводкой Всего / Активные / Отключённые / С ошибками]
Чтобы amoCRM понимала, из какого именно канала пришло сообщение и куда вернуть ответ, каждый бот регистрируется в amoCRM как отдельный источник (в интерфейсе amoCRM — «Настройки → Источники»). Источник — это «представительство» вашего бота внутри amoCRM.
Два идентификатора в карточке канала
В каждой карточке канала есть блок с техническими полями. Два из них важны для связи с amoCRM:
| Поле в карточке | Что это | Зачем |
|---|---|---|
ID в мессенджере (external_id) | Идентификатор бота/аккаунта на стороне мессенджера (например, ID Telegram-бота) | Чтобы понять, какой бот получил входящее сообщение |
ID в amoCRM (source_external_id) | Технический идентификатор канала, который вы задали при подключении | Приходит в каждом webhook от amoCRM и используется для обратной маршрутизации — чтобы ответ менеджера ушёл именно тому клиенту |
| amoCRM source.id | Внутренний номер источника, который выдала сама amoCRM после регистрации | Появляется автоматически, когда источник зарегистрирован. Менять не нужно |
ID в amoCRM (source_external_id) — это ключевое поле. Это короткая строка из латинских букв, цифр и дефисов (до 40 символов). При подключении канала платформа предлагает её автоматически из названия (например, «Школа — основной TG» → shkola-osnovnoy-tg), но вы можете задать свою. Главное правило: она должна быть уникальной среди ваших каналов — два канала с одинаковым ID создать нельзя.
[скриншот: карточка канала с раскрытым блоком ID в мессенджере / ID в amoCRM / amoCRM source.id]
Совет: не редактируйте
source_external_id«просто так» после подключения. Именно по нему amoCRM находит нужный канал в каждом сообщении.
Статусы канала
В правом верхнем углу каждой карточки — бейдж со статусом самого канала (не путать со статусом источника amoCRM, о нём ниже):
| Статус | Что значит |
|---|---|
| Активен | Канал работает, сообщения ходят в обе стороны |
| Приостановлен | Канал создан, но временно не принимает/не отправляет (например, ждёт подтверждения подключения) |
| Отключён | Вы отключили канал кнопкой «Отключить». Его можно восстановить повторным подключением |
| Ошибка | Последняя отправка не удалась — текст ошибки показан в карточке |
| Заблокирован | Аккаунт заблокирован на стороне мессенджера |
Сверху страницы есть сводка: Всего, Активные, Отключённые, С ошибками — удобно быстро увидеть, всё ли в порядке.
Статус источника amoCRM
Отдельно от статуса канала под полями показывается статус регистрации источника в amoCRM. Он появляется только если у вас подключён канал amoCRM Chats. Возможны три состояния:
| Иконка | Подпись в карточке | Что значит | Что делать |
|---|---|---|---|
| Жёлтый крутящийся индикатор | amoCRM: ожидает синхронизации | Бот ещё не зарегистрирован как источник в amoCRM (или ждёт регистрации) | Нажмите «Синхронизировать источники» |
| Зелёная галочка | amoCRM: источник подключён | Источник создан и работает | Ничего, всё хорошо |
| Красный крестик | amoCRM: ошибка регистрации источника | Не удалось зарегистрировать источник; под бейджем показан текст ошибки | Проверьте подключение amoCRM и нажмите «Синхронизировать источники» |
[скриншот: карточка канала с жёлтым бейджем «amoCRM: ожидает синхронизации»]
[скриншот: карточка канала с зелёным бейджем «amoCRM: источник подключён»]
Если у канала нет подключённого amoCRM Chats, эта строка просто не показывается — синхронизировать нечего.
Кнопка «Синхронизировать источники»
Когда у вас есть хотя бы один канал, связанный с amoCRM, в правом верхнем углу страницы появляется кнопка «Синхронизировать источники». Если есть боты, которые ещё ждут регистрации или дали ошибку, рядом с кнопкой горит жёлтый счётчик с их числом — это сигнал, что синхронизацию стоит запустить.
[скриншот: кнопка «Синхронизировать источники» с жёлтым счётчиком ожидающих]
Что делает кнопка. Платформа сверяет список ваших активных ботов со списком источников в amoCRM и приводит их в соответствие:
- Бот, которого ещё нет в amoCRM, — создаётся как новый источник.
- Бот, который уже есть в amoCRM, — просто привязывается (если связь была потеряна).
- Источник в amoCRM, которому больше не соответствует ни один бот (например, бот удалён или переименован), — удаляется.
После завершения вы увидите короткий отчёт-уведомление, например: «Источники amoCRM синхронизированы: 2 зарегистрировано, 1 удалено». Статусы в карточках сразу обновятся.
Синхронизация безопасна и идемпотентна: можно нажимать сколько угодно раз — лишних дублей не появится. Если какой-то источник не зарегистрировался, остальные всё равно обработаются, а проблемный покажет статус «ошибка» с пояснением — повторное нажатие попробует ещё раз.
Бот, добавленный после подключения канала amoCRM
Это самый частый сценарий, ради которого и нужна синхронизация.
Когда вы впервые подключаете канал amoCRM Chats, платформа автоматически регистрирует как источники всех ботов, которые на тот момент уже существуют. Но если вы добавите нового бота позже — уже после того, как amoCRM подключён, — этот бот не зарегистрируется сам мгновенно. Он появится в списке со статусом «amoCRM: ожидает синхронизации» (жёлтый бейдж), а у кнопки «Синхронизировать источники» увеличится счётчик.
Что делать:
- Подключите нового бота как обычно (кнопка «Подключить канал»).
- Вернитесь на страницу «Каналы» — у нового канала будет жёлтый статус «ожидает синхронизации».
- Нажмите «Синхронизировать источники».
- Дождитесь уведомления — статус канала станет зелёным «amoCRM: источник подключён».
[скриншот: новый канал с жёлтым «ожидает синхронизации» и подсветка кнопки «Синхронизировать источники»]
После этого новый бот полностью встроен в amoCRM: входящие из него попадают в сделки, а ответы менеджеров возвращаются клиенту.
Что важно знать: при подключении нового бота платформа сама помечает его как «ожидает синхронизации», если у вас уже есть активный amoCRM Chats. Никаких ручных действий в самой amoCRM при этом делать не нужно — всё происходит со стороны платформы по кнопке.
Когда синхронизация нужна, а когда нет
- Нужна: вы добавили нового бота после подключения amoCRM; удалили или переименовали бота; видите жёлтый или красный статус источника.
- Не нужна: все источники зелёные («подключён»). Повторная синхронизация ничего не сломает, но и не требуется.
Частые вопросы
Я отключил канал — источник в amoCRM удалится? При полном отключении канала amoCRM Chats источники сбрасываются автоматически, чтобы в amoCRM не оставалось «мёртвых» источников. При отключении одного бота запустите синхронизацию — лишний источник будет удалён.
Можно ли менять «ID в amoCRM» после подключения? Технически поле задаётся при подключении. Менять его без необходимости не стоит: именно по нему идёт обратная маршрутизация ответов. Если меняете — обязательно синхронизируйте источники после.
Статус «ошибка регистрации источника» — куда смотреть? Под красным бейджем платформа показывает текст ошибки. Чаще всего причина — проблема с подключением amoCRM (истёкший доступ, нет активной интеграции). Проверьте, что amoCRM подключена и активна, затем нажмите «Синхронизировать источники» ещё раз.
Чем «ID в мессенджере» отличается от «ID в amoCRM»?
«ID в мессенджере» — это бот на стороне Telegram/MAX/VK. «ID в amoCRM» (source_external_id) — это как тот же бот называется внутри amoCRM. Первый платформа определяет сама, второй задаёте вы (или принимаете предложенный).