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

Ключ

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

...

Поле

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

Описание

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
  44. autoCallCandidateId

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

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

page

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

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

from

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

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

Например:

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

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

 

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

 

to

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

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

Например:

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

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

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

companyIdцелое числоИдентификатор компании в TWIN. Используется для фильтрации. Сессии не отвечающие заданному параметру не будут добавлены в ответ. 
phoneцелое числоНомер телефона. Используется для фильтрации. Сессии не отвечающие заданному параметру не будут добавлены в ответ. 
callingNumberцелое числоНомер телефона. Используется для фильтрации. Сессии не отвечающие заданному параметру не будут добавлены в ответ. 
isIncomingtrue/false

true - если входящие; false - если исходящие.

*Используется для фильтрации. Сессии не отвечающие заданному параметру не будут добавлены в ответ. 

sortcreatedAt, startedAt, finishedAt, billedAt, speakerFinishedAt, duration, price. По умолчанию сортировка происходит по полю startedAt.Каждое поле сортировки может иметь специальный префикс, указывающий желаемый порядок сортировки: + (по возрастанию, по умолчанию) или - (по убыванию).
taskIdцелое числоИдентификатор задания на обзвон. Используется для фильтрации. Сессии не отвечающие заданному параметру не будут добавлены в ответ. 
idцелое числоИдентификатор звонка. Используется для фильтрации. Сессии не отвечающие заданному параметру не будут добавлены в ответ. 
statusCANCEL, ANSWERED, NOANSWER, BUSY, CONGESTION, CHANUNAVAIL, FAILED, BLACKLIST, DIAL, INPROGRESS, FZ230, INVALID, UNAVAILABLE, EMPTY_AONТекущий статус звонка. Используется для фильтрации. Сессии не отвечающие заданному параметру не будут добавлены в ответ. 
FilterPeriodBycreatedAt, updatedAt, startedAt. По умолчанию используется поле startedAt. Дата в формате ISO8601

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

autoCallCandidateIdцелое числоИдентификатор кандидата. Используется для фильтрации. Сессии не отвечающие заданному параметру не будут добавлены в ответ. 
Блок кода
languagepy
themeDJango
titleОтвет в формате JSON
{
    "count": 1,
    "items": [
        {
            "id": "db5cb7fb-dc3e-4197-a7f5-93f63dc5bfbd",
            "taskName": "TWIN TEST",
            "taskId": "db5cb7fb-dc3e-4197-a7f5-93f63dc5bfbd",
            "createdAt": "2024-01-01T00:00:18.722982Z",
            "startedAt": "2024-01-01T00:00:18.722136Z",
            "finishedAt": "2024-01-01T00:00:38.484110Z",
            "billedAt": "2024-01-01T00:00:57.902230Z",
            "updatedAt": "2024-01-01T00:00:57.908504Z",
            "speakerFinishedAt": "2024-01-01T00:00:38.484000Z",
            "number": "70000000000",
            "callingNumber": "70000000001",
            "botId": "db5cb7fb-dc3e-4197-a7f5-93f63dc5bfbd",
            "botName": "TWIN BOT",
            "timezone": 10800,
            "messagesAsString": "BOT:  Добрый день, как ваши дела? \nCLIENT: Привет, дела - хорошо.",
            "resultsString": "{\"nps\": \"Успех\", \"confirmation\": \"Успех\"}",
            "variablesString": "{\"tryNumber\": 0, \"recordPath\": \"https://tcl.twin24.ai/record/db5cb7fb-dc3e-4197-a7f5-93f63dc5bfbd/download\", \"humanNumber\": 0, \"resultNumber\": 0, \"tryCandidate\": 0, \"answeredNumber\": 0, \"humanCandidate\": 0, \"resultCandidate\": 0, \"answeredCandidate\": 0}",
            "dialogResult": "Успех",
            "advStatus_ru": "Успешный",
            "nps": "Успех",
            "duration": 17,
            "externalId": "db5cb7fb-dc3e-4197-a7f5-93f63dc5bfbd",
            "clientExternalId": null,
            "recordPath": "https://minio.twin24.ai/twin-cis-production/records/1672/2024/1/1/0000000000000000000000000_1_1.mp3",
            "currentStatusName": "ANSWERED",
            "mainCallDiscount": "0",
            "mainCallDuration": 17,
            "robotCallDuration": 17,
            "transferCallDuration": 0,
            "companyId": 1758,
            "companyName": "0001 | ТВИН: TEST",
            "price": "0.0",
            "resellerPrice": "0.000000",
            "resellerCompanyId": null,
            "resellerCompanyName": null,
            "mainCallCost": "0.00",
            "mainCallTotalCost": "0.0",
            "robotCallCost": "0.00",
            "robotCallTotalCost": "0.0",
            "transferCallCost": "0",
            "transferCallTotalCost": null,
            "isIncoming": false,
            "amd": "NOT_DEF",
            "autoCallCandidateId": "db5cb7fb-dc3e-4197-a7f5-93f63dc5bfbd"
        }
    ]
}

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

