Внешняя интеграция amoCRM — это связь CRM с другим сервисом через API, без кода в интерфейсе amoCRM. Администратор аккаунта один раз разрешает сервису доступ к данным, и дальше сервис сам создаёт и обновляет сделки, контакты и задачи: принимает заявки с сайта, подтягивает данные из учётной системы, передаёт события в аналитику. В документации amoCRM это отдельный тип интеграции, наряду с приватной, публичной и отраслевым решением.
Ниже разбираем, чем внешняя интеграция отличается от виджета, как она обменивается данными, когда хватит готового решения из амоМаркета и что прописать в задании, чтобы заявки не терялись и не дублировались. Всё, что касается устройства amoCRM, взято из официальной документации для разработчиков, проверено 3 ноября 2026.
Какие бывают интеграции amoCRM
amoCRM делит интеграции на четыре типа (документация amoCRM, «Начало работы»):
| Тип | Где работает | Виджет в интерфейсе | Для чего |
|---|---|---|---|
| Приватная | В одном аккаунте, загружается вручную, без модерации | По желанию | Доработка под конкретную компанию |
| Публичная | Публикуется в маркетплейсе, установить может любой пользователь | Обязателен, нужна модерация | Готовые решения для многих компаний |
| Внешняя | Только через API: в аккаунт не устанавливается, в маркетплейс не попадает | Нет | Связь с сайтом, учётной системой, своим сервисом |
| Отраслевое решение | Маркетплейс, заявку подаёт партнёр amoCRM | Обязателен | Готовая настройка под отрасль |
Практическая разница простая. Если менеджеру нужно что-то видеть и нажимать прямо в карточке сделки — кнопку, блок с данными, окно настроек, — понадобится виджет, то есть приватная или публичная интеграция. Если данные просто должны ходить между системами в фоне, хватает внешней. Для неё не нужен отдельный технический аккаунт, достаточно обычного аккаунта amoCRM.
Как внешняя интеграция обменивается данными
Обмен идёт в две стороны, и у каждой свой механизм.
Из сервиса в amoCRM: запросы к API
Сервис отправляет запросы к API amoCRM: создать сделку, найти контакт по телефону, сменить этап, поставить задачу. Чтобы запросы проходили, интеграцию регистрируют в аккаунте: во вкладке «амоМаркет» нажимают троеточие в левом верхнем углу, затем «Создать интеграцию» и заполняют форму.
У API есть лимиты: не больше 7 запросов в секунду на одну интеграцию и до 50 на весь аккаунт. При превышении amoCRM отвечает ошибкой 429, а при многократных нарушениях блокирует доступ, и на любой запрос приходит ошибка 403. За один запрос можно создать или изменить до 250 записей, но для стабильной работы документация советует не больше 50 (ограничения и рекомендации API). Если интеграция переносит старую базу или массово обновляет сделки, это закладывают сразу: очередь запросов и паузы между ними.
Из amoCRM в сервис: вебхуки
Чтобы не опрашивать CRM каждую минуту, используют вебхуки — уведомления, которые amoCRM сама отправляет на адрес сервиса, когда что-то происходит. Их настраивают в «амоМаркете» кнопкой «WEB HOOKS» в правом верхнем углу: имя, адрес и события. Уведомления приходят по сделкам, контактам, компаниям, покупателям, задачам и спискам: добавление, изменение, удаление, смена статуса сделки, смена ответственного, новое примечание (описание вебхуков).
Для надёжности важна одна деталь: amoCRM ждёт ответа не больше 2 секунд. Если сервис не ответил, будут повторные попытки через 5 минут, 15 минут, ещё 15 минут и час. Если за последние 2 часа набралось больше 100 неудачных ответов, хук отключается, а администраторы получают уведомление. Поэтому принимающая сторона должна сначала быстро ответить «получено» и только потом разбирать данные. Работа с вебхуками через API, по документации, доступна на расширенном и профессиональном тарифах.
Доступ: ключи и токены
Доступ выдаётся по протоколу OAuth 2.0. Администратор видит название интеграции и список запрашиваемых прав и нажимает «Разрешить». Токен получает права того пользователя, который выдал доступ (авторизация OAuth 2.0). Для внешних и приватных интеграций есть долгосрочные токены: срок действия выбирают от 1 дня до 5 лет, а отозвать токен можно во вкладке «Выданные доступы».
У обычной схемы есть ловушка. Ключ обновления (refresh token) живёт 3 месяца и меняется при каждом обновлении: старый после обмена перестаёт работать. Если интеграция не сохранила новый ключ или долго не обращалась к API, доступ пропадает, и обмен молча встаёт. Это одна из частых причин истории «интеграция работала и перестала».
Какие задачи решают внешней интеграцией
- Заявки с сайта и форм. Форма отправляет данные в amoCRM, появляется сделка с контактом и источником. Про формы на WordPress есть отдельная статья.
- Учётная система и 1С. Заказы, счета, оплаты и остатки переходят между CRM и учётом без ручного ввода.
- Телефония. Звонок находит или создаёт контакт, запись разговора попадает в карточку. Здесь часто хватает готового решения: сначала стоит проверить, есть ли оно у твоего оператора в амоМаркете.
- Мессенджеры и чаты. Переписка из каналов попадает в сделку. Подробнее — в статье про интеграцию amoCRM с мессенджерами.
- Аналитика. Источник визита и рекламные метки сохраняются в сделке, а данные о продажах уходят обратно в аналитику, чтобы считать окупаемость каналов. Пример — связка amoCRM с Яндекс Метрикой.
- ИИ-агенты. Агент отвечает клиенту в мессенджере, квалифицирует заявку и сам создаёт сделку с историей диалога. Так устроены наши ИИ-агенты в мессенджерах и CRM.
Готовое решение из амоМаркета или своя интеграция
Прежде чем заказывать разработку, стоит проверить, нет ли готового решения. Сравнить варианты помогает простая таблица.
| Критерий | Готовое решение из амоМаркета | Своя внешняя интеграция |
|---|---|---|
| Срок | Установка и настройка | Задание, разработка, тестирование |
| Логика | Как задумал разработчик решения | Под твой процесс и твои поля |
| Оплата | Условия разработчика решения, часто подписка | Разработка и поддержка |
| Кто чинит | Разработчик решения | Тот, кто делал интеграцию, или твоя команда |
| Когда выбирать | Стандартная задача: популярный сервис, телефония | Своя система, нестандартные данные, цепочка из нескольких систем |
Мы обычно действуем так: ищем готовое решение под задачу и проверяем его на тестовой сделке. Свою интеграцию пишем, когда готовое не закрывает процесс или когда данные проходят через несколько систем подряд, например сайт, CRM и учёт.
Что прописать в задании на интеграцию
Большинство проблем с интеграциями появляется не в коде, а в недоговорённостях. Перед разработкой стоит ответить на шесть вопросов.
- Какие данные и в какую сторону. Список полей с обеих сторон и правило, какая система главная для каждого поля. Иначе две системы будут перезаписывать друг друга.
- Когда срабатывает обмен. По событию через вебхук, по расписанию или по кнопке в карточке.
- Что делать с дублями. В amoCRM есть «Контроль дублей»: правила настраивают в окне воронки на вкладке «Настройка правил», поиск идёт по email и телефону контакта, по значению дополнительного поля и по данным самой amoCRM. Интеграция попадает в список источников, только если создаёт сделки специальным методом с поиском дублей, а со старыми API-ключами контроль не работает (контроль дублей).
- Что происходит при ошибке. Повторные попытки, журнал ошибок и кому приходит уведомление, если обмен встал. Без этого о сломанной интеграции узнают от клиента, который не дождался ответа.
- Объёмы. Сколько заявок в день и нужен ли перенос старой базы. От этого зависит, упрётся ли интеграция в лимиты API.
- Кто владелец доступа. От чьего имени выдан доступ, где хранятся ключи и кто продлевает или отзывает их.
Как держать доступы под контролем
- Документация советует хранить токены и секретный ключ интеграции в защищённом хранилище, а не в открытых конфигурационных файлах. При утечке сначала обновляют секретный ключ, затем токены.
- Токен действует с правами пользователя, который выдал доступ. Поэтому стоит записать, кто и когда его выдал, и выдавать доступ от учётной записи, которая не зависит от одного менеджера.
- Долгосрочные токены видны и отзываются во вкладке «Выданные доступы». Раз в квартал полезно проверять, какие интеграции ещё нужны.
- Если администратор отключит интеграцию, её токены отзываются, и API начинает отвечать ошибкой 401. Об этом важно помнить, когда наводишь порядок в амоМаркете.
Как мы делаем интеграции
Начинаем с бесплатного экспресс-аудита на час: смотрим, какие системы участвуют и где сейчас теряются данные. Ещё за 3 часа готовим план, затем делаем пилот на твоих данных и запускаем — от 7 дней, две недели сопровождения входят в проект. Отдельная интеграция — модуль от 50 000 ₽. Подробнее — на странице внедрения CRM и интеграций.
Частые вопросы
Чем внешняя интеграция amoCRM отличается от виджета?
Внешняя интеграция работает только через API и ничего не добавляет в интерфейс amoCRM. Виджет — это код, который показывает данные и кнопки прямо в карточке; он есть у приватных и публичных интеграций.
Почему интеграция с amoCRM перестала работать?
Частые причины: истёк ключ обновления (он живёт 3 месяца и меняется при каждом обновлении), вебхук отключился после 100 неудачных ответов за 2 часа, интеграция превысила лимиты API или администратор её отключил, и токены отозваны.
Как не допустить дублей при интеграции?
Включить «Контроль дублей» в настройках воронки и создавать сделки методом с поиском дублей. В задании заранее прописать, по каким полям искать совпадения и что делать, если найдено несколько.
Нужен ли особый тариф amoCRM для интеграции?
Для работы с вебхуками через API документация называет расширенный или профессиональный тариф. Остальные условия лучше сверить с действующими тарифами amoCRM перед стартом проекта.
Сколько стоит и сколько делается внешняя интеграция?
У нас отдельная интеграция — модуль от 50 000 ₽, запуск от 7 дней. Точную оценку даём после бесплатного экспресс-аудита, когда видно, какие системы участвуют и сколько данных переносить.
Источники
- amoCRM для разработчиков: «Начало работы», типы интеграций (проверено 3 ноября 2026)
- amoCRM: авторизация OAuth 2.0 по шагам (проверено 3 ноября 2026)
- amoCRM: Webhooks (проверено 3 ноября 2026)
- amoCRM: ограничения и рекомендации API (проверено 3 ноября 2026)
- amoCRM: контроль дублей (проверено 3 ноября 2026)