amoCRM API: какие доработки и интеграции можно сделать

amoCRM предоставляет открытый REST API, через который внешние программы могут читать и изменять данные в CRM. С его помощью компании связывают amoCRM с сайтами, учётными системами, ботами, складскими программами и собственными сервисами. Если готовые интеграции не подходят, API — основной инструмент доработки.

Что доступно через API

• Сделки: создание, изменение, перевод по этапам, привязка к контактам и компаниям
• Контакты и компании: поиск, создание, обновление полей
• Задачи: постановка, изменение, закрытие
• Примечания: добавление комментариев, файлов и событий в карточку
• Воронки и этапы, пользователи, пользовательские поля
• Списки, включая каталог товаров
• Звонки и события для телефонии

Через API можно делать почти всё, что пользователь делает в интерфейсе, и многое сверх этого, например массовые обновления.

Вебхуки

Вебхуки работают в обратную сторону: amoCRM сама сообщает внешнему сервису о событиях — создана сделка, изменён этап, добавлен контакт, пришло сообщение. Внешний сервис получает уведомление и выполняет действия: создаёт счёт в учётной системе, отправляет сообщение в Telegram, обновляет данные на сайте. Вебхуки можно настроить в настройках аккаунта или как действие в Digital Pipeline.

Авторизация

Внешние интеграции подключаются через механизм OAuth 2.0: создаётся интеграция в аккаунте, выдаются ключи, а сервис получает токены доступа с ограниченным сроком действия и обновляет их. Ключи и токены — это доступ к вашей базе клиентов, хранить их нужно в защищённом месте, а не в коде на открытом репозитории.

Ограничения

У API есть ограничения на частоту запросов. Интеграция, которая отправляет запросы без пауз, получит ошибки, а при грубых нарушениях доступ может быть временно ограничен. Поэтому массовые операции делаются порциями, а данные по возможности запрашиваются пакетами. Точные значения ограничений указаны в документации amoCRM, их стоит проверить перед разработкой.

Примеры интеграций

Учётная система. Сделка на этапе «Счёт» вызывает вебхук, обработчик создаёт счёт в учётной программе и возвращает ссылку на него в примечание сделки.

Telegram-бот. Бот принимает заказ, через API создаёт сделку с товарами и контактом, а при смене этапа клиент получает уведомление.

Сайт с личным кабинетом. Клиент видит статус своих заявок, которые хранятся в amoCRM.

Отчёты. Регулярная выгрузка данных в BI-систему для аналитики, которой нет в стандартных отчётах.

Правила надёжной разработки

• Логировать все запросы и ответы, чтобы разбирать ошибки
• Обрабатывать ошибки и повторять запросы при временных сбоях
• Не терять данные при недоступности одной из систем: использовать очередь
• Проверять, не создаётся ли дубль, прежде чем создавать контакт
• Учитывать, что пользователи могут изменить названия полей и этапов: ссылаться на идентификаторы, а не на названия

Где размещать интеграцию

Интеграции нужен сервер, доступный из интернета для приёма вебхуков. Это может быть облачный сервер, бессерверные функции или платформы автоматизации без кода для простых сценариев. Для критичных процессов важно наличие мониторинга: если интеграция остановилась, ответственный должен узнать об этом сразу.

Документация

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

Если нужно связать amoCRM с вашими системами через API, оставьте заявку — спроектируем и разработаем интеграцию.