POST Tạo cuộc trò chuyện với creator
Tạo cuộc trò chuyện với creator Shop Scope bắt buộc: seller.affiliate_messages.write Lấy cuộc trò chuyện hiện có hoặc tạo cuộc trò chuyện mới với creator TikTok được chỉ định để liên lạc sau này. Phiên bản 202508
POST/affiliate_seller/202508/conversations
Request
Header
| Properties | Type | Description |
|---|---|---|
| content-type Required | string | Kiểu được cho phép: application/json |
| x-tts-access-token Required | string | Giá trị seller access_token từ Get Access Token, khi user_type = 0. Làm theo hướng dẫn này để lấy seller access_token. |
Query
| Properties | Type | Description |
|---|---|---|
| app_key Required | string | Mỗi app sẽ có một key riêng. 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 giá trị này để 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 giá trị đúng 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 |
|---|---|---|
| creator_open_id Required | string | Creator Open ID. Chi tiết thêm |
| only_need_conversation_id | bool | - Nếu true, chỉ conversation_id trong data.conversation được trả về. - Nếu false, tất cả các trường trong data.conversation được trả về. Mặc định là true. |
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 | Các 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 | | --- | --- | | 16030001 | creator has been cleard | | 16030002 | shop has reached IM quota. More information please check [https://seller.tiktokglobalshop.com/university/essay?identity=1&role=1&knowledge_id=2766765165102865&from=feature_guide] | | 16030003 | This shop cannot message the creator at the moment because the Affiliate GMV requirement has not been met. | | 16030007 | shop status invalid | | 16030009 | test account isolate. please don't use the test account to send message. | | 16032001 | nvalid parameter Creator and Seller, please ensure Region mismatch. | | 45101021 | unauthorized operation on users who hit privacy control | | 36009003 | Internal error. Please try again. If the issue persists after multiple attempts, please contact platform support. |
Nội dung này có hữu ích không?Hữu ích
Không hữu ích
PreviousNext