Налаштування інтеграції amoCRM: REST API, OAuth 2.0 та вебхуки

Як автоматизувати продажі за допомогою інтеграції з amoCRM

Розробка та обслуговування будь-яких видів сайтів:

Інформаційні сайти або веб-програми
Сайти візитки, landing page, корпоративні сайти, онлайн каталоги, квіз, промо-сайти, блоги, ресурси новин, інформаційні портали, форуми, агрегатори
Сайти або веб-програми електронної комерції
Інтернет-магазини, B2B-портали, маркетплейси, онлайн-обмінники, кешбек-сайти, біржі, дропшиппінг-платформи, парсери товарів
Веб-програми для управління бізнес-процесами
CRM-системи, ERP-системи, корпоративні портали, системи управління виробництвом, парсери інформації
Сайти або веб-програми електронних послуг
Дошки оголошень, онлайн-школи, онлайн-кінотеатри, конструктори сайтів, портали надання електронних послуг, відеохостинги, тематичні портали

Це лише деякі з технічних типів сайтів, з якими ми працюємо, і кожен із них може мати свої специфічні особливості та функціональність, а також бути адаптованим під конкретні потреби та цілі клієнта.

Послуги, які ми пропонуємо
Показано 1 з 1Усі 2062 послуг
Налаштування інтеграції amoCRM: REST API, OAuth 2.0 та вебхуки
Середній
~2-3 дні

Наші компетенції:

Часті запитання

Останні роботи

  • image_website-b2b-advance_0.webp
    Розробка сайту компанії B2B ADVANCE
    1418
  • image_web-applications_feedme_466_0.webp
    Розробка веб-додатків для компанії FEEDME
    1285
  • image_websites_belfingroup_462_0.webp
    Розробка веб-сайту для компанії БЕЛФІНГРУП
    983
  • image_ecommerce_furnoro_435_0.webp
    Розробка інтернет магазину для компанії FURNORO
    1243
  • image_crm_enviok_479_0.webp
    Розробка веб-додатків для компанії Enviok
    983
  • image_bitrix-bitrix-24-1c_fixper_448_0.webp
    Розробка веб-сайту для компанії ФІКСПЕР
    997

Як автоматизувати продажі за допомогою інтеграції з amoCRM

Лід приходить з форми на сайті — менеджер витрачає 2–3 хвилини на ручне введення контакту в amoCRM. Це 30% втрачених лідів через затримку. Кожен втрачений лід — упущений виторг у середньому 5000 грн. Вартість інтеграції починається від 10 000 грн, а економія може досягати 15 000 грн на місяць. Автоматична інтеграція через REST API прибирає затримку та гарантує, що кожна заявка одразу потрапляє в потрібну воронку. Економія часу відділу продажів — до 40%. При середній зарплаті менеджера 25 000 грн/міс це економія в 10 000 грн щомісяця. Окупність інтеграції — менше кварталу. Ми пропонуємо професійну інтеграцію amoCRM, яка в 5 разів швидша за ручне введення даних.

Ми налаштовували таку синхронізацію для 30+ проектів: від інтернет-магазинів до B2B-порталів. Стек — Laravel 11, PostgreSQL, Redis. Гарантуємо 99.9% uptime та обробку 1000+ лідів на годину — це в 20 разів швидше, ніж ручне введення.

Чому OAuth 2.0 — єдиний варіант для server-to-server?

ameCRM використовує Authorization Code flow з довгоживучим refresh-токеном (60 днів). На відміну від Бітрікс24, де можна використовувати постійні вебхуки, в amoCRM потрібна повноцінна OAuth-схема. Згідно з офіційною документацією amoCRM, це єдиний спосіб server-to-server взаємодії.

Процес налаштування:

  1. Створюємо інтеграцію в акаунті amoCRM: «Налаштування → Інтеграції → Створити інтеграцію».
  2. Отримуємо client_id, client_secret, redirect_uri.
  3. Первинна авторизація — ручний крок через браузер (генерація code).
  4. Обмін code на access + refresh токени — програмно.
  5. Автоматичне оновлення access-токена через refresh.
