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

Ключ

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

...

Поле

Обязательно

Принимаемые значения

Описание

fieldsда
  1. id
  2. taskName
  3. taskId
  4. createdAt
  5. startedAt
  6. finishedAt
  7. billedAt
  8. updatedAt
  9. speakerFinishedAt
  10. number
  11. callingNumber
  12. botId
  13. botName
  14. timezone
  15. messagesAsString
  16. resultsString
  17. variablesString
  18. clientExternalId
  19. dialogResult
  20. advStatus_ru
  21. nps
  22. duration
  23. externalId
  24. recordPath
  25. currentStatusName
  26. mainCallDiscount
  27. mainCallDuration
  28. robotCallDuration
  29. transferCallDuration
  30. companyId
  31. companyName
  32. price
  33. resellerPrice
  34. resellerCompanyId
  35. resellerCompanyName
  36. mainCallCost
  37. mainCallTotalCost
  38. robotCallCost
  39. robotCallTotalCost
  40. transferCallCost
  41. transferCallTotalCost
  42. isIncoming
  43. amd
Поле 
  1. autoCallCandidateId

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

limittoнетЦелое число от 1 до 1000Количество записей на одной странице. Максимум 1000. 
offsetнетЦелое число от 0"Отступ" от начала записей. То есть с какой записи начинать вывод.

page

нет

Целое число от 0

Номер "страницы" с записями.

from

нет

url encoded дата в формате:

ГГГГ-ММ-ДДTчч:мм:сс+чч:мм 

Например:

decoded: 2023-06-13T00:00:00+00:

url encoded дата в формате:

ГГГГ-ММ-ДДTчч:мм:сс+чч:мм 

Например:

decoded: 2023-06-13T00:00:00+00:00 

encoded: 2023-06-13T00%3A00%3A00%2B00%3A00

 

Дата и время конца начала поиска статистики.

Поле, по которому высчитывается дата, указывается в параметре periodBy. По умолчанию – startedAt.

fieldsнет

Любые значения, перечисленные через запятую без пробела:

taskName,taskId,taskCreatedAt,taskUpdatedAt,taskStatus,callId,startedAt,number,callingNumber,
botId,botName,regionName,timezone,messagesAsString,messages,resultsString,allResults,emotion,
hungUpBy,gender,nps,isAssistantRequest,markers,duration,externalId,clientExternalId,additional,
recordPath,currentStatusName,humanStatusName,mainCallDiscount,mainCallDuration,autoCallCost,
autoCallDiscount,autoCallDuration,autoCallTotalCost,robotCallDiscount,robotCallDuration,transferCallDiscount,
transferCallDuration,companyId,autoCallCandidateId,amd,isCallEfficiency,mainCallTotalCost,robotCallTotalCost,
transferCallTotalCost,totalCost,mainCallCost,robotCallCost,transferCallCost,variables-count

Список полей, которые необходимо вывести.

Примечание

Если не передавать параметр, то будут выведены все поля, кроме variables. 

variables-var_name - поле, содержащее значение стартовой переменной с именем var_name, переданной при добавлении кандидата (как через апи метод, так и через интерфейс или excell реестр)

limitнетЦелое число от 1 до 1000Количество записей на одной странице. Максимум 1000. 
offsetнетЦелое число от 0"Отступ" от начала записей. То есть с какой записи начинать вывод.

page

нет

Целое число от 0

Номер "страницы" с записями.

archive

нет

true/false

Упаковать выданный файл в архив. Актуально только при наличии output.

output

нет

CSV/EXCEL

Выдать файл в CSV или EXCEL. Если не передавать, то в ответе будет json.

filename

нет

Строка

Название файла. Актуально только при наличии output.

callId

нет

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

Фильтрация по идентификатору звонка.

withPrice

нет

true/false

Если true, то в ответе будут звонки только с ненулевой стоимостью.

sort

нет

+startedAt, +duration, -startedAt, -duration

Способ сортировки и поле, по которому будет сортировка. 

"+" - по возрастанию.

"-" - по убыванию.

periodBy

нет

createdAt, updatedAt, startedAt, finishedAt, billedAt

Поле, по которому будет работать фильтрация по from и to.

По умолчанию: startedAt.

Рекомендуется использовать createdAt, как наиболее эффективный. 

autoCallCandidateId

нет

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

Фильтрация по идентификатору кандидата.

taskId

нет

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

Фильтрация по идентификатору задания.

 

toнет

url encoded дата в формате:

ГГГГ-ММ-ДДTчч:мм:сс+чч:мм 

Например:

decoded: 2023-06-13T00:00:00+00:00 

encoded: 2023-06-13T00%3A00%3A00%2B00%3A00 

Дата и время конца поиска статистики.

companyIdнетцелое числоИдентификатор компании в TWIN
phoneнетцелое числоНомер телефона
isIncomingнетtrue/falsetrue - если входящие; false - если исходящие
sortнетcreatedAt, startedAt, finishedAt, billedAt, speakerFinishedAt, duration, price. По умолчанию сортировка происходит по полю startedAt.Каждое поле сортировки может иметь специальный префикс, указывающий желаемый порядок сортировки: + (по возрастанию, по умолчанию) или - (по убыванию)
taskIdнетцелое числоИдентификатор задания на обзвон
idнетцелое числоИдентификатор звонка.
statusнетCANCEL, ANSWERED, NOANSWER, BUSY, CONGESTION, CHANUNAVAIL, FAILED, BLACKLIST, DIAL, INPROGRESS, FZ230, INVALID, UNAVAILABLE, EMPTY_AONТекущий статус звонка.
FilterPeriodByнетcreatedAt, updatedAt, startedAt. По умолчанию используется поле startedAt. Дата в формате ISO8601