ПолеОписаниеТип поля
countОбщее количество записей.

Integer

itemsМассив записей.Array[Object]
|    idИдентификатор звонка.String
|   taskNameИмя задания на обзвон.String
|    taskIdИдентификатор задания на обзвон.String
|    createdAtДата и время создания звонка.String
|    startedAtДата и время запуска звонка.String
|    finishedAtДата и время окончания звонка.String
|    billedAtДата и время расчета стоимости выполнения звонка.String
|    updatedAtДата и время последнего обновления информации о звонке.String
|    speakerFinishedAt

Дата и время окончания работы бота.

String
|    number

Номер телефона на который идет звонок. Для входящих вызов номер телефона к которому подключён бот.

String
|    callingNumber

Номер телефона с которого идет звонок. Для исходящих вызовов номер телефона к которому подключён бот.

String
|    botIdИдентификатор сценария бота.String
|    botNameИмя сценария бота.String
|    timezoneСмещение временной зоны в секундах относительно UTC.Integer
|    messagesAsStringТранскрибация диалога. Содержит полную транскрибацию в формате строки.  String
|    resultsStringСохраненные в блоке "Результат" данные: Подтверждение; NPS; Произвольный результат.String
|    variablesStringСтартовые переменные.String
|    dialogResult

Значение поля подтверждение из блока результат.

String
|    advStatus_ru

Результативность звонка (из настроек задания или блока "зафиксировать эффективность")

String
|    npsЗначение из блока "Результат" в NPS.String
|    durationПродолжительность звонка в секундах.Integer
|    externalId

Используется только для нужд тех поддержки.

String
|    clientExternalId

Идентификатор, который добавлен самостоятельно при добавлении кандидата.

String
|    recordPath

Ссылка на запись разговора.

String
|    currentStatusName

Текущий статус задания на обзвон.

Возможные значения:

  • CANCEL – Отменен
  • ANSWERED – Успешный;
  • NOANSWER – Нет ответа;
  • BUSY – Абонент занят;
  • CONGESTION – Вызов отклонен оператором связи;
  • CHANUNAVAIL – Нет связи с телефонной линией;
  • FAILED – Ошибка;
  • SCHEDULED – Запланирован;
  • BLACKLIST – В черном списке;
  • DIAL – Набор номера;
  • INPROGRESS – В процессе;
  • FZ230 – Запрет звонка по ФЗ-230;
  • INVALID – Ошибка формата номера;
  • UNAVAILABLE – Номер недоступен;
  • EXPIRED – Срок ожидания соединения истек.

String

|    mainCallDiscountСкидка за разговор.String
|    mainCallDurationДлительность разговора в секундах.Integer
|    robotCallDurationПродолжительность работы робота в секундах.Integer
|    transferCallDurationДлительность звонка после перевода в секунадх.Integer
|    companyIdИдентификатор компании.Integer
|    companyNameИдентифиактор компании и имя компании. В формате: "ИДЕНТИФИКАТОР КОМПАНИИ | НАЗВАНИЕ КОМПАНИИ"String
|    priceСтоимость всего разговора.String
|    resellerPriceСтоимость разговора для реселлера.String
|    resellerCompanyIdИдентификатор компании реселлера.String
|    resellerCompanyNameИмя компании реселлера.String
|    mainCallCostСтоимость телефонии.String
|    mainCallTotalCostОбщая стоимость звонка.String
|    robotCallCost

Стоимость разговора робота.

String
|    robotCallTotalCostСтоимость разговора робота со скидкой.String
|    transferCallCostСтоимость разговора после перевода.String
|    transferCallTotalCostСтоимость разговора после перевода со скидкой.Boolean
|    isIncomingВходящий/Исходящий вызов (true/false).Boolean
|    amdРежим работы определителя человека или робота.
Может принимать значения:
  • HUMN - человек
  • MACH - робот
  • NOT_DEF - определить выключен.
String
|    autoCallCandidateIdИдентификатор кандидата.String