Сравнение версий

Старая версия 2

changes.mady.by.user Кадубовский Андрей (Twin)

Сохранено

по сравнению с

Новая версия 3

changes.mady.by.user Владимир Диев

Сохранено

Ключ

  • Эта строка добавлена.
  • Эта строка удалена.
  • Изменено форматирование.

...

Описаниепараметровметода:

Параметр
Параметр ОбязательноОписание
fieldsДадаЧерез «=» указываются поля, которые нужно получить от системы отчетности. Сами поля перечисляются через запятую.
Список полей:
id – идентификатор звонка;
phone – номер телефона клиента;
duration – длительность диалога;
taskId – идентификатор задания на обзвон;
taskName – имя задания на обзвон;
botId – идентификатор работавшего бота;
botName – имя работавшего бота;
regionId – идентификатор региона, в котором оформлен номер телефона клиента;
timezone – часовой пояс номера телефона клиента;
status – статус результата дозвона телефонии;
responder – тип ответившего на звонок, при работающем модуле определения автоответчиков;
shortNumber - 
transferredToOperator – признак отвечающий за то, был перевод звонка на оператора КЦ или нет;
linkToLog – ссылка на лог звонка, по которой разбирают различные ситуации наши инженеры;
createdAt – дата и время создания записи;
updatedAt – дата и время обновления любой информации по записи;
startedAt – дата и время запуска звонка;
price – стоимость диалога;
messages – текстовая транскрибация всего диалога, по ролям и доп информацией о реплике каждого участника диалога;
messagesAsString - текстовая транскрибация всего диалога, по ролям, без доп информации;
recordPath – ссылка на аудиозапись диалога;
externalId – информация, переданная в информации о клиенте, на этапе загрузки;
additional – дополнительная информация, переданная в информации о клиенте, на этапе загрузки;
dialogResults – результат диалога бота, указанный в поле «Подтверждения» в сценарии диалога;
nps - результат диалога бота, указанный в поле «NPS» в сценарии диалога;
isFinished – признак отвечающий за то, будут ли на данного клиента еще попытки дозвона, или данная попытка была последней.
fromНетнетДата и время, начала диапазона времени, за которое нужно получить статистику. 
!!! Необходима конвертация в url (например метод в Python: urllib.parse.quote(test_str))
Для примера: 2022-03-01T21%3A30%3A54%2B00%3A00
toНетнетДата и время, окончания диапазона времени, за которое нужно получить статистику. 
!!! Необходима конвертация в url (например метод в Python: urllib.parse.quote(test_str))
Для примера: 2022-03-01T21%3A30%3A54%2B00%3A00
limitНетнетОграничение количества данных, которые нужно получить.
Максимум: 1 000
offsetНетнетСмещение по позиции полученной информации.
Например, в заданное временное окно было 4 050 4 050 звонков. Сделав запрос вы получили доступный максимум, в виде 1 000 1 000 записей. Тогда вам нужно повторить запрос, с указанием последней полученной позиции. Получив 1 000 1 000 записей, 1 000 1 000 и есть наша последняя позиция. Получив еще раз максимальное количество, повторяем запрос указав смешение уже на 2 000 2 000 позиций. 
Делаем смещение до тех пор, пока количество возвращенных данных не будет меньше запрошенному лимиту.
sortНетнет

Поле, по которому вы хотите отсортировать получаемые данные. 
Сортировка доступна по полям: createdAt, updatedAt, startedAt, duration.
«+» сортировка по возрастанию;
«-» сортировка по убыванию.

Пример запроса:

https://analyse.twin24.ai/api/v1/search/cis/calls?fields=id,phone,duration,taskId,taskName,botId,botName,regionId,timezone,status,responder,shortNumber,transferredToOperator,linkToLog,createdAt,updatedAt,startedAt,price,messages,messagesAsString,recordPath,externalId,additional,dialogResults,nps,isFinished&from=2022-06-29T00%3A00%3A00%2B00%3A00&to=2022-06-30T00%3A00%3A00%2B00%3A00&sort=-updatedAt&limit=1000&offset=0


Блок кода
languagepy
themeDJango
firstline1
titleОтвет в формате Json

...

