Перейти к основному содержимому

Подключить CRM и синхронизацию

Цель: связать CRM с продуктом, чтобы лиды импортировались внутрь, а этапы/поля/теги/сообщения синхронизировались наружу.

У подключения CRM два уровня: интеграция уровня компании (аккаунт CRM) и привязка к продукту (какой продукт её использует, с его маппингом).

1. Создать интеграцию​

CRM на базе OAuth — amoCRM, Kommo, Bitrix24, FastTrack, Usedesk — подключаются через свой OAuth-поток, а не через этот API. Единственная CRM, которую вы создаёте здесь напрямую, — Google Sheets:

curl -s https://api.ru.sance.ai/v1/crm-integrations/google-sheets \
  -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  -d '{ "company_id": 10, "name": "Sheet CRM", "crm_type": "google_sheets",
        "config": { "secrets": { "service_account_json": { "client_email": "...", "...": "..." } } } }'

В ответе есть service_account_email — дайте этому email доступ к вашей таблице. Список существующих интеграций — GET /v1/crm-integrations/.

2. Привязать к продукту​

curl -s https://api.ru.sance.ai/v1/product_crm_integrations/ \
  -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  -d '{ "product_id": 42, "crm_integration_id": 5, "config": {} }'

3. Изучить и управлять​

Получите метаданные CRM для построения маппинга и запустите повторную синхронизацию полей классификации:

curl -s "https://api.ru.sance.ai/v1/crm-integrations/5/pipelines" -H "Authorization: Bearer $TOKEN"
curl -s "https://api.ru.sance.ai/v1/crm-integrations/5/users"     -H "Authorization: Bearer $TOKEN"
curl -s -X POST "https://api.ru.sance.ai/v1/product_crm_integrations/42/5/classification-sync" \
  -H "Authorization: Bearer $TOKEN"

Что дальше: фоновые обработчики импортируют новых/обновлённых лидов из CRM и отправляют обратно смены этапа, CRM-поля, теги и сообщения. Привязка отслеживает last_import_at / last_sync_at.

См.: POST /v1/crm-integrations/google-sheets, GET /v1/crm-integrations/, GET /v1/crm-integrations/{id}/pipelines, POST /v1/product_crm_integrations/, POST /v1/product_crm_integrations/{product_id}/{crm_integration_id}/classification-sync.