Как в amoCRM добавить интеграцию: виджет, API и проверка

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

Полный каталог каналов и типичных связок — на странице интеграций amoCRM. Эта статья только про жест «добавить» и про проверку, что лид сел в сделку.

Как в amoCRM добавить интеграцию: три разных действия

1. Включить виджет. Почта, телефония, мессенджер, формы, 1С-коннекторы из витрины. Вы выбираете приложение, даёте доступ, заполняете поля подключения. Код не пишете.

2. Создать интеграцию. Это запись для разработчика: название, права, Redirect URI, затем Integration ID и Secret key. Так подключают свой сервис или скрипт к API. Это не «поставить WhatsApp одной галочкой».

3. Повесить форму на сайт. Заявка может уходить на почту, в Telegram-бота или в сторонний конструктор — и в amoCRM не попадать, хотя «интеграцию вроде делали». Проверяйте конечную точку, не скрин настроек.

Если нужен конкретный мессенджер, не раздувайте эту how-to в коммерческий запрос: разбор канала — на странице WhatsApp.

Виджет из amoМаркета

Нужны права администратора аккаунта. Менеджер с ограниченными правами виджет не установит и потом будет думать, что «CRM сломана».

Короткий порядок:

1. Откройте amoМаркет.
2. Найдите нужное приложение (не первое в рекламном блоке — то, которое совпадает с вашим каналом).
3. Включите и выдайте запрошенные права.
4. Укажите воронку, этап «новой заявки», поле источника, кто ответственный по умолчанию.
5. Сохраните. Не уходите, пока не прогоните тест.

Типовой провал: виджет включён, а сделки создаются в учебную воронку из демо. Второй: нет ответственного — заявка висит сиротой, менеджеры её не видят в «моих».

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

Своя интеграция через API

Если готового виджета нет или логика нестандартная, в amoМаркете создают интеграцию. Официальный путь: аккаунт администратора → amoМаркет → меню «создать интеграцию» → форма (имя, доступы, Redirect URI) → ключи. Дальше обмен кода на токены. Пошаговая механика — в документации OAuth amoCRM и примере по шагам.

Что важно бизнесу, а не разработчику:

• Ключи живут в аккаунте, где интеграцию создали. Потеряли доступ к этому аккаунту — чините доступы, а не «ещё раз ставите виджет».
• Интеграция и установка в рабочий аккаунт — разные шаги. Создали у интегратора, не включили у клиента — API молчит.
• Права интеграции должны совпадать с задачей. Нет права писать сделки — заявки не появятся, сколько ни дебажить форму.

Кастом через API — уже не «добавить за 15 минут». Если нужен контур продаж целиком, смотрите настройку amoCRM, а не только эту инструкцию.

Почему «добавили» — а заявка всё равно в почте

Это не баг витрины. Чаще четыре бытовых причины.

Форма на сайте по-прежнему шлёт письмо менеджеру. Виджет amoCRM стоит «на всякий случай», но HTML-форма не смотрит на CRM. Смотрите, куда уходит POST, а не что написано в кабинете.

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

Этап и воронка не те. Сделка создаётся, но в архивной воронке или в статусе, который менеджеры отфильтровали.

Два канала на один лид. Форма создаёт сделку, почтовый виджет создаёт вторую по тому же письму. В отчёте «заявки есть», в работе — каша. Оставьте один канонический вход.

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

Что проверить, пока менеджеры не пошли в чат

На тестовой сделке:

• Источник заполнен;
• Воронка и этап «новой заявки» совпадают с регламентом;
• Есть ответственный или правило распределения;
• Стоит задача на первый контакт;
• Дубля нет.

Если тест зелёный, а через неделю лиды снова в WhatsApp менеджера — вы добавили техническую связку и не убрали личный канал. Это уже дисциплина, не кнопка в amoМаркете.

Когда одной кнопки мало

How-to закрывает жест «как в amoCRM добавить интеграцию». Не закрывает выбор стека, TCO и очередь каналов. Для этого — хаб интеграций. Если CRM уже стоит, а заявки живут в чатах, сначала аудит процесса, потом новые виджеты. Иначе вы ускорите беспорядок.

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

Кто может добавить интеграцию в amoCRM? Пользователь с правами администратора аккаунта. С правами менеджера витрина часто недоступна.

Чем виджет отличается от пункта «создать интеграцию»? Виджет — готовое приложение. «Создать интеграцию» выдаёт ключи для своего сервиса и API. Это разные экраны и разные задачи.

Нужен ли программист, чтобы подключить почту или мессенджер? Если есть виджет и типовой сценарий — обычно нет. Свой обмен полями, несколько юрлиц, нестандартная форма — нужен API и ТЗ.

Что считать успешной установкой? Тестовая заявка снаружи создала сделку в нужной воронке с источником и ответственным. Зелёный тумблер без карточки не считается.

Почему после установки появляются дубли? Один человек приходит двумя каналами: форма и почта, форма и чат. Назначьте один канонический вход, второй не должен плодить сделку.