Gửi tin nhắn văn bản
PiScale cung cấp API gửi tin nhắn dạng văn bản. Bot có quyền gửi được tin nhắn khi Bot đã nằm trong cuộc hội thoại. Trong trường hợp Bot gửi tin nhắn đến người dùng mà cuộc hội thoại chưa được tạo, chúng tôi sẽ hỗ trợ. Chi tiết xem ở bảng mô tả các thuộc tính bên dưới.
HTTP request
POST https://{app_id}.api.piscale.com/chat-bot/v1.0/messages
Request body
Ví dụ
{
"thread_id": "",
"ext_user_ids": ["6872016393206779"],
"user_ids": [],
"body": {
"text": "Hello",
}
}
Tên | Kiểu dữ liệu | Mô tả | Bắt buộc |
---|---|---|---|
thread_id | string | Mã cuộc hội thoại | ✗ |
ext_user_ids | array | Danh sách ext_user_id | ✗ |
user_ids | array | Danh sách user_id | ✗ |
body.text | string | Nội dung văn bản | ✓ |
note
- Bắt buộc
thread_id
hoặcext_user_ids
hoặcuser_ids
phải có dữ liệu. - Đích đến của tin nhắn sẽ được ưu tiên theo thứ tự
thread_id
,ext_user_ids
,user_ids
. ext_user_ids
tối đa 1000 phần tử.user_ids
tối đa 100 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": "Success"
}
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 |