Воронки и сделки
Бета. Контракт может меняться. Доступ к боевому API открывается после подключения (оплаты).
Воронки и стадии - pipeline
Чтобы Филин понимал, где идёт продажа, а где сделка уже закрыта. Заливается на POST /v1/pipelines (массив).
| Поле | Тип | Обяз. | Комментарий |
|---|---|---|---|
external_id |
string | да | id воронки |
name |
string | да | |
is_sales |
bool | да | продающая ли воронка (только такие скорятся) |
stages[] |
array | да | стадии по порядку |
stages[].external_id |
string | да | |
stages[].name |
string | да | |
stages[].is_won |
bool | да | стадия успешного закрытия (в скоринг не идёт - «туда не смотрим») |
Сделки и лиды - deal
Заливается на POST /v1/deals (массив).
| Поле | Тип | Обяз. | Комментарий |
|---|---|---|---|
external_id |
string | да | ваш id сделки |
pipeline_external_id |
string | да | воронка |
stage_external_id |
string | да | текущая стадия |
employee_external_id |
string | да | ответственный сотрудник |
title |
string | нет | |
amount |
number | нет | сумма, ₽ |
contact_external_id |
string | нет | связь с контактом |
created_at |
datetime | да | ISO 8601 с таймзоной |
updated_at |
datetime | да | смена стадии триггерит пересчёт |
Связность и порядок заливки
Сделка ссылается на воронку, стадию и сотрудника по их external_id - они должны быть залиты раньше, иначе приём вернёт 409. Порядок: employees и pipelines → deals → communications. Подробнее - Батчи и идемпотентность.
Дальше
- Контакты и компании - связь
contact_external_id. - Коммуникации - привязываются к сделке по
deal_external_id.