POST Send Message
Gửi tin nhắn Shop Scope bắt buộc: seller.customer_service Sử dụng API này để gửi tin nhắn cho người mua trong một cuộc hội thoại. Phiên bản 202606
POST/customer_service/202606/conversations/{conversation_id}/messages
Request
Path
| Properties | Type | Description |
|---|---|---|
| conversation_id Required | string | ID cuộc hội thoại |
Header
| Properties | Type | Description |
|---|---|---|
| content-type Required | string | Loại được cho phép: application/json |
| x-tts-access-token Required | string | Giá trị access_token của người bán 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 gán 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 các yêu cầu API tới 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 trên tất cả các yêu cầu API. Nhà phát triển có thể dùng nó để chuyển đổi sang giờ địa phương. |
| 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ề phản hồi không chính xác. Lấy bằng API Get Authorization Shop |
Body
| Properties | Type | Description |
|---|---|---|
| type Required | string | Loại tin nhắn. Các giá trị enum khả dụng:- TEXT- IMAGE- VIDEO- PRODUCT_CARD- ORDER_CARD- RETURN_REFUND_CARD- COUPON_CARD- LOGISTICS_CARD |
| content Required | string | Nội dung tin nhắn, ở dạng chuỗi JSON đã được tuần tự hóa.Ví dụ về content cho mỗi loại tin nhắn được liệt kê dưới đây:- TEXT:{ "content": "hi, I want to get refunded."}(Lưu ý: Tối đa 2000 ký tự. Không sử dụng các từ nhạy cảm vi phạm điều khoản & chính sách của TikTok Shop.)- VIDEO{ "vid": "v10394g5000cd499vc7og65mqn3r3dg0"}- LOGISTICS_CARD{ "order_id": "580874485811283206", "package_id": "123456" // Optional (recommended for one order with multiple packages; not required for one order with one package)}- PRODUCT_CARD{ "product_id": "7494560109732334265"}- ORDER_CARD:{ "order_id": "7494560109732334267"}- RETURN_REFUND_CARD:{ "order_id": "7494560109732334267", "sku_id": "7494560109732363423"}Lưu ý: Đơn hàng của RETURN_REFUND_CARD cần gửi phải đáp ứng các điều kiện sau bán hàng. Để kiểm tra tính đủ điều kiện, sử dụng Get Aftersale Eligibility.- IMAGE:{ "url":"https://p16-oec-va.ibyteimg.com/tos-maliva-i-o3syd03w52-us/2ca53c34ad8443e6b39f4e0153d3aed4~tplv-o3syd03w52-origin-image.image?from=1320446476", "width": 1280, "height": 720}Lưu ý: Bạn có thể lấy giá trị của url bằng cách gọi Upload Buyer Messages Image.- COUPON_CARD:{ "coupon_id": "7262992004278206762"}Lưu ý: Các coupon có thể được gửi trong tin nhắn phải đáp ứng tất cả các điều kiện sau:1. display_type==CHAT hoặc display_type==REGULAR2. status==ONGOING3. creation_source==SELLER_CENTER4. target_buyer_segment!=REPEAT_CUSTOMERS |
| sender_role | string | Vai trò gửi tin nhắn.- 'CUSTOMER_SERVICE' : Tin nhắn được trả lời bởi nhân viên chăm sóc khách hàng thực- 'SYSTEM': Phản hồi được kích hoạt tự động bởi hệ thống, chẳng hạn như tin nhắn chào mừng và phản hồi khi hết thời gian- 'ROBOT': Tin nhắn được trả lời bởi robot thông minh |
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 phản hồi API. |
| message | string | Thông báo thành công hoặc thất bại được trả về trong phản hồi API. Lý do thất bại sẽ được mô tả trong message. |
| request_id | string | Nhật ký yêu cầu |
| data | object | Thông tin trả về cụ thể |
Example
JSONEnable word wrap
Error Code
View common error codes
| 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. | | 45101002 | Tham số không hợp lệ. RETURN_REFUND_CARD phải đáp ứng các điều kiện được liệt kê ở trên. | | 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 ngạch truy vấn (10000 yêu cầu mỗi ngày). Vui lòng thử lại vào ngày mai. | | 45101006 | Bạn không thể gửi tin nhắn chứa nội dung nhạy cảm. Vui lòng kiểm tra tin nhắn. | | 36009003 | Lỗi nội bộ. Vui lòng thử lại. Nếu sự cố vẫn tiếp diễn sau nhiều lần thử, vui lòng liên hệ hỗ trợ nền tảng. | | 45102007 | Không có quyền truy cập cuộc hội thoại này. Có thể có lỗi hỏng dữ liệu. Vui lòng thử lại sau hoặc liên hệ đội ngũ hỗ trợ kỹ thuật để được trợ giúp. | | 45109001 | Không thể gửi tin nhắn do quy tắc cuộc hội thoại. Để biết chi tiết, vui lòng tham khảo Customer Service API overview. | | 45111001 | không hỗ trợ | | 45111007 | Người mua đã đạt đến giới hạn nhận tối đa cho coupon này. | | 45111012 | Không gửi được tin nhắn coupon card do vượt quá giới hạn QPS. Giới hạn QPS khi gửi tin nhắn coupon card là 0.5. | | 45111017 | Tham số không hợp lệ. COUPON_CARD phải đáp ứng các điều kiện được liệt kê ở trên. |
Nội dung này có hữu ích không?Hữu ích
Không hữu ích
PreviousNext