Как подключить расшифровку из своей системы: задача и уведомление о готовности

Если звонки уже пишутся в вашей АТС или CRM, логичный шаг — отправлять файлы на расшифровку автоматически. Долгие записи нельзя «держать» в одном коротком запросе: соединение оборвётся по таймауту, пользователь устанет ждать. Поэтому задача ставится в очередь, а о готовности система сообщает отдельно.

Ниже — рабочая схема для разработчика или интегратора: что подготовить, какие шаги пройти, как принять уведомление и какие ошибки встречаются чаще всего. Детали полей и примеры запросов — в справочнике на сайте; здесь — логика, чтобы не плутать.

Зачем делать расшифровку асинхронно

Минутный разговор считается быстрее, часовой — дольше. Нагрузка на очередь тоже плавает: утром пик, ночью тише. Асинхронная схема снимает эту неопределённость с ваших сервисов: вы создали задачу, получили её номер, продолжаете работу. Когда текст готов, платформа присылает уведомление на ваш адрес — или вы сами проверяете статус по номеру задачи.

Так же устроены конспект и другие долгие шаги: они могут прийти отдельными событиями после расшифровки. Заложите это в обработчик сразу, чтобы не «потерять» второй сигнал.

Что подготовить до первого запроса

• Аккаунт и ключ доступа в кабинете
• Понимание, откуда берётся файл: ссылка, загрузка, запись АТС
• Адрес вашей службы для уведомлений, доступный из интернета
• Журнал: номер задачи, время, статус, ошибка
• Тестовый набор из 5–10 реальных записей разной длины

Шаги подключения

1. Зарегистрируйте аккаунт и создайте ключ доступа в кабинете. Ограничьте права по возможности.
2. Изучите учебник и справочник: как подключить интерфейс A5X и раздел распознавания речи.
3. Отправьте тестовый файл: создайте задачу расшифровки.
4. Сохраните номер задачи у себя — это ваш «билет» на результат.
5. Дождитесь статуса успеха или уведомления; заберите текст.
6. При необходимости запросите или дождитесь конспекта тем же контуром уведомлений.

Уведомление о готовности

Чтобы не опрашивать статус каждые секунды, укажите адрес вашей службы, куда платформа пришлёт сообщение о завершении. На стороне вашей системы: проверьте секрет или подпись (как описано в справочнике), примите номер задачи, заберите результат, отметьте в журнале, что событие обработано.

Делайте обработчик устойчивым к повторам: одно и то же уведомление может прийти дважды. Операция «положить текст в карточку звонка» должна быть безопасной при повторном вызове.

Если адрес недоступен снаружи (только внутренняя сеть без выхода), уведомления не дойдут. Тогда либо откройте защищённый вход, либо опрашивайте статус по расписанию — осознанно, с паузами и лимитами.

Частые ошибки интеграторов

• Ждут полный текст в первом ответе на длинном файле
• Не обрабатывают повторные уведомления (расшифровка, затем конспект)
• Указывают адрес уведомлений, недоступный извне
• Путают тестовый и боевой ключ
• Не логируют номер задачи — потом невозможно найти сбой
• Кладут ключ в репозиторий «на минутку» — и забывают

Что подключить следом

После текста обычно включают конспект и контроль качества, затем — поток из облачной АТС без ручной загрузки файлов. Практический гайд: как подключить облачную АТС к A5X Speech. Про смысл полного разбора vs голого текста — речевая аналитика и транскрибация.

Чек-лист запуска

1. Ключ создан, права минимально необходимые
2. Тестовый файл успешно расшифрован
3. Адрес уведомления отвечает и пишет в журнал
4. Повтор события не создаёт дубликаты в CRM
5. Описан процесс при ошибке распознавания
6. Понятно, где в CRM появится ссылка на разбор
7. Есть ответственный за ротацию ключей

Частые вопросы