Провести лида по воронке

Цель: перевести лида на другой этап и пометить тегом.

# Сменить этап (new_stage_id должен принадлежать продукту лида)
curl -s -X POST "https://api.ru.sance.ai/v1/leads/1001/change-stage?new_stage_id=8" \
  -H "Authorization: Bearer $TOKEN"

# Присвоить тег (также синхронизируется с CRM)
curl -s https://api.ru.sance.ai/v1/lead-tags/ \
  -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  -d '{ "lead_id": 1001, "tag_id": 55 }'

Чтобы перевести сразу много лидов, используйте POST /v1/leads/change_stage/batch с { "lead_ids": [...], "new_stage_id": 8 } (по возможности: лиды, которые не удалось перевести, пропускаются). Смены этапа фиксируются как события лида и синхронизируются с CRM. Обновляйте CRM-поля через PUT /v1/leads/{id}/crm-fields.

См.: POST /v1/leads/{id}/change-stage, POST /v1/leads/change_stage/batch, POST /v1/lead-tags/, PUT /v1/leads/{id}/crm-fields.