Thiết lập vai trò cho thành viên
HTTP Request
POST https://{app_id}.api.piscale.com/open-api/v1.0/chat/threads/{thread_id}/members/set-role
Request header
Bảng mô tả tham số của request header:
Tên | Kiểu dữ liệu | Mô tả | Bắt buộc |
---|---|---|---|
X-Api-Key | string | API Key của ứng dụng | ✓ |
X-Tenant-Id | string | Chỉ định tenant của thread | ✗ |
Parameters
Tên | Kiểu dữ liệu | Mô tả | Bắt buộc |
---|---|---|---|
thread_id | string | Mã cuộc hội thoại | ✓ |
Request body
Ví dụ
{
"role": "admin",
"member_ids": ["u_1", "u_2"],
"id_type": 1,
}
Tên | Kiểu dữ liệu | Mô tả | Bắt buộc |
---|---|---|---|
role | string | Một trong các giá trị sau: [owner , admin , member ] | ✓ |
member_ids | string | Danh sách user_id . Các phần tử có kiểu dữ liệu là string | ✓ |
id_type | number | 1: ext_user_id của PiScale, 2: user_id của khách hàng đã đồng bộ | ✓ |
note
Hệ thống sẽ chỉ xử lý những thành viên đã nằm trong cuộc hội thoại. Với role = owner
thì bạn chỉ cần truyền member_ids có 1 phần tử
Response
Nếu thành công, bạn sẽ nhận được phản hồi.
Ví dụ
{
"message_code": "M200",
"message": "Thành công"
}
Tên | Kiểu dữ liệu | Mô tả |
---|---|---|
message_code | string | Mã thông điệp. Xem chi tiết |
message | string | Nội dung mã thông điệp |