GET Lấy Tin Nhắn Hội Thoại
Lấy Tin Nhắn Hội Thoại Shop Scope bắt buộc: seller.customer_service Sử dụng API này để lấy tất cả tin nhắn trong một hội thoại giữa người mua và một shop. Gọi API này không đánh dấu các tin nhắn là đã đọc. Bạn nên gọi Read Message
để đánh dấu các tin nhắn là đã đọc. Version 202309
GET/customer_service/202309/conversations/{conversation_id}/messages
Request
Path
| Properties | Type | Description |
|---|---|---|
| conversation_id Required | string | ID hội thoại |
Header
| Properties | Type | Description |
|---|---|---|
| content-type Required | string | Loại được phép: application/json |
| x-tts-access-token Required | string | Giá trị access_token của người bán lấy từ Get Access Token, khi user_type = 0. Làm theo hướng dẫn này để lấy access_token của người bán. |
Query
| Properties | Type | Description |
|---|---|---|
| app_key Required | string | Mỗi app sẽ có một key duy nhất. Vui lòng sử dụng key cụ thể được cấp cho app của bạn. |
| sign Required | string | Chữ ký được tạo bởi thuật toán gen. Khi bạn gửi yêu cầu API đến TTS, bạn phải ký chúng để TTS có thể nhận diện người gửi. |
| timestamp Required | int | Unix timestamp GMT (UTC+00:00). Timestamp này được sử dụng trong tất cả các yêu cầu API. Nhà phát triển có thể dùng để chuyển đổi sang giờ địa phương. |
| page_token | string | Con trỏ phân trang, cho biết truy vấn này nên bắt đầu từ đâu. Đối với trang tiếp theo, sử dụng "next_page_token" trong response. |
| page_size Required | int | Số lượng hội thoại trong một trang. Tối đa 10. |
| locale | string | Ngôn ngữ hiển thị của tin nhắn hệ thống. Các tin nhắn do Hệ thống gửi sẽ được trả về theo ngôn ngữ cài đặt; Các tin nhắn do người mua, shop, nhân viên CS gửi sẽ không bị ảnh hưởng. Giá trị mặc định là en (English).Các giá trị enum có thể có:- de-DE (German, Germany)- en (English)- en-GB (English, United Kingdom)- es-ES (Spanish, Spain)- es-MX (Spanish, Latin America)- fr-FR (French, France)- id-ID (Indonesian, Indonesia)- it-IT (Italian, Italy)- ja-JP (Japanese)- ms-MY (Malay, Malaysia)- th-TH (Thai, Thailand)- vi-VN (Vietnamese, Vietnam)- pt-BR (Portuguese, Brazil)- zh-CN (Simplified Chinese, China) |
| sort_order | string | Thứ tự sắp xếp.Các giá trị enum có thể có:- DESC(default)- ASC |
| sort_field | string | Sắp xếp tin nhắn theo một trong các thuộc tính sau:- create_time (default)- index |
| need_data | bool | Cần message.data |
| need_plaintext | bool | Cần message.plaintext |
| time_zone | string | Múi giờ để định dạng ngày và giờ trong tin nhắn. Các timestamp trong tin nhắn sẽ được trả về theo múi giờ được chỉ định; nội dung tin nhắn khác sẽ không bị ảnh hưởng.Giá trị phải tuân theo định dạng múi giờ IANA (ví dụ: Asia/Shanghai, America/Los_Angeles). Giá trị mặc định là UTC. |
| shop_cipher Required | string | Sử dụng thuộc tính này để truyền thông tin shop khi gọi API. Việc không truyền đúng giá trị khi gọi API cho các shop xuyên biên giới sẽ trả về response không chính xác. Lấy bằng API Get Authorization Shop |
Example
CurlGoNode.jsJavaEnable word wrap
Response Parameters
| Properties | Type | Description |
|---|---|---|
| code | int | Mã trạng thái thành công hoặc thất bại được trả về trong response API. |
| message | string | Thông báo thành công hoặc thất bại được trả về trong response API. Lý do thất bại sẽ được mô tả trong message. |
| request_id | string | Log yêu cầu |
| data | object | Thông tin trả về cụ thể |
Example
JSONEnable word wrap
Error Code
Xem các mã lỗi phổ biến
| Code | Message | | --- | --- | | 45101001 | Lỗi nội bộ. Vui lòng thử lại sau hoặc liên hệ đội ngũ hỗ trợ kỹ thuật để được trợ giúp. | | 45101003 | Không tìm thấy bản ghi. Vui lòng kiểm tra các tham số. | | 45101004 | Đã đạt đến hạn mức truy vấn (10000 yêu cầu mỗi ngày). Vui lòng thử lại vào ngày mai. | | 36009003 | Lỗi nội bộ. Vui lòng thử lại. Nếu vấn đề vẫn tiếp diễn sau nhiều lần thử, vui lòng liên hệ hỗ trợ nền tảng. |
Nội dung này có hữu ích không?Hữu ích
Không hữu ích
PreviousNext