GetSpeechAnalyticsList

Метод GetSpeechAnalyticsList

Примените метод GetSpeechAnalyticsList для получения результатов речевой аналитики звонков за определенный период. Для этого выполните POST-запрос с входными параметрами к точке подключения, указанными ниже:

Точка подключения:

POST: https://api.exolve.ru/statistics/call-record/v1/GetSpeechAnalyticsList

Авторизация

Передайте следующие Заголовки HTTP для успешной авторизации.

Входные параметры

Передайте следующие параметры в теле запроса в JSON-формате. Параметры, отмеченные жирным шрифтом, являются обязательными.

Выходные параметры

SpeechAnalytics

ConversationStatistics

SpeakerStatistics

SpeechSpeed

InterruptsStatistics

SpeakerStatistics

SilenceStatistics

SimultaneousSilenceDurationEstimation

SpeechStatistics

SimultaneousSpeechDurationEstimation

ConversationSummary

Quiz

Резюме диалога состоит из ответов на эти вопросы:

1. Оператор был вежливым?
2. Оператор был раздражен?
3. Оператор был вовлечен в диалог?
4. Оператор был эмпатичным?
5. Оператор хамил?
6. Оператор решил проблему клиента?
7. Оператор был уверенным?
8. Клиент ушел раздраженным?
9. Клиент остался доволен?
10. Клиент хамил?

Summarization

Statements

ClassifierStatistics

ClassificationResult

Тег — группа ключевых слов одной тематики. Сервис автоматически определяет, встречались ли те или иные ключевые фразы в разговоре, и добавляет к нему тег. Например, теги показывают, что оператор поблагодарил клиента за ожидание или что клиент обращается в службу поддержки повторно. Полный перечень тегов указан в этой статье.

Transcription

Phrase

PhraseClassifier

Возможные ошибки

Примеры

Входные параметры:

{
    "date_from": "2024-01-15T00:10:00Z",
    "date_to": "2025-01-30T23:59:59Z",
    "application_uuid": "80f14680-d069-4aa2-b7b6-e0699231ec17"
}

Выходные параметры:

