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

Эта интеграция передаёт лидов из чата на вашем сайте прямо в amoCRM: как только посетитель оставляет телефон или email, msg8 создаёт сделку и контакт и заполняет карточку данными, которые узнал в диалоге — имя, телефон, email, суть запроса, источник и ссылку на переписку.

Всё происходит автоматически на нашей стороне. Менеджеру не нужно ничего копировать вручную, а модель ИИ для этого не используется — значит, передача лидов не тратит ваши кредиты.

Подключение делается один раз: вы создаёте в amoCRM «долгосрочный токен» и вставляете его вместе с адресом аккаунта в msg8. Ниже всё по шагам.

Что вы получите

  • Новый лид из чата сразу появляется в amoCRM — сделка в воронке + контакт.
  • Карточка приходит уже заполненной: контакты, запрос клиента, источник.
  • Без дублей: если клиент вернётся, обновится та же сделка, а не создастся новая.
  • Страница сайта, ссылка на переписку и краткое резюме диалога — примечанием в сделке.

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

  1. Аккаунт amoCRM.
  2. Права администратора в amoCRM, чтобы создать интеграцию и токен.
  3. Несколько минут времени.

Шаг 1. Создайте интеграцию в amoCRM

  1. Войдите в amoCRM под администратором.
  2. Откройте amoМаркет (раздел «Интеграции») → нажмите «+ Создать интеграцию» (справа сверху) → выберите «Внешняя интеграция».
  3. Заполните обязательные поля:
    • Название — например, msg8.
    • Ссылку для перехода (Redirect URI) можно указать любую корректную, например https://msg8.ai — для токена она не используется, но поле обязательное.
    • Оставьте доступ «Доступ к данным аккаунта» — этого достаточно для сделок, контактов и примечаний.
  4. Сохраните интеграцию.

Шаг 2. Сгенерируйте долгосрочный токен

  1. Откройте созданную интеграцию → вкладка «Ключи и доступ».
  2. В разделе «Долгосрочный токен доступа» нажмите «Сгенерировать токен».
  3. Выберите срок действия — рекомендуем максимальный (до 5 лет).
  4. Скопируйте токен сразу — после закрытия окна он больше не показывается. Если потеряете — просто сгенерируете заново.

Токен — как пароль: по нему можно работать с вашей CRM. Никому его не пересылайте и не публикуйте. msg8 хранит токен в зашифрованном виде.

Шаг 3. Подключите amoCRM в msg8

  1. В msg8 откройте Настройки → Интеграции у нужного агента.
  2. Нажмите на карточку amoCRM«Подключить».
  3. Заполните два поля:
    • Адрес аккаунта — например, company.amocrm.ru (из адресной строки amoCRM).
    • Долгосрочный токен — тот, что скопировали на шаге 2.
  4. Нажмите «Проверить и подключить».

Если всё верно, появится зелёная плашка «Подключено к …», и msg8 подтянет из amoCRM списки воронок, этапов, сотрудников и полей для настройки.

Если вместо этого появилась ошибка — загляните в раздел «Если что-то пошло не так» ниже.

Шаг 4. Настройте передачу (по желанию)

Сразу после подключения всё уже работает. Без единой настройки в amoCRM автоматически попадают:

  • Контакт — имя (если бот узнал), телефон, email.
  • Сделка — название «Заявка с сайта — {имя/телефон/email}».
  • Примечание к сделке — запрос клиента, канал лида, страница сайта и ссылка на переписку в msg8 (управляется тумблером «Прикладывать переписку», включён по умолчанию).

