Данный метод позволяет получить список звонков из Речевой аналитики за определенный период.
curl 'https://cloud.roistat.com/api/v1/project/speech/call/list?project=12345'
--request POST
--header 'Content-type: application/json'
--header 'Api-key: {KEY}'
--data Тело запроса - см. ниже
Тело запроса:
{
"period": {
"from": "2019-01-14T21:00:00.000Z",
"to": "2020-01-14T20:59:59.999Z"
},
"sort": [
"date",
"desc"
],
"limit": 20,
"offset": 0,
"filters": [
{
"field": "matched_dictionaries.operator_dictionary_ids",
"operator": "contains_all",
"value": [
"system_1"
]
}
]
}
{
"data": [
{
"id": "3823",
"date": "2021-10-31T00:49:37+0000",
"callee": "",
"caller": "",
"duration": 28,
"answer_duration": 18,
"waiting_time": 10,
"link": null,
"speech_statistics": {
"silence_percent": 0,
"silence_max_duration": 0,
"pause_client_percent": 0,
"pause_operator_percent": 0,
"pause_client_count_per_minute": 0,
"pause_operator_count_per_minute": 0,
"interrupt_client_count": 0,
"interrupt_operator_count": 0,
"interrupt_total_count": 0,
"interrupt_client_count_per_minute": 0,
"interrupt_operator_count_per_minute": 0,
"interrupt_total_count_per_minute": 0,
"interrupt_client_percent": 0,
"interrupt_operator_percent": 0,
"interrupt_total_percent": 0,
"speech_client_max_duration": 0.9999998,
"speech_operator_max_duration": 0.9999998,
"speech_client_percent": 27.0001,
"speech_operator_percent": 36.43,
"speech_operator_to_client_ratio": "57/43",
"speech_client_speed": 453.998,
"speech_operator_speed": 670.9998
},
"matched_dictionaries": {
"client_dictionary_ids": [
"1",
"system_7"
],
"operator_dictionary_ids": [
"system_1",
"system_19",
"system_20",
"system_6"
]
},
"transcriptions": [
{
"id": 92524,
"is_client": 1,
"text": "Здравствуйте.",
"time": 10000,
"dictionary_matches": [],
"last_text_edit_date": null
},
{
"id": 92525,
"is_client": 0,
"text": "Здравствуйте, компания стройка.",
"time": 10600,
"dictionary_matches": [],
"last_text_edit_date": null
},
{
"id": 92526,
"is_client": 1,
"text": "Я уже звонил, вы не взяли трубку и не перезвонили.",
"time": 11200,
"dictionary_matches": [
{
"id": "system_7",
"name": "Повторные обращения",
"word": "уже звонил"
}
],
"last_text_edit_date": null
},
{
"id": 92527,
"is_client": 0,
"text": "Да, действительно, не перезвонили, простите. Что вы хотели?",
"time": 11800,
"dictionary_matches": [
{
"id": "system_19",
"name": "Невыполненные обещания",
"word": "Не перезвонили"
}
],
"last_text_edit_date": null
},
{
"id": 92528,
"is_client": 1,
"text": "Хочу купить двадцать листов волнового шифера.",
"time": 12400,
"dictionary_matches": [],
"last_text_edit_date": null
},
{
"id": 92535,
"is_client": 0,
"text": "Доставка будет стоить четыреста девяносто девять рублей, вас устраивает?",
"time": 16599,
"dictionary_matches": [],
"last_text_edit_date": null
},
{
"id": 92539,
"is_client": 1,
"text": "У вас на сайте указана цена восемь тысяч.",
"time": 19000,
"dictionary_matches": [],
"last_text_edit_date": null
},
{
"id": 92540,
"is_client": 0,
"text": "Наверное произошла техническая ошибка. Сейчас проверю.",
"time": 19600,
"dictionary_matches": [
{
"id": "system_20",
"name": "Баги системы",
"word": "Техническая ошибка"
}
],
"last_text_edit_date": null
},
{
"id": 92541,
"is_client": 0,
"text": "Да, это ошибка в системе.",
"time": 20200,
"dictionary_matches": [
{
"id": "system_20",
"name": "Баги системы",
"word": "Ошибка в системе"
}
],
"last_text_edit_date": null
},
{
"id": 92542,
"is_client": 0,
"text": "Собственно говоря у нас не обновились цены.",
"time": 20800,
"dictionary_matches": [
{
"id": "system_1",
"name": "Слова-паразиты",
"word": "собственно говоря"
}
],
"last_text_edit_date": null
},
{
"id": 92543,
"is_client": 1,
"text": "А мне что нужно с этим делать?",
"time": 21400,
"dictionary_matches": [],
"last_text_edit_date": null
},
{
"id": 92544,
"is_client": 0,
"text": "К сожалению, я ничем не смогу помочь, актуальная цена десять тысяч двести восемьдесят рублей. Будете брать?",
"time": 22000,
"dictionary_matches": [
{
"id": "system_6",
"name": "Мы не можем помочь",
"word": "ничем не смогу помочь"
}
],
"last_text_edit_date": null
},
{
"id": 92545,
"is_client": 1,
"text": "Да, давайте.",
"time": 22600,
"dictionary_matches": [],
"last_text_edit_date": null
},
{
"id": 92546,
"is_client": 0,
"text": "Хорошо, заказ оформлен.",
"time": 23199,
"dictionary_matches": [],
"last_text_edit_date": null
},
{
"id": 92550,
"is_client": 1,
"text": "Хорошо, спасибо.",
"time": 25600,
"dictionary_matches": [
{
"id": "1",
"name": "Оператор решил вопрос клиента",
"word": "Спасибо"
}
],
"last_text_edit_date": null
}
],
"search_phrase_start_time": 10000,
"is_paid": "1",
"is_analyzed": "1",
"operator": "Васильева Анна",
"comment": null,
"order": {
"id": "order_15567",
"url": "https://example.com/order/order_15567",
"source_type": "proxyform_goods",
"creation_date": "2021-10-23T05:49:19+0000",
"update_date": null,
"revenue": 8191.02,
"profit": 8191.02,
"cost": 0,
"client_id": "112",
"roistat": "15567",
"visit_id": "15567",
"custom_fields": {
"status_name": "В работе",
"roistat": 15567,
"manager": "Иванов Георгий"
},
"status": {
"id": "1",
"type": "progress",
"name": "В работе"
},
"page": "cozy.kitchen.ru/catalog/accessories"
},
"visit": {
"id": "26352",
"first_id": "26352",
"date": "2021-10-31T00:34:42+0000",
"referrer": "vk.com/okna",
"landing_page": "cozy.kitchen.ru/catalog/techniques",
"host": "cozy.home.ru",
"agent": "Mozilla/5.0 (iPad; CPU OS 6_0 like Mac OS X) AppleWebKit/536.26 (KHTML, like Gecko) Version/6.0 Mobile/10A5376e Safari/8536.25",
"ip": "217.114.20.188",
"google_client_id": null,
"metrika_client_id": null,
"source": {
"referrer": "http://vk.com/okna",
"system_name": "direct1_search_1_12452289_86991375_39296808",
"display_name": "Яндекс.Директ_Поиск_Поиск | Общие запросы_Товары для дома_Купить товары для дома_товары для дома москва",
"display_name_by_level": [
"Яндекс.Директ",
"Поиск",
"Поиск | Общие запросы",
"Товары для дома",
"Купить товары для дома",
"товары для дома москва"
],
"icon_url": "https://favicon.yandex.net/favicon/direct.yandex.ru",
"utm_source": null,
"utm_medium": null,
"utm_campaign": null,
"utm_term": null,
"utm_content": null,
"openstat": null
},
"geo": null
},
"static_source": null,
"script_name": "Демо сценарий #3",
"is_outcoming": null,
"status": {
"id": null,
"name": "Расшифрован",
"type": "transcribed"
},
"fields_data": null,
"calls_count": 3,
"calls_count_by_callee": 1,
"source_feature": "Звонок из Коллтрекинга"
}
],
"total": 1,
"total_unpaid_calls": 0,
"total_unpaid_calls_duration": 0,
"status": "success"
}
Строка запроса:
| Параметр | Тип | Описание | Обязательный |
|---|---|---|---|
| project | string | Номер проекта | да |
Тело запроса:
| Параметр | Тип | Описание | Обязательный |
|---|---|---|---|
| period | object | Временной период | да |
| > from | string | Начальная дата вида 2016-07-01T00:00:00+0300 | да |
| > to | string | Конечная дата вида 2016-07-31T00:00:00+0300 | да |
| filters | object | нет | |
| sort | string | нет | |
| limit | integer | нет | |
| offset | integer | нет |
| Параметр | Тип | Описание |
|---|---|---|
| ID | integer | ID звонка |
| date | string | Дата и время создания записи о звонке (в формате UTC+0) |
| callee | string | Набранный номер |
| caller | string | Номер клиента |
| duration | integer | Длительность звонка (в секундах) |
| answer_duration | integer | Длительность ответа (в секундах) |
| waiting_time | integer | Длительность ожидания (в секундах) |
| link | string | Ссылка на звонок |
| speech_statistics | object | Метрики речевой аналитики |
| > silence_percent | integer | Одновременное молчание от общей длительности разговора, % |
| > silence_max_duration | integer | Максимальное время одновременного молчания в формате мин:сек |
| > pause_client_percent | integer | Залипания клиента, % |
| > pause_operator_percent | integer | Залипания оператора, % |
| > pause_client_count_per_minute | integer | Залипания клиента, шт/мин |
| > pause_operator_count_per_minute | integer | Залипания оператора, шт/мин |
| > interrupt_client_count | integer | Количество перебиваний клиентом |
| > interrupt_operator_count | integer | Кол-во перебиваний оператором |
| > interrupt_total_count | integer | Общее кол-во перебиваний |
| > interrupt_client_count_per_minute | integer | Количество перебиваний клиентом в минуту |
| > interrupt_operator_count_per_minute | integer | Количество перебиваний оператором в минуту |
| > interrupt_total_count_per_minute | integer | Общее количество перебиваний в минуту |
| > interrupt_client_percent | integer | Перебивания клиентом, % |
| > interrupt_operator_percent | integer | Перебивания оператором, % |
| > interrupt_total_percent | integer | Перебивания, % |
| > speech_client_max_duration | integer | Максимальный участок речи клиента в формате мин:сек |
| > speech_operator_max_duration | integer | Максимальный участок речи оператора в формате мин:сек |
| > speech_client_percent | integer | Речь клиента, % |
| > speech_operator_percent | integer | Речь оператора, % |
| > speech_operator_to_client_ratio | string | Соотношение речи оператора / клиента, % |
| > speech_client_speed | integer | Скорость речи клиента (слов/мин) |
| > speech_operator_speed | integer | Скорость речи оператора (слов/мин) |
| matched_dictionaries | null или object | Информация о сматченных словарях |
| > client_dictionary_ids | string | Сматченные словари по речам клиентов |
| > operator_dictionary_ids | string | Сматченные словари по речам операторов |
| transcriptions | array[object] | Расшифровка звонка |
| > id | integer | ID фразы |
| > is_client | integer | 1 – фраза клиента, 0 – фраза оператора |
| > text | string | Расшифровка фразы |
| > time | integer | Время звонка, на котором началась речь оператора/клиента (сек*1000) |
| > dictionary_matches | array[object] | Найденные фразы из словарей |
| >> id | string | ID словаря |
| >> name | string | Название словаря |
| >> word | string | Фраза из словаря |
| > last_text_edit_date | string or null | Дата последнего редактирования текста расшифровки |
| search_phrase_start_time | integer | Время звонка, в котором найдена фраза (по результатам поиска) |
| is_paid | boolean | Звонок оплачен |
| is_analyzed | boolean | Звонок транскрибирован |
| operator | string | Оператор звонка |
| comment | string | Комментарий |
| order | object или null | Подробные данные о соответствующем заказе. Будут отображены, только если при запросе было указано "extend": ["order"]. В противном случае в ответе будет null. Подробнее о данных заказа – в описании метода /project/integration/order/list |
| visit | object или null | Подробные данные о визите звонка. Будут отображены, только если при запросе было указано "extend": ["visit"]. В противном случае в ответе будет null. Подробнее о данных визита – в описании метода /project/site/visit/list |
| static_source | object или null | Подробные данные о рекламном канале для звонка. Будут отображены, если звонки загружаются из Коллтрекинга, и при этом используется статический Коллтрекинг. В противном случае в ответе будет null. |
| script_name | string | Сценарий Коллтрекинга. Будет отображен, если звонки загружаются из Коллтрекинга |
| is_outcoming | integer | Направление звонка: 1 – исходящий, 0 – входящий |
| status | object | Информация о статусе звонка (Не оплачен, В обработке, Расшифрован) |
