01. Интеграция и анкета подключения
Версия 1.0 от 2026-10-03. Что нужно для подключения Fonotext к телефонии заказчика, какие возможности включаются после интеграции, и анкета для старта.
1. Как происходит подключение
- Заказчик заполняет анкету (раздел 4) — 20 минут.
- Мы подключаемся к системе записи (типы доступа — раздел 2) и получаем тестовую выборку.
- Пилот 2–4 недели: качество, таксономия, дашборды — на записях заказчика.
- Поставка (Поставка, внедрение и безопасность): облако или коробка.
2. Способы передачи записей
| Способ | Описание |
|---|---|
| REST API системы записи | мы опрашиваем список новых записей (частота — по согласованию, стандарт 1–5 мин) |
| Вебхуки | система записи уведомляет нас о новом файле |
| SFTP / S3 | выгрузка в каталог/бакет, забираем по расписанию |
| API метаданных | номер, оператор, направление, кампания — если доступны |
Поддерживаемые форматы аудио: wav/mp3/opus и др. (контейнер не важен), 8–48 кГц, стерео (клиент/оператор в разных каналах) или моно. Стерео-записи дают максимальную точность определения спикеров — без нейросетевой диаризации.
3. Что получает заказчик после интеграции
- Транскрипт каждого звонка с таймкодами и метками спикера (клиент/оператор).
- Классификацию: тип соединения (живой разговор / автоответчик / спам-блокировка / робот /
без ответа), результат разговора, теги, соблюдение скрипта оператором (обязательные и запрещённые фразы), конфликтность.
- Метрики: talk ratio, перебивания, паузы, длительность.
- Дашборды и карточку звонка, экспорт отчётов, вебхуки и API (Спецификация API v1: загрузка и вебхуки).
- Хранение транскриптов 12 месяцев (дольше — по договорённости); оригиналы остаются у заказчика.
Требования к системе описаны в Архитектура: пайплайн, стек, безопасность; SLA и безопасность — в Поставка, внедрение и безопасность.
4. Анкета подключения
A. Доступ к аудио (критично)
- Как хранятся записи: система (АТС/биллинг/CRM — какая?), файловое хранилище, облако?
- Какой доступ возможен: REST API, S3/SFTP, вебхуки о новых записях, доступ к БД метаданных?
- Лимиты API: частота запросов, скорость отдачи, глубина выборки за запрос?
- Возможна ли физическая отгрузка большого архива на дисках?
- Кто и как быстро выдаст тестовый доступ?
B. Формат аудио (критично)
- Кодек и битрейт, частота дискретизации?
- Канальная карта: левый = клиент, правый = оператор? Всегда ли?
- Бывают ли моно-записи или записи с одной занятой дорожкой?
- Примеры «трудных» записей: автоответчики, спам-роботы, короткие сбросы, шум, IVR.
C. Объёмы (критично)
- Звонков в сутки: среднее и максимум; темп прироста за год?
- Средняя и p95 длительность звонка; общий объём архива (часы и число файлов)?
- Часовые пики поступления новых записей?
D. Метаданные
- Метаданные записи: номер звонящего, ID оператора, направление, кампания/очередь, ID в CRM?
- Где зафиксировано соответствие каналов и операторов по звонкам?
E. Приватность и развёртывание
- Где допустима обработка: контур заказчика / облако в РФ?
- Требуется ли маскирование номеров телефонов и иных ПДн в транскриптах и выгрузках?
- Сроки хранения транскриптов; требования к уничтожению по запросу субъекта ПД?
- Согласия на обработку записей (уведомление о записи)?
F. Отчётность и бизнес-контекст
- Топ-5–10 отчётов/KPI для руководства; кто получатели?
- Существующая BI-система (Power BI/Tableau/др.) — интеграция или наша?
- Как сегодня классифицируют звонки вручную? Есть ли размеченные примеры?
- Скрипты операторов, списки обязательных и запрещённых фраз?
- Какие категории «спец-ответов» операторов бизнес различает?
G. Интеграции и SLA
- Возвращать результаты (теги/статусы) в CRM/биллинг? В каком виде?
- SSO/AD для доступа к отчётам?
- Требования к бэкапам и времени восстановления.
Ответы на блоки A–C позволяют до пилота точно рассчитать стоимость (облачную или размер коробки) — без них используются консервативные оценки.
Исходный markdown