Портал для разработчиков
Подключите свою или самописную CRM - Creatio, 1С, кастом - к Филину по API, без коннектора под каждую систему: вы отдаёте данные, Филин скорит их как обычно. Здесь - контракт приёма данных: как работает Филин, модель данных, эндпоинты, аудио и безопасность. Портал в бете; доступ к боевому API открывается после подключения (оплаты).
Введение
- О портале Dev-портал Филина: для кого, бета, доступ к API после подключения. Подключите свою или самописную CRM по API - Филин скорит данные как обычно.
- Как работает Филин Механика Филина: приём и нормализация данных, транскрипция звонков, ночной скоринг, дельта-модель пересчёта и что вы получаете назад.
Начало работы
- Ключ, адрес, аутентификация Начало работы с API Филина: API-ключ, базовый адрес, аутентификация по Bearer-токену и формат запросов.
- Минимум для старта и пример Первый результат за один цикл: минимальный набор сущностей и сквозной пример заливки данных - от сотрудника до балла сделки.
- Проверка данных Проверка payload до боя: эндпоинт /validate по тестовому ключу проверяет структуру и связность и возвращает ошибки построчно, ничего не записывая.
Модель данных
- Сотрудники Сущность employee: какие поля отдавать и как работает оплата только за анализируемых сотрудников.
- Воронки и сделки Сущности pipeline и deal: воронки со стадиями и сделки, связи по вашим external_id.
- Контакты и компании Сущности contact и company: как связать общение со сделкой и обогатить контекст разбора.
- Коммуникации Сущность communication - ядро скоринга: звонки, переписки, письма и встречи, текст или ссылка на аудио.
- Заметки и вложения Сущности note и attachment: комментарии сотрудников и файлы по сделке, которые Филин учитывает в разборе.
- Аудио и транскрипция Приём аудио: ссылка на запись, форматы, транскрипция на серверах в РФ (152-ФЗ) и когда отдавать готовый транскрипт.
Справочник API
- Эндпоинты Полный список эндпоинтов приёма данных и получения результатов с параметрами выдачи.
- Коды ответов и ошибки Коды ответов API и обработка ошибок: что означает каждый код и что делать при отклонении строк батча.
- Батчи и идемпотентность Первичная загрузка истории, размер батчей, идемпотентность по external_id и инкрементальная досылка данных.