Перейти к содержимому
Филин Филин · Для разработчиков Бета

Минимум для старта и пример

Бета. Контракт может меняться. Доступ к боевому API открывается после подключения (оплаты).

Минимум для старта

Все связи - по вашим идентификаторам (external_id). Филин сам сопоставит звонки со сделками, сделки - с сотрудниками. Ничего не нужно подгонять под внутренние id Филина.

Чтобы получить первый результат, достаточно четырёх сущностей:

  • employees - сотрудники;
  • pipelines - воронки со стадиями;
  • deals - сделки;
  • communications - звонки, переписки, письма, встречи.

Остальное (контакты, компании, заметки, вложения) обогащает контекст и повышает точность, но не блокирует запуск. Рекомендуем начать с минимума, убедиться в качестве разбора, затем достраивать.

Порядок заливки

Чтобы не получить 409 (ссылка на несуществующую сущность), заливайте по порядку: сначала employees и pipelines, затем deals, затем communications. Подробнее - Батчи и идемпотентность.

Сквозной пример (первый результат за один цикл)

# 1. Сотрудник (помечаем к анализу)
POST /v1/employees
[ { "external_id": "emp_7", "name": "Иванов И.", "analyzed": true } ]

# 2. Воронка со стадиями
POST /v1/pipelines
[ { "external_id": "pl_1", "name": "Продажи", "is_sales": true,
    "stages": [
      { "external_id": "s_new", "name": "Новая", "is_won": false },
      { "external_id": "s_won", "name": "Успех", "is_won": true }
    ] } ]

# 3. Сделка
POST /v1/deals
[ { "external_id": "deal_55", "pipeline_external_id": "pl_1",
    "stage_external_id": "s_new", "employee_external_id": "emp_7",
    "title": "ООО Ромашка", "amount": 450000,
    "created_at": "2026-07-18T12:00:00+03:00",
    "updated_at": "2026-07-19T10:31:00+03:00" } ]

# 4. Звонок по сделке (ядро скоринга)
POST /v1/communications
[ { "external_id": "call_10231", "deal_external_id": "deal_55",
    "employee_external_id": "emp_7", "type": "call", "direction": "out",
    "occurred_at": "2026-07-19T10:30:00+03:00", "duration_sec": 512,
    "audio_url": "https://ваша-crm/records/10231.mp3" } ]

# 5. Утром - забрать балл и рекомендации
GET /v1/scoring/leads?since=2026-07-19
→ 200 { "leads": [ { "external_id": "deal_55", "score": 63,
        "recommendations": ["Не выявлена потребность - вернуться с вопросами о ..."] } ] }

Результаты обновляются после ночного цикла: данные, отправленные в течение дня, попадают в ближайший прогон (до 22:00 МСК), а баллы и рекомендации можно забрать наутро.

Дальше