SubizTài liệu API
Hội thoại và tin nhắn

API 4.0

Giao agent phụ trách

Giao cho một agent cụ thể phụ trách hội thoại.

POSThttps://api.subiz.com.vn/4.0/accounts/{accid}/conversations/{cid}

Dùng endpoint này để đặt người phụ trách hội thoại, tức assignee, là một agent cụ thể. Dùng khi chuyển giao, ví dụ khi CRM của bạn quyết định nhân viên bán hàng nào chăm sóc khách hàng.

Trước khi bắt đầu

  • Lấy Bearer access token và ID tài khoản.
  • Lấy ID của một agent có sẵn trong tài khoản.

Body yêu cầu

Trường Kiểu Mô tả
accid (đường dẫn) string ID tài khoản của bạn.
cid (đường dẫn) string Hội thoại cần giao.
assignee string ID agent sẽ phụ trách hội thoại.
{
  "assignee": "agent_example"
}

Route này cập nhật thông tin hội thoại. Khi giao việc, chỉ gửi assignee.

Phản hồi

Yêu cầu thành công trả HTTP 200 cùng Conversation đã cập nhật. Một số trường:

{
  "id": "conversation_example",
  "account_id": "account_example",
  "state": "active",
  "assignee": "agent_example"
}

Khi người phụ trách thay đổi, Subiz phát sự kiện conversation_assigned. Webhook đã đăng ký sẽ nhận được; xem Hội thoại được giao.

Giao việc không phải là tham gia

Giao agent không thêm họ vào members. Nếu agent cũng cần tham gia, hãy mời agent nữa.

Bỏ giao việc

Gửi assignee rỗng và thêm x-fields=assignee vào query string:

POST https://api.subiz.com.vn/4.0/accounts/YOUR_ACCID/conversations/YOUR_CID?x-fields=assignee
Authorization: Bearer YOUR_ACCESS_TOKEN
Content-Type: application/json

{
  "assignee": ""
}

x-fields liệt kê các trường cần cập nhật. Nếu thiếu, giá trị rỗng được coi là “không cung cấp” và người phụ trách giữ nguyên. Bỏ người phụ trách sẽ phát sự kiện conversation_unassigned.

Phân bổ tự động là việc khác

POST /4.1/conversations/{cid}/assign yêu cầu Subiz chạy lại phân bổ tự động. Nó không nhận ID agent. Dùng endpoint trên trang này để chọn một agent cụ thể.

Yêu cầu HTTP

Thay YOUR_ACCID, YOUR_CID, YOUR_AGENT_ID và YOUR_ACCESS_TOKEN bằng giá trị của bạn.

POST https://api.subiz.com.vn/4.0/accounts/YOUR_ACCID/conversations/YOUR_CID
Authorization: Bearer YOUR_ACCESS_TOKEN
Content-Type: application/json

{
  "assignee": "YOUR_AGENT_ID"
}