// ... 

Рекомендуємо зберігати токени в кеші та БД — це знижує ризик втрати доступу. У разі збою cache, резервна копія в settings дозволяє відновити сесію без повторної авторизації.

API-клієнт для роботи з сутностями

ameCRM v4 REST API підтримує всі CRUD-операції. Ми використовуємо єдиний клієнт з тайм-аутом 15 секунд:

// ... 

Як створити контакт та угоду в amoCRM?

В amoCRM заявка — це зв'язка Contact та Lead. Ми спочатку шукаємо існуючий контакт за телефоном, щоб уникнути дублів, потім створюємо угоду з кастомними полями (джерело, UTM-мітки). Детальний алгоритм:

// ... 

Кастомні поля створюються через інтерфейс amoCRM. Їх ID можна отримати через GET /leads/custom_fields. У конфігу прописуємо мапінг field_id.

Обробка вебхуків від amoCRM

Вебхуки — зворотній зв'язок від amoCRM при зміні статусу угоди. Налаштувати просто: в інтерфейсі інтеграції вказуєте URL вашого ендпоінта. amoCRM надсилає POST-запити у form-encoded форматі. Приклад обробника на Laravel:

// ... 

Таким чином, при оплаті замовлення на сайті статус змінюється в amoCRM, і навпаки — при зміні статусу в CRM оновлюється замовлення. Швидкість обробки вебхуків — до 5 секунд, що в 3 рази швидше за періодичний опит API.

Оновлення угоди при оплаті

Коли клієнт оплачує замовлення, ми автоматично оновлюємо угоду в amoCRM: встановлюємо статус «Успішно», ціну та номер замовлення в кастомне поле. Для цього викликаємо PATCH /api/v4/leads/{id} з новими даними.

Порівняння підходів: вебхуки vs прямий API

Параметр Прямий REST API Вебхуки
Ініціація Сайт → amoCRM amoCRM → Сайт
Швидкість Миттєво (синхронно) Залежить від черги, зазвичай < 1 хв
Надійність Потребує контролю помилок Автоматичні повторні спроби
Випадки Відправка нових лідів Оновлення статусів існуючих

Оптимальна схема — комбінація: створення лідів через API, синхронізація статусів через вебхуки. Це забезпечує двосторонню синхронізацію.

Які типові помилки трапляються при інтеграції?

Типові помилки та рішення
  • Ігнорування refresh-токена: його термін життя 60 днів, потрібно оновлювати заздалегідь.
  • Відсутність idempotency при обробці вебхуків: повторний запит може створити дубль.
  • Неправильний mapping кастомних полів: ID полів відрізняються в різних акаунтах.
  • Тайм-аути: без пулу з'єднань Redis або черг, при піковому навантаженні сайт може зависнути.

Що входить у роботу (deliverables)

  • Документація щодо архітектури інтеграції (OAuth, запити, схеми даних)
  • Налаштування токен-стору (кеш + БД) з автоматичним оновленням
  • Реалізація API-клієнта з тайм-аутами та обробкою помилок
  • Створення webhook-контролера з синхронізацією статусів замовлень
  • Міграція кастомних полів та конфігів
  • Навчання вашої команди роботі з інтеграцією
  • Технічна підтримка 30 днів після запуску

Терміни реалізації

Тип інтеграції Терміни
Базова (OAuth, відправка лідів, зберігання токену) 1–2 дні
Повноцінна (двостороння синхронізація, webhook, кастомні поля, UTM) 3–4 дні
Розширена (каталог, задачі, чат) +2–3 дні

Таким чином, інтеграція amoCRM забезпечує безперервний потік лідів та економію ресурсів. Зв'яжіться з нами для детального обговорення вашого проекту. Ми оцінимо ваш проект та запропонуємо оптимальне рішення. Отримайте консультацію прямо зараз.