Tham chiếu

Danh sách cuộc gọi

Cuộc gọi thoại Telegram 1:1 của các tài khoản bạn được xem, mới nhất trước: chiều (đi/đến), trạng thái, lý do kết thúc, thời lượng, ai đang giữ tiếng (epoch), chất lượng tóm tắt. Lọc theo tài khoản, hội thoại, đang diễn ra/đã xong. Không bao giờ trả khoá tiếng, access hash hay địa chỉ IP.

Xem MarkdownTrang này sinh tự động từ mã nguồn mỗi lần phát hành.

Thông tin

Tên	Giá trị
Mã	`calls.list`
Scope cần	`messages.read`
Mức	Chỉ đọc
Có thể cần xác nhận	Không
Kiểu chạy	Trả kết quả ngay
Cần `Idempotency-Key`	Không
Vai trò thành viên được phép	`owner`, `manager`, `agent`
Trong app	Hộp thư → chat riêng → nút Gọi / lịch sử cuộc gọi

Trường vào

Trường	Kiểu	Bắt buộc
`accountId`	`uuid`	Không
`conversationId`	`uuid`	Không
`state`	`"live" \| "ended" \| "all"`	Không
`limit`	`số nguyên`	Không
`cursor`	`chữ`	Không

Ví dụ gọi

curl -X POST https://tlg.builera.app/api/public/v2/ops/calls.list \
  -H "Authorization: Bearer $TELEGRAM_AUTO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

Trường ra (`data`)

Trường	Kiểu	Bắt buộc
`items`	`đối tượng[]`	Có
`next_cursor`	`null \| chữ`	Có

Ví dụ trả về

{
  "data": {
    "items": [
      {
        "id": "00000000-0000-4000-8000-000000000000",
        "accountId": "00000000-0000-4000-8000-000000000000",
        "conversationId": "00000000-0000-4000-8000-000000000000",
        "peerId": "00000000-0000-4000-8000-000000000000",
        "direction": "outgoing",
        "state": "active",
        "endReason": "failed",
        "errorCode": "text",
        "origin": "automation",
        "initiatedVia": "telegram",
        "emoji": "text",
        "quality": {},
        "audio": {
          "epoch": 1,
          "heldBy": "text",
          "since": "text"
        },
        "startedAt": "2026-10-22T12:00:00.000Z",
        "ringingAt": "2026-10-22T12:00:00.000Z",
        "answeredAt": "2026-10-22T12:00:00.000Z",
        "endedAt": "2026-10-22T12:00:00.000Z",
        "durationSec": 1,
        "updatedAt": "2026-10-22T12:00:00.000Z"
      }
    ],
    "next_cursor": "text"
  }
}

Dùng qua MCP

Không có tên sẵn trong profile nào: gọi tools_describe rồi tools_run với code: "calls.list". Tên tool khi được liệt kê: calls_list.

Danh sách cuộc gọi

#Thông tin

#Trường vào

#Ví dụ gọi

#Trường ra (data)