POST Create Engagement Task
Tạo Engagement Task Shop Scope yêu cầu: seller.customer_engagement.write Tạo một engagement task đóng vai trò như một vùng chứa để nhóm các tin nhắn có nội dung và quy tắc tương tự, cho phép người bán theo dõi và so sánh hiệu suất task giữa các loại nội dung khác nhau. Lưu ý rằng mỗi task có một thời gian kết thúc bắt buộc, và sau khi hết hạn, nó không thể được dùng để gửi thêm tin nhắn. Version 202412
POST/customer_engagement/202412/engagement_tasks
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 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 cho 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. |
| idempotency_key Required | string | Một key duy nhất để nhận diện một yêu cầu và ngăn việc xử lý trùng lặp cùng một yêu cầu, đặc biệt trong trường hợp gặp sự cố kết nối. Đảm bảo key này là duy nhất cho mỗi yêu cầu để tránh trùng lặp ngoài ý muốn.Lưu ý: Chúng tôi khuyến nghị bạn tạo v4 UUID để dùng làm key. |
| shop_cipher Required | string | Sử dụng property này để truyền thông tin shop khi yêu cầu API. Không truyền đúng giá trị khi yêu cầu 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 |
|---|---|---|
| template_id Required | string | ID của các template tin nhắn engagement được định nghĩa sẵn bởi TikTok Shop. Lấy giá trị từ Get Message Templates. |
| task_name Required | string | Tên của task. |
| end_time Required | int | Thời điểm task kết thúc, và tin nhắn sẽ không còn được gửi nữa. Unix timestamp (giây). |
| channel Required | string | Kênh engagement. Chỉ hỗ trợ TIKTOK_IM. |
| product_ids | []string | ID sản phẩm. Lấy giá trị này từ Search Products API. |
| coupon_ids | []string | ID coupon. Lấy giá trị này và các thông tin liên quan đến coupon khác từ Search Coupons API.Lưu ý: Các property của coupon phải tuân theo các quy tắc được định nghĩa trong coupon_card_rules.coupon_type của Get Message Templates API. |
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 | Request log |
| data | object | Thông tin trả về cụ thể |
Example
JSONEnable word wrap
Error Code
View common error codes
| Code | Message | | --- | --- | | 68009001 | Access denied. This endpoint is not available for this shop as the seller does not meet the access criteria for CRM features. See TikTok Shop Academy for details. | | 68009005 | Failed to create an engagement task. Error details: |
Nội dung này có hữu ích không?Hữu ích
Không hữu ích
PreviousNext