Перейти к содержанию

Информация о звонке

Метод получения детальной информации о звонке в Лайнере по его идентификатору.


Адрес и метод

GET /v2/call/detail/{callId}/

callId
Идентификатор звонка в Лайнере. Значение > 0


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

curl -X GET "https://YOUR_LINER_API_HOST/v2/call/detail/{callId}" \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: YOUR_API_TOKEN"
<?php

$host = 'https://YOUR_LINER_API_HOST';
$token = 'YOUR_API_TOKEN';
$callId = (int)$callId;

$ch = curl_init($host . '/v2/call/detail/' . $callId);
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Content-Type: application/json',
        'X-Api-Key: ' . $token,
    ],
    CURLOPT_TIMEOUT => 15,
]);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);

if ($response === false) {
    throw new RuntimeException('cURL error: ' . curl_error($ch));
}

curl_close($ch);

echo "HTTP {$httpCode}\n";
echo $response;
const host = "https://YOUR_LINER_API_HOST";
const token = "YOUR_API_TOKEN";
const callId = Number(callId);

const res = await fetch(`${host}/v2/call/detail/${callId}`, {
  method: "GET",
  headers: {
    "Content-Type": "application/json",
    "X-Api-Key": token
  }
});

const data = await res.json();
console.log("HTTP", res.status, data);

Пример ответа

{
  "success": true,
  "message": "",
  "data": {
    "id": "{{id}}",
    "sipEndpointId": "{{sipEndpointId}}",
    "finishInitiator": "{{finishInitiator}}",
    "direction": "{{direction}}",
    "leadId": "{{leadId}}",
    "userId": "{{userId}}",
    "orderId": "{{orderId}}",
    "statusCode": "{{statusCode}}",
    "totalDurationSeconds": "{{totalDurationSeconds}}",
    "waitTimeDurationSeconds": "{{waitTimeDurationSeconds}}",
    "talkTimeDurationSeconds": "{{talkTimeDurationSeconds}}",
    "isPredictive": "{{isPredictive}}",
    "clientPhone": "{{clientPhone}}",
    "hasRecords": "{{hasRecords}}",
    "createdAt": "{{createdAt}}"
  }
}

Поля ответа

Поле Тип Описание
id int Идентификатор звонка в Лайнере.
sipEndpointId int Идентификатор виртуального номера (SIP endpoint).
finishInitiator string Инициатор завершения звонка. Доступные значения: client, operator, system.
direction string Направление звонка. Доступные значения: incoming, outgoing.
leadId int Идентификатор Лида, к которому относится звонок.
userId int Идентификатор пользователя, который обработал звонок.
orderId int Идентификатор заказа, к которому относится звонок.
statusId int Идентификатор статуса звонка.
totalDurationSeconds int Общая длительность звонка.
waitTimeDurationSeconds int Общая длительность ожидания ответа.
talkTimeDurationSeconds int Длительность разговора.
isPredictive bool Предиктивного ли звонок.
clientPhone string Телефон клиента (как правило, в формате E.164, например +79001234567).
hasRecords bool Есть ли сохраненная записи разговора у звонка.
createdAt string Дата и время создания записи о звонке (ISO 8601).

Примечание

Выше описана структура поля data. Общий формат ответа API см. в разделе Схема запросов