{
      "url": "https://example.com",
      "call_id": "7227567342572675072",
      "application_uuid": "80f14680-d069-4aa2-b7b6-e0699231ec17",
      "date_time": "2024-08-09T06:53:38Z",
      "from": "78633035672",
      "to": "79842198158",
      "start_time": "2024-08-09T06:52:16.179Z",
      "end_time": "2024-08-09T06:52:38.931Z",
      "conversation_statistics": {
        "speaker_statistics": [
          {
            "channel_tag": "0",
            "total_speech_duration": "19s",
            "total_silence_duration": "19s",
            "speech_ratio": 0.37,
            "speech_speed": {
              "min": 2.65,
              "max": 3.19,
              "avg": 2.87,
              "std": 0.28
            }
          },
          {
            "channel_tag": "1",
            "total_speech_duration": "0.12s",
            "total_silence_duration": "0.12s",
            "speech_ratio": 0.07829268292682927,
            "speech_speed": {
              "min": 2.65,
              "max": 3.19,
              "avg": 2.87,
              "std": 0.28
            }
          },
          {
            "channel_tag": "",
            "total_speech_duration": "0.31s",
            "total_silence_duration": "0.31s",
            "speech_ratio": 0,
            "speech_speed": {
            "min": 1.79,
            "max": 3.19,
            "avg": 2.33,
            "std": 0.27
            }
          }
        ]
      },
      "interrupts_statistics": {
        "speaker_interrupts": [
          {
            "channel_tag": "0",
            "total_interrupts_count": "0",
            "total_interrupts_duration": "0s"
          },
          {
            "channel_tag": "1",
            "total_interrupts_count": "0",
            "total_interrupts_duration": "0s"
          },
          {
            "channel_tag": "",
            "total_interrupts_count": "0",
            "total_interrupts_duration": "0s"
          }
        ]
      },
    "silence_statistics": {
      "total_simultaneous_silence_duration": "0.7s",
      "total_simultaneous_silence_ratio": 0.86,
      "simultaneous_silence_duration_estimation": {
        "min": 0.4,
        "max": 1.23,
        "avg": 0.9,
        "std": 0.8
        }
      },
    "speech_statistics": {
      "total_simultaneous_speech_duration": "11s",
      "total_simultaneous_speech_ratio": 0,
      "simultaneous_speech_duration_estimation": {
        "min": 120,
        "max": 5819,
        "avg": 2369.8,
        "std": 2250.83
        }
      },
      "conversation_summary": {
        "quiz": [
          {
            "request": "1. Оператор был вежливым?",
            "response": "1. Да"
          },
          {
            "request": "2. Оператор был раздражен?",
            "response": "2. Нет"
          },
          {
            "request": "3. Оператор был вовлечен в диалог?",
            "response": "3. Нет"
          }
        ]
      },
      "classifier_statistics": {
        "classification_results": []
      },
      "transcription": {
        "phrases": [
          {
            "channel_tag": "1",
            "text": "Добрый день! Меня зовут Софья, как я могу вам помочь?",
            "start_time": "1s",
            "end_time": "5s",
            "classifiers": [
               {
                 "classifier": "Приветствие",
                  "highlighted_text": "добрый день"
                }
            ]
          },
          {
            "channel_tag": "0",
            "text": "Алло! Вы меня слышите?",
            "start_time": "7s",
            "end_time": "8s",
            "classifiers": [
               {
                 "classifier": "Проблемы со связью",
                  "highlighted_text": "алло"
                }
            ]
          },
          {
            "channel_tag": "1",
            "text": "Да, вас хорошо слышно.",
            "start_time": "10s",
            "end_time": "11s",
            "classifiers": []
          },
          {
            "channel_tag": "1",
            "text": "Чем я могу вам помочь?",
            "start_time": "13s",
            "end_time": "13s",
            "classifiers": []
          }
        ]
      }
    },
    {
      "url": "https://example.com",
      "call_id": "7227571958240649216",
      "application_uuid": "80f14680-d069-4aa2-b7b6-e0699231ec17",
      "date_time": "2024-08-09T07:11:38Z",
      "from": "78633035672",
      "to": "79842198158",
      "start_time": "2024-08-09T07:10:36.646Z",
      "end_time": "2024-08-09T07:10:50.911Z",
      "conversation_statistics": {
        "speaker_statistics": [
          {
            "channel_tag": "0",
            "total_speech_duration": "19s",
            "total_silence_duration": "19s",
            "speech_ratio": 0.37,
            "speech_speed": {
              "min": 2.65,
              "max": 3.19,
              "avg": 2.87,
              "std": 0.28
            }
          },
          {
            "channel_tag": "0",
            "total_speech_duration": "5s",
            "total_silence_duration": "5s",
            "speech_ratio": 0.11,
            "speech_speed": {
              "min": 1.67,
              "max": 4.68,
              "avg": 2.61,
              "std": 0
            }
          },
          {
            "channel_tag": "",
            "total_speech_duration": "11s",
            "total_silence_duration": "11s",
            "speech_ratio": 0,
            "speech_speed": {
              "min": 3.85,
              "max": 4.68,
              "avg": 4.22,
              "std": 0
            }
          }
        ]
      },
      "interrupts_statistics": {
        "speaker_interrupts": [
          {
            "channel_tag": "0",
            "total_interrupts_count": "0",
            "total_interrupts_duration": "0s"
          },
          {
            "channel_tag": "1",
            "total_interrupts_count": "0",
            "total_interrupts_duration": "0s"
          },
          {
            "channel_tag": "",
            "total_interrupts_count": "0",
            "total_interrupts_duration": "0s"
          }
        ]
      },
      "silence_statistics": {
        "total_simultaneous_silence_duration": "5s",
        "total_simultaneous_silence_ratio": 0.81,
        "simultaneous_silence_duration_estimation": {
          "min": 1180,
          "max": 2560,
          "avg": 1680,
          "std": 764.4
        }
      },
      "speech_statistics": {
        "total_simultaneous_speech_duration": "0s",
        "total_simultaneous_speech_ratio": 0,
        "simultaneous_speech_duration_estimation": {
          "min": 0,
          "max": 0,
          "avg": 0,
          "std": 0
        }
      },
      "conversation_summary": {
        "quiz": [
          {
            "request": "1. Оператор был вежливым?",
            "response": "1. Да"
          },
          {
            "request": "2. Оператор был раздражен?",
            "response": "2. Нет"
          },
          {
            "request": "3. Оператор был вовлечен в диалог?",
            "response": "3. Нет"
          },
          {
            "request": "4. Оператор был эмпатичным?",
            "response": "4. Нет"
          }
        ]
      },
      "summarization": {
        "statements": [
          {
            "name": "summary",
            "response": "Клиент и оператор не слышали друг друга из-за плохой связи"
          },
          {
            "name": "operator_keywords",
            "response": "договорились"
          },
          {
            "name": "client_keywords",
            "response": "алло", "не слышу"
          },
          {
            "name": "problems",
            "response": "плохая слышимость"
          },
          {
            "name": "call_results",
            "response": "договорились"
          },
          {
            "name": "call_reason",
            "response": "договорились"
          },
          {
            "name": "theme ",
          "response": "заказ"
          }
        ]
      },     
      "classifier_statistics": {
        "classification_results": []
      },
      "transcription": {
        "phrases": [
          {
            "channel_tag": "1",
            "text": "Добрый день! Меня зовут Софья, как я могу вам помочь?",
            "start_time": "0.000000001s",
            "end_time": "0.000000001s",
            "classifiers": []
          },
          {
            "channel_tag": "0",
            "text": "Здравствуйте! Меня хорошо слышно?",
            "start_time": "0.000000004s",
            "end_time": "0.000000004s",
            "classifiers": []
          }
        ]
      }
    }
  ]
}