{

...

linenumberstrue
collapsetrue
{
    "count": 2,

...


    "items":

...

        {

...

 [
        {
            "timezone": 3,

...


            "additional": "",

...


            "startedAt": "2022-06-29T08:44:26.000000Z",

...


            "transferredToOperator": false,

...


            "dialogId": "9e0b5349-9cb5-44a9-b5f4-bbec60ceff01",

...


            "duration": 18,

...


            "createdAt": "2022-06-29T05:44:14.000000Z",

...


            "price": "1.79",

...


            "dialogResults": "Приветствие",

...


            "id": "99c5b0fe-fa95-40e8-8a47-f90774c336cd",

...


            "botId": "c837b555-5d79-4c9a-940d-84814a0d6fb9",

...


            "recordPath": "https://minio.twin24.ai/twin-cabinet-prod/public/records//1758/2022/06/29/99c5b0fe-fa95-40e8-8a47-f90774c336cd.mp3",

...


            "updatedAt": "2022-06-29T08:45:01.000000Z",

...


            "botName": "Скрипт_тест",

...


            "externalId": null,

...


            "responder": "Human",

...


            "isFinished": true,

...


            "nps": null,

...


            "shortNumber": null,

...


            "phone": "79999999999",

...


            "regionId": 5026,

...


            "taskName": "29.6.2022 тестирование метода создания задания на обзвон",

...


            "taskId": "71c30c27-4211-4e96-8ce7-fbb459aee6fe",

...


            "linkToLog": "/ab37a460-9cdd-491b-9e91-a888fed03194/general.log",

...


            "status": "ANSWERED",

...


            "messages":

...

                {

...

 [
                {
                    "text": "Ало! Здравствуйте, меня хорошо слышно?",

...


                    "author": "robot",

...


                    "created_at": "2022-06-29T08:44:39Z"

...

                },

                {

...


                },
                {
                    "text": "угу",

...


                    "author": "user",

...


                    "created_at": "2022-06-29T08:44:46Z"

...

                },

                {

...


                },
                {
                    "text": "Отлично! Меня зовут Иван. Я менеджер по работе с клиентами компании Тест. Я не отниму много вашего времени. Вам удобно сейчас разговаривать?",

...


                    "author": "robot",

...


                    "created_at": "2022-06-29T08:44:46Z"

...

                }

            ],

...


                }
            ],
            "messagesAsString": "Робот: Ало! Здравствуйте, меня хорошо слышно?\nЧеловек: угу\nРобот: Отлично! Меня зовут Иван. Я менеджер по работе с клиентами компании Тест. Я не отниму много вашего времени. Вам удобно сейчас разговаривать?"

...

        },

        {

...


        },
        {
            "timezone": 3,

...


            "additional": "",

...


            "startedAt": "2022-06-29T07:15:50.000000Z",

...


            "transferredToOperator": false,

...


            "dialogId": "35541af1-ed44-447a-9312-0377462247fd",

...


            "duration": 5,

...


            "createdAt": "2022-06-29T04:10:31.000000Z",

...


            "price": "0.40",

...


            "dialogResults": "Начало диалога",

...


            "id": "819206ed-2391-4e8d-b8c3-8ec6ebf08f20",

...


            "botId": "c837b555-5d79-4c9a-940d-84814a0d6fb9",

...


            "recordPath": "https://minio.twin24.ai/twin-cabinet-prod/public/records//1758/2022/06/29/819206ed-2391-4e8d-b8c3-8ec6ebf08f20.mp3",

...


            "updatedAt": "2022-06-29T07:16:13.000000Z",

...


            "botName": "Скрипт_тест",

...


            "externalId": null,

...


            "responder": "AnsweringMachine",

...


            "isFinished": false,

...


            "nps": null,

...


            "shortNumber": null,

...


            "phone": "79999999999",

...


            "regionId": 5026,

...


            "taskName": "29.6.2022 тестирование метода создания задания на обзвон",

...


            "taskId": "71c30c27-4211-4e96-8ce7-fbb459aee6fe",

...


            "linkToLog": "/ed7168f7-0e1b-41dc-bab3-8f6047a9146b/general.log",

...


            "status": "ANSWERED",

...


            "messages":

...

                {

...

 [
                {
                    "text": "Ало! Здравствуйте, меня хорошо слышно?",

...


                    "author": "robot",

...


                    "created_at": "2022-06-29T07:16:04Z"

...

                }

            ],

...


                }
            ],
            "messagesAsString": "Робот: Ало! Здравствуйте, меня хорошо слышно?"

...

        }

    ]


        }
    ]
}


Описание полей ответа:

 

Поле

Тип

Описание

count

int

Общее количество звонков

items

itemsInfo[

]

Массив информации по каждому звонку

timezone

int

Часовой пояс номера телефона клиента

additional

string

Дополнительная информация, переданная в информации о клиенте, на этапе загрузки

startedAt

string

Дата и время запуска звонка

transferredToOperator

bool

Признак, отвечающий за то, был перевод звонка на оператора КЦ или нет

dialogId

string

Идентификатор диалога

duration

int

Длительность диалога в секундах

createdAt

string

Дата и время создания записи

price

string

Стоимость диалога

dialogResults

string

Результат диалога бота, указанный в поле «Подтверждения» в сценарии диалога

id

string

Идентификатор звонка

botId

string

Идентификатор работавшего бота

recordPath

string

Ссылка на аудиозапись диалога

updatedAt

string

Дата и время обновления информации по записи

botName

string

Имя работавшего бота

externalId

string

Информация, переданная в информации о клиенте, на этапе загрузки

responder

string

Тип ответившего на звонок, при работающем модуле определения автоответчиков

isFinished

bool

Признак, отвечающий за то, будут ли на данного клиента еще попытки дозвона, или данная попытка была последней

nps

string

Результат диалога бота, указанный в поле «NPS» в сценарии диалога

shortNumber

string

"Короткий" номер клиента (используется для sip-телефонии)

phone

string

Номер телефона клиента

regionId

int

Идентификатор региона, в котором оформлен номер телефона клиента

taskName

string

Имя задания на обзвон

taskId

string

Идентификатор задания на обзвон

linkToLog

string

Ссылка на лог звонка, по которой разбирают различные ситуации наши инженеры

status

string

Статус результата дозвона телефонии

messages

messagesInfo[

]

Массив с транскрибацией диалога по ролям и с доп информацией

text

string

Транскрибация реплики author

author

string

Роль того, кто произнес реплику (клиент или робот)

created_at

string

Дата начала озвучивания реплики

messagesAsString

string

Текстовая транскрибация всего диалога, по ролям, без доп информации