(14) Tin nhắn mới
1. Tình huống kích hoạt
Webhook new message được kích hoạt khi một tin nhắn mới được gửi trong cuộc trò chuyện chăm sóc khách hàng.
2. Tham số nghiệp vụ dữ liệu
| Parameter name | Data type | Sample | Description |
|---|---|---|---|
| message_id | string | 7494560109732334263 | Định danh của tin nhắn |
| index | string | 7494560109732334274 | Chỉ số tin nhắn có thể dùng để sắp xếp các tin nhắn. Tin nhắn mới hơn có chỉ số lớn hơn. |
| conversation_id | string | 576486316948490001 | Định danh của cuộc trò chuyện |
| type | string(enum) | TEXT | Loại tin nhắn, với các giá trị có thể có: * TEXT * IMAGE * ALLOCATED_SERVICE * NOTIFICATION * BUYER_ENTER_FROM_TRANSFER * BUYER_ENTER_FROM_PRODUCT * BUYER_ENTER_FROM_ORDER * PRODUCT_CARD * ORDER_CARD * EMOTICONS * VIDEO * COUPON_CARD *LOGISTICS_CARD * OTHER |
| content | string | {"content": "simple text message"} | Nội dung tin nhắn, ở dạng chuỗi JSON đã được tuần tự hóa. Ví dụ: * TEXT: {"content": "simple text"} * IMAGE: { "height": "290", "url": "https://tosv.boei18n.byted.org/obj/temai-im/FszkJ53nSapYG6KDaJQmqR3jjoZGwww304-290", "width": "304" } * PRODUCT_CARD, BUYER_ENTER_FROM_PRODUCT: {"product_id": "12345"} * ORDER_CARD, BUYER_ENTER_FROM_ORDER : {"order_id": "12345"} * VIDEO: { "url": "https://video-boei18n.byted.org/storage/v1/tos-boei18n-v-c72c01/e8240f35244646428df9c3244d1a7408?x-tos-algorithm=v2&x-tos-authkey=5bf25627da095a5cba28ace592de46cc&x-tos-expires=1681980481&x-tos-signature=r_bRxtrvGhXAuZgMmNhlZ_Upqzg", "cover": "https://p-boei18n.byted.org/tos-boei18n-v-c72c01/o8keEOhzTcNCcJyAbkWZwpLIyTfkJxcGbRBvLP~tplv-jvtte31kaf-origin-jpeg.jpeg?", "width": 640, "height": 360, "duration": "20.504", "vid": "v0e30cg700f7cgcmu8jc77u9e2bdp95g", "expire_time": "1681980481", "format": "mp4", "size": 400000, "bit_rate": 156067, "quality": "original", "codec_type": "h264" } * LOGISTICS_CARD: { "order_id": "580874485811283206", "package_id": "123456" // Optional (recommended for one order with multiple packages; not required for one order with one package) } * COUPON_CARD: {"coupon_id": "7262992004278206762"} Lưu ý: Dùng Get Coupon để lấy chi tiết của coupon. * ALLOCATED_SERVICE, NOTIFICATION, BUYER_ENTER_FROM_TRANSFER, OTHER: {"content": "simple text"} |
| create_time | int | 1691411573 | Thời gian tạo tin nhắn, biểu diễn dưới dạng Unix timestamp (giây). |
| is_visible | bool | true | Tin nhắn này có nên được hiển thị cho bộ phận chăm sóc khách hàng hay không. |
| sender | Object | Người gửi tin nhắn. Đối với vai trò hệ thống và robot, shop là người gửi. |
Ví dụ sự kiện
JSONWord Wrap
{
"type": 14,
"tts_notification_id": "7327112393057371910",
"shop_id": "7494049642642441621",
"timestamp": 1644412885,
"data": {
"content": "{\"content\":\"444\"}",
"conversation_id": "710688832392260838",
"create_time": 1681790246,
"is_visible": true,
"message_id": "722323407926368819",
"index": "7494560109732334274",
"type": "TEXT",
"sender": {
"im_user_id": "707885565181165594",
"role": "BUYER"
}
}
}