Создать лида

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

curl -s https://api.ru.sance.ai/v1/leads/ \
  -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  -d '{ "product_id": 42, "stage_id": 7, "name": "Acme Corp — Jane Doe" }'

Чтобы создать лида вместе с контактами одним атомарным вызовом (чтобы агент знал, куда писать), используйте POST /v1/leads/with-contacts:

curl -s https://api.ru.sance.ai/v1/leads/with-contacts \
  -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  -d '{
        "lead": { "product_id": 42, "stage_id": 7, "name": "Acme Corp — Jane Doe" },
        "contacts": [
          { "contact": "+15551234567", "contact_type": "phone", "is_main": true },
          { "contact": "jane_doe", "contact_type": "username", "channel_type": "telegram" }
        ]
      }'

Значения контактов нормализуются и проверяются. При deduplicate_contacts (по умолчанию true) вызов возвращает 409, если контакт дублируется в запросе или уже существует в продукте.

Что дальше: лид находится на этапе 7. Если он активен и кампания рассылок нацелена на этот этап, планировщик может начать выходить на контакт; иначе напишите лиду напрямую или проведите его по воронке.

См.: POST /v1/leads/, POST /v1/leads/with-contacts.