POST Tạo tác vụ tương tác tùy chỉnh
Tạo tác vụ tương tác tùy chỉnh Shop Scope bắt buộc: seller.customer_engagement.write Tạo một tác vụ tương tác sử dụng tin nhắn tùy chỉnh do bạn tự định nghĩa thay vì các mẫu tin nhắn được định sẵn từ TikTok Shop. Tác vụ này đó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 của tác vụ trên các loại nội dung khác nhau. Lưu ý rằng mỗi tác vụ có một thời gian kết thúc bắt buộc, và một khi đã hết hạn, nó không thể được dùng để gửi thêm tin nhắn. Phiên bản 202502
POST/customer_engagement/202502/engagement_tasks/custom
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 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 trên 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 các 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 UUID v4 để dùng làm key. |
| shop_cipher Required | string | Sử dụng property 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 |
|---|---|---|
| task_name Required | string | Tên của tác vụ. |
| end_time Required | int | Thời điểm mà tác vụ 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 tương tác. Chỉ hỗ trợ TIKTOK_IM. |
| product_ids | []string | Các product ID mà bạn muốn đưa vào dưới dạng thẻ tương tác trong tin nhắn. Lấy giá trị này từ Search Products API.Số lượng tối đa: 4 |
| coupon_ids | []string | Các coupon ID mà bạn muốn đưa vào dưới dạng thẻ tương tác trong tin nhắn. Số lượng tối đa: 1Bạn chỉ có thể thêm các coupon có một trong các bộ property sau:- coupons.display_type=REGULAR và coupons.target_buyer_segment=ALL- coupons.display_type=REGULAR và coupons.target_buyer_segment=REPEAT_CUSTOMERS.Tìm coupon ID và các property từ Search Coupons API. |
| custom_message | object | Tin nhắn tùy chỉnh để gửi đến khách hàng. |
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
Xem các mã lỗi thường gặp
| Code | Message | | --- | --- | | 68008004 | Policy violation. The message contains content that violates TikTok Shop policies. Modify it and try again. | | 68008016 | You're currently ineligible to send customized messages. Please use a message template. | | 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