🏪 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
- Откройте страницу агента → вкладка Интеграции
- Нажмите Управление CRM
Шаг 2: Выберите CRM
- Выберите нужную CRM из списка
- Нажмите Подключить
Шаг 3: Настройте подключение
Для RetailCRM:
- Введите URL (например, https://demo.retailcrm.ru)
- Введите API ключ (из настроек RetailCRM)
- Нажмите Подключить CRM
Для МойСклад:
- Введите логин
- Введите пароль
- Нажмите Подключить CRM
Для Битрикс24:
- Введите домен (например, mycompany)
- Нажмите Подключить CRM
- Авторизуйтесь в Битрикс24
- Разрешите доступ к CRM
Шаг 4: Синхронизируйте каталог
- После подключения нажмите Синхронизировать
- Дождитесь завершения синхронизации
- Проверьте товары в разделе Товары
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