Tham chiếu

Giữ hội thoại

Giữ một cuộc trò chuyện để trong lúc đó không ai khác nhắn cho người này: 30 phút, gia hạn mỗi lần bạn gửi vào hoặc giữ lại (số phút trên 30 chỉ giữ 30); chiến dịch phải chờ, agent khác bị từ chối, người trong nhóm thấy ai đang giữ. Hãy giữ trước khi xử lý một khách; muốn phụ trách lâu dài thì dùng phân công. force=true giành lại từ một người hoặc agent khác và cần người dùng xác nhận.

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ã	`conversations.claim`
Scope cần	`messages.send`
Mức	Ghi
Có thể cần xác nhận	Có
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ư → dải Tiếp quản

Trường vào

Trường	Kiểu	Bắt buộc
`conversationId`	`uuid`	Có
`minutes`	`số nguyên`	Không
`force`	`đúng/sai`	Không

Ví dụ gọi

curl -X POST https://tlg.builera.app/api/public/v2/ops/conversations.claim \
  -H "Authorization: Bearer $TELEGRAM_AUTO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"conversationId":"00000000-0000-0000-0000-000000000000"}'

Trường ra (`data`)

Trường	Kiểu	Bắt buộc
`ok`	`true`	Có
`holder`	`đối tượng`	Có
`label`	`chữ`	Có
`until`	`chữ`	Có
`displaced`	`null \| đối tượng`	Có

Ví dụ trả về

{
  "data": {
    "ok": true,
    "holder": {
      "kind": "human",
      "id": "00000000-0000-4000-8000-000000000000"
    },
    "label": "text",
    "until": "text",
    "displaced": {
      "kind": "human",
      "id": "00000000-0000-4000-8000-000000000000"
    }
  }
}

Dùng qua MCP

Tool conversations_claim có tên sẵn trong profile: Vận hành realtime (realtime), Đầy đủ (full). Ở profile khác, tìm bằng tools_search rồi chạy bằng tools_run.

Giữ hội thoại

#Thông tin

#Trường vào

#Ví dụ gọi

#Trường ra (data)