Hội thoạiGET

Chi tiết hội thoại

Trả về chi tiết một hội thoại theo thời gian thực. Truyền conversation_id qua query parameter (bằng giá trị trả về từ List conversations). Response luôn bao gồm conversation_id / type / title / avatar_url (chuỗi rỗng khi không có) cùng các trường riêng theo loại như members_count cho group; trả về 404 khi không tìm thấy hội thoại.

https://api.unifyport.ai/v1/accounts/{account_id}/conversations/info

Tiêu đề

X-Api-Key

stringbắt buộc

API key của không gian làm việc. Không gian làm việc được xác định từ tiêu đề này.

Tham số đường dẫn

account_id

stringbắt buộc

Định danh dùng cho route conversations.

Tham số truy vấn

conversation_id

stringbắt buộc

Cuộc trò chuyện cần tra cứu — giá trị được trả về dưới dạng conversation_id bởi Liệt kê hội thoại.

type

string

Loại cuộc trò chuyện (user, group hoặc channel) để phân định rõ việc tra cứu.

enum: user, group, channel

Nội dung yêu cầu

Điểm cuối này không cần nội dung JSON.

Nội dung phản hồi

conversation_id

string

Định danh cuộc trò chuyện. Dùng làm đích khi gửi tin nhắn hoặc gọi các route cuộc trò chuyện.

type

string

Loại cuộc trò chuyện: user, group hoặc channel.

enum: user, group, channel

title

string

Tiêu đề hiển thị của cuộc trò chuyện.

username

string

Username cuộc trò chuyện phía provider, khi có.

avatar_url

string

URL ảnh đại diện, hoặc chuỗi rỗng khi không được đặt.

description

string

Mô tả nhóm hoặc kênh, khi có sẵn.

last_message_at

string

Dấu thời gian RFC3339 của tin nhắn gần nhất.

format: date-time

last_message_text

string

Bản xem trước văn bản của tin nhắn gần nhất, khi có.

unread_count

integer

Số tin nhắn chưa đọc trong cuộc trò chuyện.

format: int64

members_count

integer

Số thành viên; trả về cho các cuộc trò chuyện nhóm.

format: int64

subscribers_count

integer

Số người đăng ký của cuộc trò chuyện dạng kênh, khi có.

format: int64

is_pinned

boolean

Tài khoản kết nối có ghim cuộc trò chuyện hay không.

is_muted

boolean

Tài khoản kết nối có tắt tiếng cuộc trò chuyện hay không.

created_at

string

Thời gian tạo cuộc trò chuyện do provider báo cáo, khi có.

format: date-time

extra

object

Các trường riêng của provider chưa được biểu diễn trong schema chuẩn.

Phản hồi

200

200 OK

Yêu cầu thành công. Xem ví dụ nội dung phản hồi.

400

Bad Request

Body, đường dẫn hoặc tham số yêu cầu không hợp lệ.

401

Unauthorized

Header X-Api-Key thiếu hoặc không hợp lệ.

404

Not Found

Không tìm thấy tài nguyên provider được yêu cầu.

409

Conflict

Thao tác đang yêu cầu xung đột với tài khoản hoặc tài nguyên nhà cung cấp đã có.

500

Internal Server Error

Dịch vụ gặp lỗi không mong muốn.

501

Not Implemented

Provider đã chọn chưa triển khai thao tác này.

502

Bad Gateway

Adapter hoặc upstream provider không thể hoàn tất thao tác.

Yêu cầu

curl -X GET https://api.unifyport.ai/v1/accounts/{account_id}/conversations/info?conversation_id=peer_example&type=group \
  -H "X-Api-Key: <YOUR_API_KEY>"

Phản hồi

{
  "data": {
    "conversation_id": "peer_example",
    "type": "group",
    "title": "Group title",
    "avatar_url": "",
    "description": "...",
    "unread_count": 0,
    "members_count": 42
  }
}