🏪 CRM Integration

Универсальный коннектор для передачи заказов в CRM системы

⚠️ Доступно для: E-commerce агентов (ассистенты для продаж)

Поддерживаемые CRM

🏪 RetailCRM

Профессиональная CRM для интернет-магазинов

  • ✅ API v5
  • ✅ API Key auth
  • ✅ Вебхуки
  • ✅ Остатки товаров

📦 МойСклад

Сервис складского учёта

  • ✅ JSON API 1.2
  • ✅ Bearer Token
  • ✅ Вебхуки
  • ✅ Резервирование

🏢 Битрикс24

Универсальная CRM для бизнеса

  • ✅ REST API
  • ✅ OAuth 2.0
  • ✅ Вебхуки
  • ✅ Сделки + товары

Возможности

  • ✅ Автоматическая отправка заказов в CRM
  • ✅ Синхронизация каталога товаров (каждый час)
  • ✅ Вебхуки для обновления статусов в реальном времени
  • ✅ OAuth 2.0 авторизация
  • ✅ Шифрование учётных данных
  • ✅ Очередь заказов с retry-логикой (3 попытки)
  • ✅ Маппинг товаров между системами

Настройка

Шаг 1: Откройте управление CRM

  1. Откройте страницу агента → вкладка Интеграции
  2. Нажмите Управление CRM

Шаг 2: Выберите CRM

  1. Выберите нужную CRM из списка
  2. Нажмите Подключить

Шаг 3: Настройте подключение

Для RetailCRM:

  • Введите URL (например, https://demo.retailcrm.ru)
  • Введите API ключ (из настроек RetailCRM)
  • Нажмите Подключить CRM

Для МойСклад:

  • Введите логин
  • Введите пароль
  • Нажмите Подключить CRM

Для Битрикс24:

  • Введите домен (например, mycompany)
  • Нажмите Подключить CRM
  • Авторизуйтесь в Битрикс24
  • Разрешите доступ к CRM

Шаг 4: Синхронизируйте каталог

  1. После подключения нажмите Синхронизировать
  2. Дождитесь завершения синхронизации
  3. Проверьте товары в разделе Товары

API Reference

Endpoints

GET /api/v1/crm/types

Список доступных CRM

GET /api/v1/crm/:agentId

Статус подключения (без секретов)

POST /api/v1/crm/:agentId/connect

Подключить CRM

POST /api/v1/crm/:agentId/disconnect

Отключить CRM

POST /api/v1/crm/:agentId/sync

Синхронизировать каталог

GET /api/v1/crm/:agentId/products

Синхронизированные товары

GET /api/v1/crm/:agentId/logs

Логи синхронизации

🔒 Безопасность

  • ✅ Все токены и ключи шифруются (AES-256-CBC)
  • ✅ API не возвращает секреты (только hasApiKey, hasAccessToken)
  • ✅ OAuth 2.0 для безопасной авторизации
  • ✅ Вебхуки с проверкой подписи
  • ✅ Изоляция данных по agent_id