01 / Штатно
Настройка платформы
Поля, права, роботы, бизнес-процесс или стандартный webhook закрывают сценарий без нового продукта.
- Главная
- Разработка
- amoCRM · API v4
amoCRM · API v4
Разработка интеграций amoCRM без потери заявок и статусов
Подключаем к amoCRM внешние сервисы и внутренние системы: от формы сайта до 1С, оплаты, доставки, AI и собственного продукта. Учитываем OAuth, лимиты API, повторные события, дубли и смену токенов — не только успешный демонстрационный запрос.
- amoCRM · официальный партнёр
- Битрикс24 · бизнес-партнёр
- Код и доступы передаваем
Сначала выбор пути
Разработка — третий вариант, а не первый
Проверяем задачу по возрастающей сложности. Это снижает стоимость владения и число компонентов, которые придётся поддерживать.
02 / Готово
Партнёрское решение
Сравниваем поддержку нужных объектов, ограничения, обновления, журнал и полную стоимость лицензии.
03 / На заказ
Собственная разработка
Нужна, если процесс, интерфейс, объём, безопасность или контроль ошибок не укладываются в готовые варианты.
Типовые запросы
Частые задачи для amoCRM
На фриланс-площадках и в запросах бизнеса повторяются не названия технологий, а конкретные разрывы процесса.
01
Сайт и интернет-магазин
Создание контакта и сделки, состав заказа, UTM, источник, защита от дублей и обратная синхронизация статуса.
02
1С, ERP и склад
Контрагенты, товары, остатки, цены, заказы, счета, оплаты, отгрузки и общий идентификатор объектов.
03
Платежи и чеки
Ссылка на оплату, факт платежа, возврат, чек, сумма и автоматическое действие в воронке.
04
Доставка
Создание заказа перевозчику, трек-номер, статусы, уведомления клиенту и задача при исключении.
05
Боты и AI
Telegram-бот, голосовой агент, транскрибация, анализ звонка и безопасная запись результата в карточку.
06
Собственный SaaS
Публичная либо внешняя интеграция, OAuth для нескольких аккаунтов, биллинг, журнал и администрирование.
Проектные решения
Архитектурные решения для amoCRM
Детали ниже определяют эксплуатацию выбранного формата и проверяются до оценки реализации.
Сначала выбираем модель авторизации. Внутренняя связка одного аккаунта, внешняя интеграция для ограниченного числа пользователей и публичный продукт имеют разные способы установки и ответственности. Ошибка на этом этапе позже превращается в ручную выдачу токенов и невозможность нормально отключить клиента.
Домен аккаунта, access token и refresh token считаем частью конфигурации, но не помещаем в исходный код. Сервис должен уметь обновить токен один раз при параллельных запросах и не затереть новую пару старой. Отдельно проверяем сценарий отзыва доступа и отключения интеграции.
Лимит запросов распределяется между операциями. Массовая загрузка контактов не должна лишить приоритета входящую заявку или оплату. Очередь различает срочный поток и фоновую синхронизацию, а метрики показывают отставание до того, как менеджер заметит пропуск в карточке.
Webhook фиксируем раньше бизнес-обработки. Быстро подтверждаем приём, сохраняем ID и только затем вызываем внешние API. Такой порядок помогает пережить повтор доставки, перезапуск процесса и временную недоступность получателя без второго заказа или потери события.
Поля и воронки не зашиваем в код как единственно возможные значения. Их идентификаторы храним в настройках, а при запуске проверяем существование и тип. Администратор получает понятную ошибку ещё до того, как поток заявок начнёт записываться не туда.
Для массовых обновлений используем пакетные методы там, где они доступны, и сохраняем результат каждой части. Успех первой страницы не означает завершение всей выгрузки. Контрольная сверка считает обработанные записи и отдельно показывает пропуски.
Архитектура
Данные проходят через контролируемый маршрут
У каждой операции есть внешний идентификатор, состояние и способ проверить итог. Синхронный вызов используем только там, где он действительно безопасен.
Источник
amoCRM
Событие, пользовательское действие или плановая выборка.
Контроль
Сервис с очередью
Проверка, маппинг, очередь, защита от дублей, журнал и повтор.
Результат
API внешней системы
Подтверждение операции, сохранённая связь объектов и сверяемый итог.
Если получатель временно недоступен, операция не должна исчезать или бесконечно создавать новые сущности. Она получает состояние, понятную причину ошибки и управляемый повтор.
Результат проекта
Передаём не только код, но и управляемую систему
Состав зависит от масштаба, но критичные решения, доступы и сценарии восстановления не остаются в переписке разработчика.
01
Паспорт интеграции
Сущности amoCRM, custom fields, источники, pipeline/status, ответственные и внешний идентификатор.
02
OAuth и токены
Сценарий установки, обновление токена, отзыв доступа, безопасное хранилище и контроль ошибок 401/403.
03
Ограничение потока
Очередь, пакетная обработка и backoff с учётом официальных лимитов и кода 429.
04
Защита от дублей
Идемпотентный ключ, поиск существующей сущности и различение повтора доставки от нового обращения.
05
Логи и сверка
Входное событие, ответ API, связь с карточкой, причина отказа и повтор без ручного переноса данных.
06
Поддержка изменений
Проверка changelog amoCRM, тестовый аккаунт, регрессия виджета и план безопасного обновления.
Специфика задачи
Что важно именно в API amoCRM
Официальные ограничения влияют на архитектуру уже на этапе оценки — особенно при массовом импорте и работе нескольких интеграций.
Лимит — часть бизнес-сценария. Документация amoCRM указывает не более 7 запросов в секунду на интеграцию и до 50 на аккаунт. При превышении возвращается 429; повторные нарушения могут привести к блокировке API.
Поэтому массовый обмен нельзя строить как цикл запросов без регулирования. Закладываем очередь, пакетную обработку, паузу с увеличением интервала и контроль общей нагрузки аккаунта.
Внутреннюю интеграцию, внешнюю интеграцию и публичный продукт проектируем по-разному: отличаются способ установки, OAuth, модерация, количество аккаунтов и требования к поддержке.
- Точный домен аккаунта и HTTPS
- Обновление access/refresh token
- Пагинация и пакетная запись
- Повтор вебхука без дубля
- Безопасное отключение интеграции
- Проверка на техническом аккаунте
Источники и границы. Возможности платформ сверены 2 октября 2026 года: Ограничения API amoCRM · Внешние интеграции amoCRM. Конкретные методы, тарифы, редакции и требования публикации повторно проверяем перед проектом.
Надёжность
Проверяем отказ до того, как он станет инцидентом
Демонстрация успешной операции — только начало приёмки. Интеграция должна предсказуемо вести себя при повторе, задержке и недоступности.
Duplicate
Повтор события
Тот же ID не создаёт вторую сделку, заказ, документ или платёж.
Timeout
Нет ответа
Операция остаётся в контролируемом состоянии и повторяется по правилам.
Partial
Частичный результат
Виден выполненный шаг, точка отказа и безопасное продолжение процесса.
Recovery
Восстановление
После сбоя можно сверить период и повторить только пропущенные операции.
Порядок работы
От контрольного примера до сопровождения
Для локальной задачи этапы компактные. Для критичной интеграции каждый этап имеет отдельный результат и принимающего сотрудника.
Обследование
Текущий процесс, системы, данные, ограничения и цена ошибки.
Проектирование
Вариант решения, карта данных, события, права и критерии приёмки.
Разработка
Контуры, код, конфигурация, журнал и тестовые данные.
Пилот
Обычный путь, исключения, роли, нагрузка и соседние процессы.
Эксплуатация
Передача, мониторинг, поддержка, обновления и план развития.
Форматы работы
Сначала регулярная ответственность, затем проект и разовые задачи
Интеграции живут вместе с процессом и API платформ. Поэтому приоритетный формат после запуска — сопровождение, а не ожидание следующего аварийного обращения.
Ежемесячное сопровождение
Для работающих интеграций, где важны контроль, контекст и плановое развитие.
от 30 000 ₽ / мес
- мониторинг и разбор инцидентов
- плановые проверки и сверка
- небольшие изменения в согласованном объёме
- отчёт и следующий приоритет
Проектная разработка
Для подтверждённого типового запроса или нового интеграционного продукта с приёмкой.
оценка после обследования
- требования и архитектура
- итерации и демонстрации
- тестирование отказов
- передача кода и документации
Пакет часов
Дополнительный формат для ограниченного списка разовых работ без новой архитектуры.
от 15 000 ₽
- диагностика одного сбоя
- локальный webhook или поле
- проверка готового модуля
- небольшая правка документации
Короткие ответы
Вопросы до старта
Точная оценка появляется после проверки систем и одного реального сценария. Ниже — границы, которые полезно знать заранее.
Можно ли подключить amoCRM по долгосрочному токену?
В отдельных внутренних сценариях это возможно, но способ авторизации выбираем по числу аккаунтов, жизненному циклу решения и требованиям безопасности. Для тиражного продукта нужен полноценный сценарий установки и OAuth.
Почему при интеграции появляются дубли?
Чаще всего повтор доставки принимается за новое обращение или контакт ищется по одному нестабильному полю. Нужны внешний идентификатор операции, правила поиска и отдельная логика повторного клиента.
Можно доработать чужую интеграцию?
Да, после ревизии исходников, доступов, токенов, журналов и инфраструктуры. Без исходного кода сначала оцениваем восстановление или переписывание критичного компонента.
Делаете публичные интеграции для amoМаркет?
Можем спроектировать тиражную интеграцию и виджет с учётом OAuth, нескольких аккаунтов, настройки, поддержки и подготовки к модерации. Объём определяем после проверки требований платформы для конкретной категории.
Связанные направления
Выберите компонент, который соответствует задаче
Страницы кластера разделены по поисковому и проектному намерению, но в реальной архитектуре компоненты часто работают вместе.
Следующий шаг
Покажите одну операцию, которая сейчас выполняется вручную или теряется
Разберём путь данных, проверим готовые решения и предложим минимальный устойчивый вариант. Для оценки полезны пример сущности, используемые системы, частота операций и ожидаемый результат.
- Не просим готовое техническое задание для первого разговора
- Отдельно обозначаем неизвестные и внешние зависимости
- Не продаём разработку, если задача решается надёжнее без неё
Описать задачу
Проект с проверяемой приёмкойСпроектируем «Разработка интеграций amoCRM без потери заявок и статусов» с тестами и передачей результата
Зафиксируем операцию, данные, ошибки и критерии готовности до оценки разработки. Реализацию оформим проектом, а мониторинг и развитие — ежемесячным сопровождением.
Отправка формы ни к чему не обязывает. Сначала уточним границы задачи.