API Reports — Call Logs

Authentication chung: Header Authorization (X-Api-Key) bắt buộc với tất cả endpoint. Kong dual-auth: ưu tiên X-Tenant-ID header, fallback query DB theo key.

Base URL: Dev: https://xapi-dev.alohub.vn  |  Prod: https://xapi.alohub.vn

POST /v1/reports/call-logs

Lấy danh sách call logs với bộ lọc theo số điện thoại, khoảng thời gian, loại cuộc gọi và phân trang. Trả về thông tin tóm tắt mỗi cuộc gọi kèm customerName liên kết.

Authentication: Header X-Api-Key, scope: report

Lưu ý: Endpoint này dùng POST (không phải GET) vì filter được truyền qua request body.

Request Body

{
  "phoneNumber": "0912345678",
  "callStartTime": "2026-04-14T00:00:00+07:00",
  "callEndtime": "2026-04-20T23:59:59+07:00",
  "callType": 0,
  "page": 1,
  "limit": 50
}

Gotcha: Field backend là callEndtime (typo — chữ t thường). FE phải gửi đúng chính tả, nếu không filter endTime sẽ không được apply.

Code mẫu

curl -X POST "https://xapi.alohub.vn/v1/reports/call-logs" \
  -H "X-Api-Key: sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "phoneNumber": "0912345678",
    "callStartTime": "2026-04-14T00:00:00+07:00",
    "callEndtime": "2026-04-20T23:59:59+07:00",
    "callType": 0,
    "page": 1,
    "limit": 50
  }'

const axios = require('axios');
const response = await axios.post(
  '{{host}}/api/v1/reports/call-logs',
  {
    phoneNumber: '0912345678',
    callStartTime: '2026-04-14T00:00:00+07:00',
    callEndtime: '2026-04-20T23:59:59+07:00',   // ⚠️ typo: lowercase t
    callType: 0,
    page: 1,
    limit: 50
  },
  { headers: { 'X-Api-Key': '{{api-key}}' } }
);
console.log(response.data);

import requests
payload = {
    "phoneNumber": "0912345678",
    "callStartTime": "2026-04-14T00:00:00+07:00",
    "callEndtime": "2026-04-20T23:59:59+07:00",  # typo: lowercase t
    "callType": 0,
    "page": 1,
    "limit": 50
}
response = requests.post(
    '{{host}}/api/v1/reports/call-logs',
    json=payload,
    headers={"X-Api-Key": "{{api-key}}"}
)
print(response.json())

Response 200

{
  "success": "1",
  "error_code": "SUCCESS",
  "error_message": "SUCCESS",
  "totalRecord": 3829,
  "data": [
    {
      "callId": "20260310095227-ABCXYZ-342",
      "caller": "0912345678",
      "called": "alohub2",
      "startTime": "21/01/2026 09:52:33",
      "waitingTime": "6",
      "firstRingTime": "21/01/2026 09:52:35",
      "firstConnectTime": "",
      "agentId": "AloHub",
      "endTime": "21/01/2026 09:52:41",
      "acdTime": "0",
      "description": "INBOUND-Khách hàng kết thúc trước khi timeout",
      "customerName": "0912345678",
      "url": ""
    }
  ]
}

Response Fields

Duplicate rows: Response có thể trả về nhiều row cùng callId với customerName khác nhau — do BE JOIN call với bảng customer (1-n). FE nên dedup nếu muốn hiển thị 1 row/call: Array.from(new Map(data.map(r => [r.callId, r])).values())

Error Codes

Rate Limit Headers

GET /v1/reports/call-logs/{callId}

Lấy chi tiết một cuộc gọi theo callId, bao gồm thông tin caller/called, agent xử lý, thời gian, thời lượng, trạng thái kết thúc và URL file ghi âm.

Authentication: Header X-Api-Key, scope: report

Lưu ý thời gian: Các field thời gian (startTime, endTime, ...) là string format dd/MM/yyyy HH:mm:ss theo UTC+7, không phải ISO 8601 — FE cần parse thủ công.

Path Parameters

Request Body

Không có (method GET).

Code mẫu

curl -X GET "https://xapi.alohub.vn/v1/reports/call-logs/20260310095227-ABCXYZ-342" \
  -H "X-Api-Key: sk_live_xxx" \
  -H "Accept: application/json"

const axios = require('axios');
const callId = '20260310095227-ABCXYZ-342';
const response = await axios.get(
  `{{host}}/api/v1/reports/call-logs/${encodeURIComponent(callId)}`,
  { headers: { 'X-Api-Key': '{{api-key}}' } }
);
// response.data.data[0] là object chi tiết (null nếu không tìm thấy)
console.log(response.data.data[0]);

import requests
call_id = '20260310095227-ABCXYZ-342'
response = requests.get(
    f'{{host}}/api/v1/reports/call-logs/{call_id}',
    headers={"X-Api-Key": "{{api-key}}"}
)
data = response.json()
# data["data"][0] là object chi tiết
print(data["data"][0] if data["data"] else None)

Response 200

{
  "success": "1",
  "error_code": "SUCCESS",
  "error_message": "SUCCESS",
  "totalRecord": 1,
  "data": [
    {
      "callId": "20260310095227-ABCXYZ-342",
      "caller": "0912345678",
      "called": "alohub2",
      "agentId": "AloHub",
      "startTime": "21/01/2026 09:52:33",
      "endTime": "21/01/2026 09:52:41",
      "ringTime": "21/01/2026 09:52:35",
      "connectTime": "",
      "answerTime": 0,
      "duration": 8,
      "callType": "0",
      "description": "INBOUND-Khách hàng kết thúc trước khi timeout",
      "customerName": "20260107172924-KZGTVFTE-600",
      "recordingUrl": ""
    }
  ]
}

Response Fields

Khác biệt với List API: answerTime và duration là number (không phải string như waitingTime/acdTime ở list). Field ghi âm là recordingUrl (detail) vs url (list). Thời điểm chuông là ringTime (detail) vs firstRingTime (list).

Error Codes

Rate Limit Headers