Что синхронизировать с Nastroyka-Amocrm

Для обеспечения консистентности данных между AmoCRM и внешними системами (ERP, сквозная аналитика, складские программы) рекомендуется синхронизировать следующие сущности:

• Leads (Сделки): Синхронизация статусов и сумм с 1С или CRM-системами. Метод: GET /api/v4/leads, PATCH /api/v4/leads/{id}.
• Contacts (Контакты): Передача профилей клиентов в CDP или системы email-маркетинга. Метод: POST /api/v4/contacts.
• Companies (Компании): Актуализация реквизитов из справочников (например, DaData). Метод: PATCH /api/v4/companies/{id}.
• Custom Fields (Кастомные поля): Синхронизация специфических параметров (например, ID заказа в Shopify). Метод: GET /api/v4/leads/custom_fields.
• Tasks (Задачи): Интеграция с трекерами типа Jira или Kaiten. Метод: POST /api/v4/tasks.
• Events (События): Логирование изменений в сделках для аналитических систем. Метод: GET /api/v4/events.
• Catalog Elements (Элементы каталога): Обновление остатков товаров из складских систем (МойСклад). Метод: PATCH /api/v4/catalogs/{catalog_id}/elements/{id}.

Технические особенности API Nastroyka-Amocrm

• Аутентификация: Используется протокол OAuth 2.0. Для авторизации необходимо получить access_token, который передается в заголовке Authorization: Bearer {token}.
• Формат обмена: Все запросы и ответы поддерживаются исключительно в формате JSON.
• Rate Limits: Ограничение составляет до 7 запросов в секунду на один аккаунт. При превышении сервер возвращает 429 Too Many Requests с заголовком Retry-After.
• Обработка ошибок: API возвращает стандартные коды HTTP: 401 (истек токен), 403 (нет прав), 404 (ресурс не найден), 500 (ошибка сервера).
• Вебхуки: Поддерживается отправка событий (статус сделки, новый контакт) на URL-адрес через POST-запросы. Требуется подтверждение получения 200 OK в течение 5 секунд.
• Версионирование: Текущая актуальная версия — v4. Обратная совместимость с v2 и v3 не поддерживается.
• Песочница: Специализированная среда (sandbox) отсутствует; для тестирования рекомендуется создавать отдельный тестовый аккаунт AmoCRM.

Часто задаваемые вопросы о Nastroyka-Amocrm

Как получить API-ключ для интеграции?
Для работы через OAuth 2.0 необходимо создать интеграцию в разделе «Настройки» -> «Интеграции» -> «Создать свою интеграцию». После сохранения вы получите client_id, client_secret и redirect_uri.

Существуют ли жесткие лимиты на количество API-запросов?
Лимит составляет 7 запросов в секунду. При массовой синхронизации необходимо реализовывать очередь с задержкой, чтобы избежать блокировки аккаунта кодом 429.

Поддерживает ли API вебхуки для всех действий?
Вебхуки работают для основных сущностей: сделки, контакты, задачи, покупатели и примечания. Полный список событий доступен в разделе «Вебхуки» внутри настроек интеграции.

Как тестировать изменения, не влияя на «боевую» базу?
Рекомендуется зарегистрировать отдельный аккаунт AmoCRM для разработчиков. Это позволит тестировать эндпоинты, не затрагивая реальную клиентскую базу данных.

Можно ли использовать API для массового удаления данных?
API не поддерживает массовое удаление через один запрос. Удаление каждой сущности выполняется строго по индивидуальному ID методом DELETE, что требует высокой нагрузки на API при очистке больших объемов данных.

Где найти актуальную документацию по методам?
Официальная документация доступна на портале разработчиков AmoCRM (developers.amocrm.ru). Там подробно описаны структуры объектов JSON для каждого эндпоинта. Настроить интеграцию Nastroyka-Amocrm под ключ — flowframe.ru, от 40 000 ₽, срок 7-21 день.