Подключение 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. Сгенерируйте долгосрочный токен

Ключи есть только у интеграции, которую вы создали сами. Если вы открыли интеграцию, установленную из каталога amoMarket, вкладки с ключами там не будет — и кнопка ничего не даст. Вернитесь к шагу 1 и создайте свою.

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), чтобы фильтровать лиды из чата.

• Защита от дублей — как найти уже существующий контакт при доставке:

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

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

• Доп. поля — сопоставьте данные диалога с вашими пользовательскими полями сделки или контакта. Доступные источники:

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

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

• Метки рекламы (UTM) — настраивать нечего: если в вашем amoCRM есть поля utm_source, utm_medium, utm_campaign, utm_content, utm_term, msg8 сам их заполнит. Значения — настоящие, из ссылки, по которой пришёл этот посетитель. msg8 переносит только то, что действительно было в ссылке: если там есть utm_source=google, оно попадёт в поле; один gclid не превращается автоматически в выдуманные google / cpc / название кампании.

  Идентификаторы клика (gclid, yclid, fbclid и другие) тоже сохраняются в msg8. В amoCRM они попадут только тогда, когда у сделки есть совместимое поле с таким же кодом или названием.

  Метка запоминается на входе и живёт 30 дней, поэтому она доходит, даже если человек полистал сайт и написал уже с другой страницы, или вернулся через неделю. Новый переход по рекламе перезаписывает старую метку.

  Если за последние 30 дней не было перехода с метками, поля останутся пустыми. Мы ничего не придумываем. И заполняем только при создании сделки: если в поле уже что-то стоит от другой вашей интеграции, msg8 это не трогает.

• Примечание в сделке — добавлять ли примечание вообще.

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

  Если «Объединять повторные заявки» выключено — а это умолчание, — повторная заявка заводит новую сделку, и её примечание несёт переписку с начала. Один и тот же текст окажется в двух карточках. Вложения в переписке помечены как [вложение]; посмотреть их можно в разделе «Диалоги» в кабинете.

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

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

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

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

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

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

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

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

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

Каждая заявка приходит отдельной сделкой? Да. Оставил человек номер второй раз — вторая сделка, даже если это тот же номер час спустя: так менеджер точно её увидит, а примечание в старой карточке легко пропустить. Контакт при этом переиспользуется — второй карточки на одного человека не появится.

Если вам удобнее наоборот, включите Настройки агента → Уведомления → «Объединять повторные заявки»: тогда повтор ляжет примечанием в открытую сделку клиента. Если та уже закрыта (успешно или с отказом) или удалена, сделка всё равно создастся новая — в закрытую никто не заглянет. На «Клиентов», Google-таблицу и уведомления тумблер не влияет: там заявка видна в любом случае.

Будут ли дубли из-за повторных попыток отправки? Нет. msg8 запоминает, какую сделку создал под каждую заявку, и повторная доставка той же заявки дополняет её, а не создаёт вторую.

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

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

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

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

Что дальше

• Сбор лидов — когда и как бот собирает контакты.
• Клиенты (CRM) — где лиды хранятся у нас и как выгрузить их в CSV.
• Интеграции — другие подключения агента.