фильтрации по начальной и конечной датам.

autoCallCandidateIdнетцелое числоИдентификатор кандидата
Блок кода
languagepy
themeDJango
titleОтвет в формате JSON
collapsetrue
{
    "count": 1,
    "items": [
Блок кода
languagepy
themeDJango
titleОтвет в формате JSON
collapsetrue
{
    "count": 1,
    "items": [
        {
            "taskName": "Имя задания на обзвон",
            "taskId": "bce7d22e-dde6-4427-b391-ebbdfda44de6",
            "taskCreatedAt": "2024-01-16 02:01:10+00",
            "taskUpdatedAt": "2024-01-16 02:03:18+00",
            "taskStatus": "DONE",
            "callId": "bce7d22e-dde6-4427-b391-ebbdfda44de6",
            "startedAt": "2024-01-16 02:01:31",
            "number": "74992868344",
            "callingNumber": "74992868344",
            "botId": "bce7d22e-dde6-4427-b391-ebbdfda44de6",
            "botName": "Имя сценария бота",
            "regionName": "г. Москва",
            "timezone": 3,
            "messagesAsString": "BOT: Привет! Как дела, Иван?\nCLIENT: нормально\nBOT: Хорошо, пока!",
            "messages": [
                {
                    "authorType": "BOT",
                    "createdAt": "2024-01-16T02:01:37.135151+00:00",
                    "body": "Привет! Как дела, Иван?"
                },
                {
                    "authorType": "CLIENT",
                    "createdAt": "2024-01-16T02:01:43.098529+00:00",
                    "body": "нормально"
              {
  },
          "id": "687bec28-1b47-42df-955c-b88b40b2cb75",
     {
       "taskName": "999",
            "authorTypetaskId": "BOTc8e64c09-8d3e-4c5f-9403-5f57b085de5b",
                    "createdAt": "20242023-0107-16T0231T22:0100:43.197626+00:0031.666566Z",
                    "bodystartedAt": "Хорошо, пока!"
                }
2023-07-31T22:00:31.665221Z",
             ]"finishedAt": "2023-07-31T22:00:44.483259Z",
            "resultsStringbilledAt": "Подтверждение: Значение поля 'подтверждение результата'2023-07-31T22:01:01.795661Z",
            "allResults": {
 updatedAt": "2023-07-31T22:01:01.804529Z",
               "npsspeakerFinishedAt": "Значение поля NPS2023-07-31T22:00:44.483000Z",
                "custom_result"number": "Значение поля 'произвольный результат' с ключом custom_result70000000000",
                "confirmationcallingNumber": "Значение поля 'подтверждение результата'"70000000001",
            } "botId": "687bec28-1b47-42df-955c-b88b40b2cb73",
            "emotionbotName": null"тест",
            "hungUpBytimezone": "Робот"10800,
            "gendermessagesAsString": "BOT: Добрый nullдень,
 меня зовут Ирина, я  сотрудник компании TWIN. Как я могу "nps": "Значение поля NPSк вам обращаться? !",
            "isAssistantRequestresultsString": null"{}",
            "markersvariablesString": "Первый маркер;Второй маркер;Третий маркер",
            "duration": 39,
            "externalId": "bce7d22e-dde6-4427-b391-ebbdfda44de6{\"m_0\": null, \"m_1\": \"1\", \"recordPath\": \"https://tcl.twin24.ai/#/record/687bec28-1b47-42df-955c-b88b40b2cb73/download\"}",
            "clientExternalIddialogResult": "123"null,
            "additionaladvStatus_ru": null"Успешный",
            "recordPathnps": "https:///#/record/bce7d22e-dde6-4427-b391-ebbdfda44de6/download"null,
            "currentStatusNameduration": "ANSWERED"5,
            "humanStatusNameexternalId": "Answered687bec28-1b47-42df-955c-b2cb73",
            "mainCallDiscountclientExternalId": "0103532154",
            "mainCallDurationrecordPath": 39"https://minio.twin24.ai/twin-cis-production/records/1672/2023/8/1/111111111.2867994_79881043184_1672.mp3",
            "autoCallCostcurrentStatusName": "0ANSWERED",
            "autoCallDiscountmainCallDiscount": "0",
            "autoCallDurationmainCallDuration": "0"5,
            "autoCallTotalCostrobotCallDuration": "0"5,
            "robotCallDiscounttransferCallDuration": "0",
            "robotCallDurationcompanyId": 3900001,
            "transferCallDiscountcompanyName": "000001 | ТВИН",
            "transferCallDurationprice": "0.270000",
            "companyIdresellerPrice": 1"0.000000",
            "autoCallCandidateIdresellerCompanyId": "bce7d22e-dde6-4427-b391-ebbdfda44de6"null,
            "amdresellerCompanyName": "Не проверялось"null,
            "isCallEfficiencymainCallCost": "Результативный1.30",
            "mainCallTotalCost": "0.8511",
            "robotCallTotalCostrobotCallCost": "12.3000",
            "transferCallTotalCostrobotCallTotalCost": null"0.17",
            "totalCosttransferCallCost": "2.1450000",
            "mainCallCosttransferCallTotalCost": "1.30"null,
            "robotCallCostisIncoming": "2.00"false,
            "transferCallCostamd": "0"null,
            "variables-nameautoCallCandidateId": "Иван687bec28-1b47-42df-955c-b88b40b2cb73"
        }
    ]
}

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

...