Bắt đầu

sem.chat API cho phép bạn quản lý các cuộc hội thoại, gửi tin nhắn và truy cập phân tích theo chương trình. Tất cả các yêu cầu API đều yêu cầu xác thực bằng khóa API.

URL cơ sở

https://api.sem.chat/v1

Xác thực

Bao gồm khóa API của bạn trong tiêu đề Cấp phép của tất cả các yêu cầu:

Authorization: Bearer your_api_key_here

Cuộc trò chuyện

Liệt kê các cuộc trò chuyện

GET /conversations

Truy xuất danh sách tất cả các cuộc hội thoại cho tài khoản của bạn.

tham số Kiểu Sự miêu tả
giới hạn số nguyên Số kết quả trả về (tối đa 100)
bù lại số nguyên Số kết quả bỏ qua
trạng thái sợi dây Lọc theo trạng thái: đang hoạt động, đã đóng, đang chờ xử lý

Nhận cuộc trò chuyện

GET /conversations/{id}

Truy xuất thông tin chi tiết về một cuộc trò chuyện cụ thể bao gồm tất cả tin nhắn.

Tạo cuộc trò chuyện

POST /conversations

Bắt đầu một cuộc trò chuyện mới theo chương trình.

Tin nhắn

Gửi tin nhắn

POST /conversations/{id}/messages

Gửi tin nhắn đến cuộc trò chuyện hiện có.

// Example request body { "content": "Hello, how can I help you today?", "sender": "agent" }

Webhook

Thiết lập webhooks để nhận thông báo theo thời gian thực về các sự kiện hội thoại.

Sự kiện có sẵn

Sự kiện Sự miêu tả
cuộc trò chuyện.bắt đầu Một cuộc trò chuyện mới đã được bắt đầu
tin nhắn.đã nhận Một tin nhắn mới đã được nhận từ một khách truy cập
cuộc trò chuyện.đã đóng Một cuộc trò chuyện đã bị đóng
chì.capture Thông tin liên hệ đã được thu thập

Giới hạn tỷ lệ

Yêu cầu API được giới hạn để đảm bảo sử dụng hợp lý:

Kế hoạch Giới hạn tỷ lệ
Sự thử nghiệm 100 yêu cầu/giờ
Pro 1.000 yêu cầu/giờ
Kinh doanh 10.000 yêu cầu/giờ