При желании настройки можно уточнить:

  • Воронка и этап сделки — куда попадают новые сделки. По умолчанию — главная воронка, первый этап.

  • Ответственный — менеджер, на которого назначаются новые сделки.

  • Тег сделки — необязательная метка (например, msg8), чтобы фильтровать лиды из чата.

  • Защита от дублей:

    • По нашей записи + телефону/email (рекомендуется) — не создаст дубль, даже если контакт уже есть в amoCRM из другого канала; новая сделка прикрепится к нему.
    • Выключено — каждое обращение создаёт новую сделку и контакт.
  • Доп. поля — сопоставьте данные диалога с вашими пользовательскими полями сделки или контакта. Доступные источники:

    ИсточникЧто передаётся
    Запрос клиентаСуть обращения, сформулированная ботом
    ИсточникКанал лида («Чат-виджет», «Форма» и т. д.)
    Страница сайтаURL страницы, с которой посетитель открыл виджет
    Ссылка на диалогПрямая ссылка на переписку в msg8
    Имя / Телефон / E-mail / АдресКонтактные данные

    Все эти значения попадают в примечание автоматически (см. выше). Таблица нужна только чтобы продублировать нужное значение в отдельное пользовательское поле amoCRM.

  • Прикладывать переписку — добавлять примечание в сделку с резюме диалога, каналом, страницей сайта и ссылкой на переписку.

Нажмите «Сохранить». Кнопка «Обновить справочники» перечитывает из amoCRM воронки, поля и сотрудников, если вы поменяли их в CRM.


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

  • Лид передаётся, как только в диалоге появился телефон или email.
  • Сделка и контакт создаются одним запросом (leads/complex).
  • Пока идёт тот же диалог, msg8 дополняет ту же сделку и контакт новыми данными (например, уточнённым именем) — и только если что-то реально изменилось.
  • Телефон и email записываются при первом появлении — чтобы не затирать номера, которые менеджер мог добавить вручную в уже созданный контакт.
  • Никаких обращений к ИИ: поля заполняются обычным кодом, кредиты не расходуются.

Проверьте, что всё работает

  1. Откройте чат-виджет на сайте (или в Песочнице) и напишите боту так, будто вы клиент: оставьте имя и телефон.
  2. Откройте amoCRM → раздел «Сделки»: появится новая сделка в выбранной воронке, с прикреплённым контактом и примечанием-перепиской.

Если что-то пошло не так

Если на карточке интеграции появилась красная плашка с ошибкой, вот что она обычно означает:

  • «Подключение разорвано». Токен отозван или истёк. Сгенерируйте новый долгосрочный токен (Шаг 2) и переподключите.
  • «Доступ запрещён». В настройках безопасности amoCRM включён «белый список IP», либо превышен лимит запросов. Проверьте настройки безопасности аккаунта.
  • «Подписка не оплачена». Доступ к API закрыт до оплаты тарифа amoCRM.
  • «Некорректный адрес аккаунта». Адрес должен быть вида company.amocrm.ru (или .amocrm.com) — без https:// и без пути.
  • «amoCRM временно ограничил частоту запросов». Сам лид при этом сохранён в msg8 (раздел «Клиенты»). Если он не появился в amoCRM — повторите чуть позже или напишите в диалоге ещё раз: карточка дополнится при следующем сообщении.

Частые вопросы

Будут ли дубли в amoCRM? Нет, при включённой защите от дублей. msg8 запоминает, какую сделку он создал, и при повторных обращениях обновляет её. Режим «по телефону/email» прикрепляет новую сделку к контакту, который уже был в CRM из других каналов.

Для максимально надёжного объединения по номеру телефона дополнительно включите штатный «Контроль дублей» в самой amoCRM (Настройки → Общие настройки) — тогда amoCRM подхватит контакт, даже если номер записан в другом формате.

Тратятся ли кредиты msg8 на передачу лидов? Нет. Поля заполняются обычным кодом, без обращения к ИИ.

Можно ли подключить разных агентов к одной amoCRM? Да. Подключите каждого агента отдельно — у каждого свои настройки (воронка, ответственный, поля).

Что будет со старыми сделками при отключении? Уже созданные сделки и контакты останутся в amoCRM. Просто новые перестанут поступать.

Что дальше