Технические параметры
Артефакты
Артефакт |
Расположение |
Назначение |
|---|---|---|
|
|
Секрет |
|
|
API ВАТС MANGO OFFICE, |
|
|
Сервис распознавания речи; в проверенной поставке для Kubernetes — |
|
|
Входящий вебхук, аутентификация по подписи, действие «Трансформация в Events» |
|
|
Маршрут обработки, поставляется в состоянии |
Адреса журналов, в которых настраиваются эти артефакты, приведены в шагах настройки (см. Подключение и настройка).
Коды ответа вебхука
Принимаются POST-запросы на базовый адрес вебхука и на любые пути под ним.
Код |
Сообщение |
Причина |
|---|---|---|
200 |
Пустой ответ |
Подпись верна, уведомление принято; этот же ответ возвращается при остановленном маршруте, и уведомление тогда теряется |
401 |
|
Подписи нет или она неверна |
401 |
|
Подпись есть, но в запросе нет поля |
500 |
|
Вебхук с таким идентификатором не найден |
500 |
|
Секрет, указанный в вебхуке, не найден |
500 |
|
У вебхука не задана конфигурация подписи |
После успешной проверки создаётся событие Citeck типа in-webhook-request с полями webhookId, params и body. В поле body передаётся значение поля json запроса.
IP-адреса MANGO OFFICE
По документации MANGO OFFICE VPBX API версии 1.9 уведомления отправляются с адресов:
81.88.80.13281.88.80.13381.88.82.3681.88.82.4481.88.82.45
Актуальный список рекомендуется уточнить у MANGO OFFICE.
Очереди RabbitMQ
Все очереди и exchange устойчивые (durable): они сохраняются при перезапуске брокера. Их объявляют обработчики маршрута при запуске, а очереди отложенных повторов объявляются при первом использовании.
Объект |
Тип |
Routing key |
Назначение |
|---|---|---|---|
|
Exchange (direct) |
— |
Общий exchange интеграции |
|
Очередь, 1 потребитель |
|
Очередь уведомлений MANGO OFFICE |
|
Очередь |
|
Недоставленные уведомления |
|
Очередь, 2 потребителя |
|
Очередь аудиозаписей: звонки, ожидающие обработки аудиозаписи |
|
Очередь |
|
Звонки, аудиозапись которых не удалось обработать |
|
Quorum-очередь с TTL |
— |
Ожидание отложенного повтора; по истечении TTL сообщение возвращается в |
Номер попытки отложенного повтора хранится в заголовке сообщения mango-recording-retry-attempt.
Параметры маршрута
Параметр |
По умолчанию |
Назначение |
Где задаётся |
|---|---|---|---|
|
|
Паузы между повторами обработки аудиозаписи, мс; число значений равно числу повторов |
JVM или переменная окружения |
|
|
Повторы обработки уведомлений |
JVM или переменная окружения |
|
|
Первая пауза перед повтором обработки уведомления, мс |
JVM или переменная окружения |
|
|
Удвоение паузы между повторами обработки уведомления |
JVM или переменная окружения |
|
|
Максимальная пауза между повторами обработки уведомления, мс |
JVM или переменная окружения |
|
|
Повторы первичной публикации |
JVM или переменная окружения |
|
|
Пауза первичной публикации, мс |
JVM или переменная окружения |
|
|
Пауза повтора сохранения, мс |
JVM или переменная окружения |
|
|
Общие повторяемые коды для загрузки и распознавания. HTTP 404 скачивания Mango повторяется отдельной веткой маршрута, а HTTP 404 STT остаётся постоянной ошибкой. |
YAML маршрута |
|
|
Наибольший размер аудиозаписи, байт |
YAML маршрута |
|
См. Порядок поиска |
Статусы, исключаемые из поиска, по источникам (JSON-словарь) |
YAML маршрута |
|
|
Число последних изменённых сделок или лидов, рассматриваемых в каждом источнике |
YAML маршрута |
|
|
Маркер пометки о неоднозначности |
YAML маршрута |
|
«Номер {number} совпал с несколькими активными записями ({names}). Звонок привязан к последней изменённой — {chosen}.» |
Текст пометки для сделок и лидов |
YAML маршрута |
|
Шаблон для |
Тексты пометок по источникам (JSON-словарь) |
YAML маршрута |
Рабочее пространство создаваемого лида |
|
Размещение лидов, созданных по звонкам |
YAML маршрута, константа |
Потребители очередей |
|
Число одновременно обрабатываемых сообщений; число потребителей очереди уведомлений менять нельзя |
YAML маршрута |
Запрос аудиозаписи |
|
Загрузка mp3-файла |
YAML маршрута |
Запрос распознавания |
|
Распознавание речи |
YAML маршрута |
Тайм-аут распознавания |
|
Наибольшее время ожидания ответа сервиса распознавания |
YAML маршрута |
Провайдер, модель и температура резюме |
|
Языковая модель для резюме |
Свойства Citeck AI |
Атрибуты активности «Звонок»
Атрибут |
Значение |
|---|---|
|
|
|
Сделка или лид |
|
|
|
|
|
«Входящий звонок |
|
Время звонка (ISO 8601, UTC; см. Время звонка) |
|
Пометка о неоднозначности и ссылка на карточку звонка (HTML) |
|
|
|
|
|
Статус обработки аудиозаписи |
|
mp3-файл |
|
Длительность, с |
|
Полный текст |
|
Текст по репликам |
|
Резюме |
В имени файла аудиозаписи все символы, кроме латиницы, цифр, «.», «_» и «-», заменяются на «_», а идентификатор звонка обрезается до 80 символов. Поэтому имя файла может не совпадать с entry_id: например, символы «=» и «+», обычные для entry_id, заменяются.
Атрибуты создаваемого лида
Атрибут |
Значение |
|---|---|
|
|
|
Название найденного контрагента или «Входящий звонок |
|
Номер звонящего как основной контакт ( |
|
Найденный контрагент, если есть |
Компоненты маршрута
Сведения для администратора, который читает YAML маршрута или лог.
Компонент (бин) маршрута |
Назначение |
|---|---|
|
Разбор уведомления MANGO OFFICE и определение его типа |
|
Нормализация номера звонящего |
|
Запрос кандидатов и выбор сделки или лида |
|
Правила выбора сделки или лида |
|
Поиск активности, решение о создании или обновлении, ссылка на карточку звонка |
|
Подпись запроса к API MANGO OFFICE (sha256) |
|
Формирование тела запроса |
|
Проверка размера и типа загруженного ответа |
|
Проверка mp3-файла в ответе без указания типа содержимого |
|
Описание ошибок с маскированием учётных данных |
|
Разделение ошибок на временные и постоянные |
|
Отложенные повторы обработки аудиозаписи |
Известные технические особенности
Уникальность идентификатора звонка на уровне базы данных не гарантируется. В редких случаях одновременной обработки двух уведомлений одного звонка у звонка может появиться вторая активность; используется самая ранняя, в лог выводится предупреждение
activities with the same key.Два сообщения одного звонка могут одновременно обрабатываться двумя потребителями очереди аудиозаписей. Тогда аудиозапись загружается и распознаётся дважды, а в карточке остаётся результат обработки, закончившейся позже, в том числе статус
transcription-failedповерхcompleted.Очередь уведомлений обрабатывается в один поток: сбой одного уведомления задерживает уведомления других звонков на время повторов, до трёх с половиной минут.
Когда повторы исчерпаны после успешной загрузки, записываются статус
transcription-failed, mp3-файл и длительность. Если распознавание прошло, но не удалось сохранить результат целиком, текст и резюме сохраняются отдельными записями, и при успехе звонок получает статусcompleted. Если не удалось сохранить и mp3-файл, остаётся только статус.Временный файл, через который передаётся mp3-файл, удаляется после успешной записи. Временные файлы неудачных записей интеграция оставляет в хранилище; их дальнейшая очистка зависит от настроек и механизмов платформы.
Если уведомление о записи уже перевело звонок в статус
downloading, а передать звонок в очередь аудиозаписей не удалось, статус остаётсяdownloadingдо повторной обработки сообщения изmango-events-dlq.