POST Gửi tin nhắn tương tác
Gửi tin nhắn tương tác Shop Scope yêu cầu: seller.customer_engagement.write Gửi tin nhắn đến các khách hàng cụ thể cho một tác vụ tương tác nhất định. Phiên bản 202412
POST/customer_engagement/202412/messages
Request
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 API request đế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 dùng cho tất cả các API request. Nhà phát triển có thể dùng để 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ề response không chính xác. Lấy qua API Get Authorization Shop |
Body
| Properties | Type | Description |
|---|---|---|
| buyer_emails Required | []string | Địa chỉ email đã được ẩn danh của người mua. Lấy giá trị này từ Get Order Details API.Lưu ý: Bạn chỉ có thể gửi tin nhắn đến những người mua đã đặt ít nhất một đơn hàng với shop trong vòng 365 ngày qua. |
| task_id | string | ID của tác vụ tương tác khách hàng liên quan. Sử dụng giá trị được trả về khi bạn gọi Create Engagement Task API.Lưu ý: Đảm bảo tác vụ vẫn đang hoạt động. Bạn không thể gửi tin nhắn đến các tác vụ đã kết thúc. |
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 API response. |
| message | string | Thông báo thành công hoặc thất bại được trả về trong API response. Lý do thất bại sẽ được mô tả trong thông báo. |
| request_id | string | Nhật ký request |
| 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 | | --- | --- | | 68009001 | Truy cập bị từ chối. Endpoint này không khả dụng cho shop này vì người bán không đáp ứng tiêu chí truy cập cho các tính năng CRM. Xem TikTok Shop Academy để biết chi tiết. | | 68009002 | Tác vụ được chỉ định đã kết thúc, và việc gửi tin nhắn không còn được cho phép. | | 68009003 | Địa chỉ người dùng không hợp lệ | | 68009004 | Không thể gửi tin nhắn đến email người mua được chỉ định vì người mua chưa đặt đơn hàng nào với shop trong vòng 365 ngày qua. |
Nội dung này có hữu ích không?Hữu ích
Không hữu ích
PreviousNext