Коммуникации
Сущность communication - ядро скоринга. Звонки, переписки, письма, встречи. Это главный источник оценки. Заливается на POST /v1/communications (массив).
Бета. Контракт может меняться. Доступ к боевому API открывается после подключения (оплаты).
Поля
| Поле | Тип | Обяз. | Комментарий |
|---|---|---|---|
external_id |
string | да | ваш id коммуникации |
deal_external_id |
string | да | к какой сделке |
employee_external_id |
string | да | кто вёл |
type |
enum | да | call / chat / email / meeting |
direction |
enum | нет | in / out |
occurred_at |
datetime | да | ISO 8601 с таймзоной |
text |
string | усл. | текст переписки/письма ИЛИ готовый транскрипт |
audio_url |
string | усл. | ссылка на запись звонка/встречи (Филин скачает и транскрибирует) |
duration_sec |
number | нет | для звонков |
Текст или аудио
Для call и meeting обязательно одно из двух:
- дали
text(готовый транскрипт) - Филин берёт его как есть; - дали
audio_url- Филин скачает запись и транскрибирует сам (серверы в РФ, 152-ФЗ). Подробнее - Аудио и транскрипция.
Для chat и email - text.
Почему коммуникации - приоритет
Ценность даёт содержание общения. Новая коммуникация по сделке триггерит переоценку (дельта-модель, см. Как работает Филин). Если отдать только карточки сделок без звонков и переписок - Филину почти нечего оценивать.
Связность
Коммуникация ссылается на сделку (deal_external_id) и сотрудника (employee_external_id) - они должны быть залиты раньше, иначе приём вернёт 409.
Дальше
- Аудио и транскрипция - как отдавать записи.
- Заметки и вложения - дополнительный контекст.