CCITU.ThirdPlatform.OpenApi 1.0.51

一、TikTok组件配置-基础配置

依赖包

Install-Package DocumentFormat.OpenXml 3.0.1
Install-Package Microsoft.Web.Infrastructure 1.0.0
Install-Package Newtonsoft.Json 13.0.3

配置：放入Web.config文件里

    //基础Api接口地址
    <add key="TikTokShop.BaseUrl" value="https://open-api.tiktokglobalshop.com" />
    //授权Api接口地址
    <add key="TikTokShop.AuthUrl" value="https://auth.tiktok-shops.com" />
    //非美国授权链接地址
    <add key="TikTokShop.AuthorizationLink-Non-US" value="https://services.tiktokshop.com" />
    //美国授权链接地址
    <add key="TikTokShop.AuthorizationLink-US" value="https://services.us.tiktokshop.com" />
    //版本号
    <add key="TikTokShop.Version" value="202309" />
    //配置TokenXml文件的物理路径
    <add key="TikTokShop.TokenXml" value="D:\TikTokShop\Token.xml" />
    //TikTok 合作伙伴中心应用页面中的应用密钥
    <add key="TikTokShop.AppKey" value="" />
    //合作伙伴中心应用页中的应用机密
    <add key="TikTokShop.AppSecret" value="" />
    //注册的在线应用程序（客户端）的唯一身份
    <add key="TikTokShop.ServiceId" value="" />

二、TikTok组件配置-获取店铺令牌（Token）

使用场景：

用于获取授权，接口授权。先调用返回授权确认页面的Url链接接口【区分美国/非美国】获得url链接，打开浏览器然后粘贴url访问授权，之后用返回的身份验证代码获取访问令牌

方法：

/// <summary>
/// 获取店铺Token
/// </summary>
public class TokenApi
{

    /// <summary>
    /// 获取访问令牌Token
    /// </summary>
    /// <returns></returns>
    public ResponseParameters<TikTokAccessTokenResponse> GetToken(TikTokAccessTokenQuery request);

    /// <summary>
    /// 刷新访问令牌Token
    /// </summary>
    /// <returns></returns>
    public ResponseParameters<TikTokAccessTokenRefreshResponse> GetRefreshToken(TikTokAccessTokenRefreshQuery request);

    /// <summary>
    /// 返回授权确认页面的Url链接(非美国授权链接)
    /// </summary>
    /// <param name="state">校验访问的随机数【可为空】</param>
    /// <returns></returns>
    public string GetAuthorizationLink(string state);

    /// <summary>
    /// 返回授权确认页面的Url链接(美国授权链接)
    /// </summary>
    /// <param name="state">校验访问的随机数【可为空】</param>
    /// <returns></returns>
    public string GetAuthorizationLinkUS(string state);
}

接口请求对象：

/// <summary>
/// TikTok的访问令牌请求响应对象
/// </summary>
public class TikTokAccessTokenQuery
{
    /// <summary>
    /// 此应用中tts卖家的唯一标识，不等于shop_id。请使用我们的商店 API 获取您的商店 ID：获取授权商店 API
    /// </summary>
    public string OpenId { get; set; }

    /// <summary>
    /// 用户在商铺获得的身份验证代码
    /// </summary>
    public string auth_code { get; set; }

}

官网参考地址：

访问令牌：https://partner.tiktokshop.com/docv2/page/64f199619495ef0281851e1c

三、TikTok组件配置-刷新访问令牌（Token）

使用场景：

用于获取授权，接口授权。

方法：

/// <summary>
/// 获取店铺Token
/// </summary>
public class TokenApi
{

    /// <summary>
    /// 获取访问令牌Token
    /// </summary>
    /// <returns></returns>
    public ResponseParameters<TikTokAccessTokenResponse> GetToken(TikTokAccessTokenQuery request);

    /// <summary>
    /// 刷新访问令牌Token
    /// </summary>
    /// <returns></returns>
    public ResponseParameters<TikTokAccessTokenRefreshResponse> GetRefreshToken(TikTokAccessTokenRefreshQuery request);

    /// <summary>
    /// 返回授权确认页面的Url链接(非美国授权链接)
    /// </summary>
    /// <param name="serviceId">您注册的在线应用程序（客户端）的唯一身份</param>
    /// <param name="state">校验访问的随机数【可为空】</param>
    /// <returns></returns>
    public string GetAuthorizationLink(string serviceId, string state);

    /// <summary>
    /// 返回授权确认页面的Url链接(美国授权链接)
    /// </summary>
    /// <param name="serviceId">您注册的在线应用程序（客户端）的唯一身份</param>
    /// <param name="state">校验访问的随机数【可为空】</param>
    /// <returns></returns>
    public string GetAuthorizationLinkUS(string serviceId, string state);
}

接口请求对象：

/// <summary>
/// 刷新TikTok的访问令牌请求响应对象
/// </summary>
public class TikTokAccessTokenRefreshQuery
{

    /// <summary>
    /// 此应用中tts卖家的唯一标识，不等于shop_id。请使用我们的商店 API 获取您的商店 ID：获取授权商店 API
    /// </summary>
    public string OpenId { get; set; }

    /// <summary>
    /// 刷新token
    /// </summary>
    public string refresh_token { get; set; }

}

官网参考地址：

刷新访问令牌Token：https://partner.tiktokshop.com/docv2/page/64f199619495ef0281851e1c

四、TikTok组件配置-获取授权商铺

使用场景：

用于获取授权店铺信息

方法：

/// <summary>
/// 查询商铺
/// </summary>
public class AuthorizationApi
{

    /// <summary>
    /// 查询商铺授权
    /// </summary>
    /// <param name="request"></param>
    /// <returns></returns>
    public ResponseParameters<shop> GetAuthorizedShops(GetAuthorizedShopsQuery request);

}

接口请求对象：

/// <summary>
/// 获取授权商店请求参数
/// </summary>
public class GetAuthorizedShopsQuery
{

    /// <summary>
    /// 此应用中tts卖家的唯一标识，不等于shop_id。请使用我们的商店 API 获取您的商店 ID：获取授权商店 API
    /// </summary>
    public string OpenId { get; set; }


}

官网参考地址：

获取授权商铺：https://partner.tiktokshop.com/docv2/page/6507ead7b99d5302be949ba9?external_id=6507ead7b99d5302be949ba9

五、TikTok组件配置-获取产品列表

使用场景：

用于获取产品列表。

方法：

/// <summary>
/// 获取产品列表
/// </summary>
public class ProductsApi
{

    /// <summary>
    /// 获取产品列表
    /// </summary>
    /// <param name="request"></param>
    /// <returns></returns>
    public ResponseParameters<List<WMSProductsDto>> SearchProducts(SearchProductsQuery request);

    /// <summary>
    /// 根据产品id获取产品详情
    /// </summary>
    /// <param name="request"></param>
    /// <returns></returns>
    public ResponseParameters<GetProductResponse> GetProduct(GetProductQuery request);

}

接口请求对象：

/// <summary>
/// 获取产品列表请求数据 
/// </summary>
public class SearchProductsQuery
{
    /// <summary>
    /// 此应用中tts卖家的唯一标识，不等于shop_id。请使用我们的商店 API 获取您的商店 ID：获取授权商店 API
    /// </summary>
    public string OpenId { get; set; }

    /// <summary>
    /// 店铺授权
    /// </summary>
    public string shop_cipher { get; set; }

    /// <summary>
    /// 列表分页
    /// “page_size”代表返回列表分页，即每页产品的品牌数量。每个页面最多可以检索 100 条产品记录。
    /// </summary>
    public int page_size { get; set; }


    /// <summary>
    /// 分页标记
    /// 分页标记是用于分页的游标。第一页不需要它。令牌在上一个分页查询中返回，以确定当前位置。
    /// </summary>
    public string page_token { get; set; }

    /// <summary>
    /// 产品状态，用作产品搜索的过滤标准。包括
    /// 全部、草稿、待定、失败、激活、SELLER_DEACTIVATED、PLATFORM_DEACTIVATED、冻结、已删除
    /// </summary>
    public string status { get; set; }

    /// <summary>
    /// 卖家 SKU，用于商品搜索的筛选条件。通过此字段，您可以搜索包含这些卖家 SKU 的所有商品。
    /// </summary>
    public List<string> seller_skus { get; set; }

    /// <summary>
    /// 字段“create_time_ge”和“create_time_le”共同构成了产品创建时间的筛选条件。如果您只填写“create_time_le”，而“create_time_ge”为空，
    /// 那么我们会默认将店铺最早时间设置为“create_time_ge”字段。如果只填写“create_time_ge”，而“create_time_le”为空，那么我们将默认将当前时间设置为“create_time_le”字段。
    /// 时间搜索条件使用 GMT （UTC+00：00） 中的 Unix 时间戳。
    /// </summary>
    public int create_time_ge { get; set; }

    /// <summary>
    /// 请参阅“create_time_ge”的说明
    /// </summary>
    public int create_time_le { get; set; }

    /// <summary>
    /// 字段“update_time_ge”和“update_time_le”共同构成产品更新时间的过滤条件。如果您只填写“update_time_le”，
    /// 而“update_time_ge”为空，那么我们会默认将商店的最早时间设置为“update_time_ge”字段。
    /// 如果只填写“update_time_ge”，而“update_time_le”为空，那么我们将默认将当前时间设置为“update_time_le”字段。
    /// </summary>
    public int update_time_ge { get; set; }

    /// <summary>
    /// 请参阅“update_time_ge”的说明。
    /// </summary>
    public int update_time_le { get; set; }

}

接口返回对象：

/// <summary>
/// WMS仓储产品模型对象
/// </summary>
public class WMSProductsDto
{
    /// <summary>
    /// 商品ID
    /// </summary>
    public string ProductId { get; set; }

    /// <summary>
    /// 所属平台
    /// TikTok Shop = 10
    /// </summary>
    public string OwnerPlatform { get; set; }

    /// <summary>
    /// 所属店铺ID
    /// </summary>
    public string OwnerShopId { get; set; }

    /// <summary>
    /// 	商品SKU
    /// </summary>
    public string ProductSku { get; set; }

    /// <summary>
    /// 商品名称
    /// </summary>
    public string ProductName { get; set; }

    /// <summary>
    /// 销售单价币种
    /// </summary>
    public string currency { get; set; }

    /// <summary>
    /// 销售单价
    /// </summary>
    public decimal SalesPrice { get; set; }

    /// <summary>
    /// 税前单价
    /// </summary>
    public decimal TaxExclusivePrice { get; set; }

    /// <summary>
    /// 状态
    /// </summary>
    public string Status { get; set; }

    /// <summary>
    /// 销售区域
    /// </summary>
    public List<string> SalesRegions { get; set; }

    /// <summary>
    /// 长
    /// </summary>
    public decimal Length { get; set; }

    /// <summary>
    /// 宽
    /// </summary>
    public decimal Width { get; set; }

    /// <summary>
    /// 高
    /// </summary>
    public decimal Height { get; set; }

    /// <summary>
    /// 尺寸单位
    /// </summary>
    public string MeasureUnit { get; set; }

    /// <summary>
    /// 毛重
    /// </summary>
    public decimal GrossWeight { get; set; }

    /// <summary>
    /// 重量单位
    /// </summary>
    public string WeightUnit { get; set; }



}

官网参考地址：

产品列表：https://partner.tiktokshop.com/docv2/page/65854ffb8f559302d8a6acda?external_id=65854ffb8f559302d8a6acda#Back%20To%20Top

六、TikTok组件配置-获取产品详情

使用场景：

用于获取产品详情。

方法：

/// <summary>
/// 获取产品列表
/// </summary>
public class ProductsApi
{

    /// <summary>
    /// 获取产品列表
    /// </summary>
    /// <param name="request"></param>
    /// <returns></returns>
    public ResponseParameters<List<WMSProductsDto>> SearchProducts(SearchProductsQuery request);

    /// <summary>
    /// 根据产品id获取产品详情
    /// </summary>
    /// <param name="request"></param>
    /// <returns></returns>
    public ResponseParameters<GetProductResponse> GetProduct(GetProductQuery request);

}

接口请求对象：

/// <summary>
/// 获取产品详情请求数据 
/// </summary>
public class GetProductQuery
{
    /// <summary>
    /// 此应用中tts卖家的唯一标识，不等于shop_id。请使用我们的商店 API 获取您的商店 ID：获取授权商店 API
    /// </summary>
    public string OpenId { get; set; }

    /// <summary>
    /// 店铺授权
    /// </summary>
    public string shop_cipher { get; set; }

    /// <summary>
    /// 产品id
    /// </summary>
    public string product_id { get; set; }

    /// <summary>
    /// “return_under_review_version”参数可用于获取正在审核产品的快照信息。
    /// - 如果 “return_under_review_version” 参数设置为 false，则会检索已经通过且处于 “已激活” 状态的产品的快照信息。
    /// - 如果 “return_under_review_version” 参数设置为 true，它将检索已获批但仍在审核中的产品的快照信息。
    /// - 如果 “return_under_review_version” 参数没有提供任何值，则默认为 false。
    /// </summary>
    public bool return_under_review_version { get; set; }
}

官网参考地址：

产品详情：https://partner.tiktokshop.com/docv2/page/6509d85b4a0bb702c057fdda?external_id=6509d85b4a0bb702c057fdda

七、TikTok组件配置-获取订单列表

使用场景：

用于获取订单列表。

方法：

/// <summary>
/// 获取订单列表
/// </summary>
public class OrdersApi
{

    /// <summary>
    /// 获取订单列表
    /// </summary>
    /// <param name="request"></param>
    /// <returns></returns>
    public ResponseParameters<List<WMSOrderDto>> GetOrderList(GetOrderListQuery request);
}

接口请求对象：

/// <summary>
/// 获取订单请求数据(请求查询参数)
/// </summary>
public class GetOrderListQuery
{

    /// <summary>
    /// 此应用中tts卖家的唯一标识，不等于shop_id。请使用我们的商店 API 获取您的商店 ID：获取授权商店 API
    /// </summary>
    public string OpenId { get; set; }

    /// <summary>
    /// 店铺授权
    /// </summary>
    public string shop_cipher { get; set; }

    /// <summary>
    /// 使用此字段可以指定在单个页面中获取的最大订单数。必须是 1-100。
    /// </summary>
    public int page_size { get; set; }

    /// <summary>
    /// 可用值：ASC;DESC（默认）
    /// </summary>
    public string sort_order { get; set; }

    /// <summary>
    /// 此字段值将在响应数据中返回，您可以使用它来搜索下一页上的数据。您不需要在第一次搜索时使用它。
    /// </summary>
    public string page_token { get; set; }

    /// <summary>
    /// create_time，update_time
    /// </summary>
    public string sort_field { get; set; }


    /***请求正文参数**/

    /// <summary>
    /// 使用此字段可获取处于特定状态的订单 - 未付款：订单已下达，但付款尚未完成。
    /// - ON_HOLD（目前ON_HOLD状态仅在英国市场可用）：付款已完成，但订单允许买家在未经卖家批准的情况下取消订单。不允许卖家在ON_HOLD状态下配送订单。
    /// - PARTIALLY_SHIPPING：订单中的一件或多件（但不是全部）商品已发货。
    /// - AWAITING_SHIPMENT：订单已准备好发货，但订单中没有商品已发货。
    /// - AWAITING_COLLECTION：卖家安排了发货，但包裹仍在等待将包裹交给承运人。
    /// - IN_TRANSIT：包裹已由承运人领取。
    /// - 已送达：包裹已交付给买家。
    /// - COMPLETED：订单已完成。订单不再允许发起退货或退款。
    /// - 已取消：订单已取消。
    /// </summary>
    public string order_status { get; set; }

    /// <summary>
    /// 用于选择在指定时间之后（或在指定时间）创建的订单的日期。只有指定时间之后下的订单才会被退回。Unix 时间戳。
    /// create_time_ge表示大于或等于create_time
    /// </summary>
    public int? create_time_ge { get; set; }

    /// <summary>
    /// 用于选择在指定时间之前（或在指定时间）创建的订单的日期。Unix 时间戳。
    /// create_time_lt代表不到create_time
    /// </summary>
    public int? create_time_lt { get; set; }

    /// <summary>
    /// 用于选择在指定时间之后（或在指定时间）上次更新的订单的日期。更新定义为订单状态的任何更改，包括创建新订单。包括 Tiktok 和卖家所做的更新。Unix 时间戳。
    /// update_time_ge表示大于或等于update_time
    /// </summary>
    public int? update_time_ge { get; set; }

    /// <summary>
    /// 用于选择在指定时间之前（或指定时间）最后更新的订单的日期。更新被定义为订单状态的任何更改，包括创建新订单。包括 Tiktok 和卖家进行的更新。Unix 时间戳。
    /// update_time_lt代表不到update_time
    /// </summary>
    public int? update_time_lt { get; set; }

    /// <summary>	
    /// 交货方式。
    /// - TIKTOK：Tiktok提供的运输服务。卖家应从 Tiktok 获取运输标签。
    /// - 卖方：卖方提供运输服务，包括代表卖方通过第三方履行提供商提供运输服务。
    /// </summary>
    public string shipping_type { get; set; }

    /// <summary>
    /// 买家 UID
    /// </summary>
    public string buyer_user_id { get; set; }

    /// <summary>
    /// 使用此字段可检索订单，该订单已从买方发起取消请求。
    /// </summary>
    public bool? is_buyer_request_cancel { get; set; }
}

官网参考地址：

订单列表：https://partner.tiktokshop.com/docv2/page/650aa8094a0bb702c06df242?external_id=650aa8094a0bb702c06df242

八、TikTok组件配置-获取运输提供商

使用场景：

用于获取运输提供商。

方法：

/// <summary>
/// 获取运输提供商
/// </summary>
public class LogisticsApi
{

    /// <summary>
    /// 获取运输提供商
    /// </summary>
    /// <param name="request"></param>
    /// <returns></returns>
    public ResponseParameters<GetShippingProvidersResponse> GetShippingProviders(GetShippingProvidersQuery request);
}

接口请求对象：

/// <summary>
/// 获取运输提供商请求参数
/// </summary>
public class GetShippingProvidersQuery
{
    /// <summary>
    /// 此应用中tts卖家的唯一标识，不等于shop_id。请使用我们的商店 API 获取您的商店 ID：获取授权商店 API
    /// </summary>
    public string OpenId { get; set; }

    /// <summary>
    /// 店铺授权
    /// </summary>
    public string shop_cipher { get; set; }

    /// <summary>
    /// 送货选项Id
    /// 特定的交付选项标识符，用于获取交付提供程序列表。
    /// </summary>
    public string delivery_option_id { get; set; }

}

官网参考地址：

运输提供商：https://partner.tiktokshop.com/docv2/page/650aa48d4a0bb702c06d85cd?external_id=650aa48d4a0bb702c06d85cd

九、TikTok组件配置-批量运送包裹

使用场景：

用于批量运送包裹。

方法：

/// <summary>
/// 批量运送包裹
/// </summary>
public class FulfillmentApi
{

    /// <summary>
    /// 批量运送包裹
    /// </summary>
    /// <returns></returns>
    public ResponseParameters<BatchShipPackagesResponse> BatchShipPackages(BatchShipPackagesRequest request);
}

接口请求对象：

/// <summary>
/// 批量运送包裹请求参数
/// </summary>
public class BatchShipPackagesRequest
{
    /// <summary>
    /// 此应用中tts卖家的唯一标识，不等于shop_id。请使用我们的商店 API 获取您的商店 ID：获取授权商店 API
    /// </summary>
    public string OpenId { get; set; }

    /// <summary>
    /// 店铺授权
    /// </summary>
    public string shop_cipher { get; set; }

    /// <summary>
    /// 包
    /// </summary>
    public List<packages> packages { get; set; }


}

官网参考地址：

批量运送包裹：https://partner.tiktokshop.com/docv2/page/650aa3ebbace3e02b75d8bd4?external_id=650aa3ebbace3e02b75d8bd4

十、TikTok组件配置-站内信

使用场景：

用于站内信(客户服务)。

方法：

/// <summary>
/// 站内信(客户服务)
/// </summary>
public class CustomerServiceApi
{

    /// <summary>
    /// 获取对话消息
    /// </summary>
    /// <param name="request"></param>
    /// <returns></returns>
    public ResponseParameters<GetConversationMessagesResponse> GetConversationMessages(GetConversationMessagesQuery request);

    /// <summary>
    /// 获取对话
    /// </summary>
    /// <param name="request"></param>
    /// <returns></returns>
    public ResponseParameters<GetConversationsResponse> GetConversations(GetConversationsQuery request);

    /// <summary>
    /// 发送短信(短消息)
    /// </summary>
    /// <param name="request"></param>
    /// <returns></returns>
    public ResponseParameters<SendMessageResponse> SendMessage(SendMessageRequest request);

    /// <summary>
    /// 获取代理设置
    /// </summary>
    /// <param name="request"></param>
    /// <returns></returns>
    public ResponseParameters<GetAgentSettingsResponse> GetAgentSettings(GetAgentSettingsQuery request);

    /// <summary>
    /// 更新代理设置
    /// </summary>
    /// <param name="request"></param>
    /// <returns></returns>
    public ResponseParameters<object> UpdateAgentSettings(UpdateAgentSettingsRequest request);

    /// <summary>
    /// 上传买家消息图片
    /// </summary>
    /// <param name="request"></param>
    /// <returns></returns>
    public ResponseParameters<UploadBuyerMessagesImageResponse> UploadBuyerMessagesImage(UploadBuyerMessagesImageRequest request);

    /// <summary>
    /// 阅读消息
    /// </summary>
    /// <param name="request"></param>
    /// <returns></returns>
    public ResponseParameters<object> ReadMessage(ReadMessageRequest request);

    /// <summary>
    /// 创建对话
    /// </summary>
    /// <param name="request"></param>
    /// <returns></returns>
    public ResponseParameters<CreateConversationResponse> CreateConversation(CreateConversationRequest request);

}

接口请求对象：

/// <summary>
/// 获取对话请求参数
/// </summary>
public class GetConversationMessagesQuery
{
    /// <summary>
    /// 此应用中tts卖家的唯一标识，不等于shop_id。请使用我们的商店 API 获取您的商店 ID：获取授权商店 API
    /// </summary>
    public string OpenId { get; set; }

    /// <summary>
    /// 店铺授权
    /// </summary>
    public string shop_cipher { get; set; }

    /// <summary>
    /// 对话 ID
    /// </summary>
    public string conversation_id { get; set; }


    /******请求查询参数******/

    /// <summary>
    /// 分页游标，这意味着此查询应从何处开始。
    /// 对于下一页，请使用“next_page_token”作为响应。
    /// </summary>
    public string page_token { get; set; }

    /// <summary>
    /// 一页
    /// 中的对话数最多 10 个
    /// </summary>
    public int page_size { get; set; }

    /// <summary>
    /// 系统消息的显示语言
    /// 可用值：
    /// zh-CN
    /// id-ID
    /// ms-MY
    /// th-TH
    /// vi-VN
    /// en（默认）
    /// en-GB
    /// </summary>
    public string locale { get; set; }

    /// <summary>
    /// 按
    /// 可用值对邮件进行排序：
    /// create_time（默认）
    /// </summary>
    public string sort_order { get; set; }

    /// <summary>
    /// create_time的排序顺序。
    /// 可用值：
    /// ASC
    /// DESC（默认）
    /// </summary>
    public string sort_field { get; set; }

}
/// <summary>
/// 获取对话请求参数
/// </summary>
public class GetConversationsQuery
{
    /// <summary>
    /// 此应用中tts卖家的唯一标识，不等于shop_id。请使用我们的商店 API 获取您的商店 ID：获取授权商店 API
    /// </summary>
    public string OpenId { get; set; }

    /// <summary>
    /// 店铺授权
    /// </summary>
    public string shop_cipher { get; set; }


    /**********/

    /// <summary>
    /// 分页游标，这意味着此查询应从何处开始。
    /// 对于下一页，请使用“next_page_token”作为响应
    /// </summary>
    public string page_token { get; set; }

    /// <summary>
    /// 一页
    /// 上的对话数最多 20 个
    /// </summary>
    public int page_size { get; set; }

    /// <summary>
    /// 系统消息的显示语言
    /// 可用值：
    /// zh-CN
    /// id-ID
    /// ms-MY
    /// th-TH
    /// vi-VN
    /// en（默认）
    /// en-GB
    /// </summary>
    public string locale { get; set; }


}
/// <summary>
/// 发送短消息请求参数
/// </summary>
public class SendMessageRequest
{
    /// <summary>
    /// 此应用中tts卖家的唯一标识，不等于shop_id。请使用我们的商店 API 获取您的商店 ID：获取授权商店 API
    /// </summary>
    public string OpenId { get; set; }

    /// <summary>
    /// 店铺授权
    /// </summary>
    public string shop_cipher { get; set; }


    /// <summary>
    /// 对话 ID
    /// </summary>
    public string conversation_id { get; set; }

    /// <summary>
    /// 消息类型
    /// 可用值：
    /// TEXT
    /// IMAGE
    /// PRODUCT_CARD
    /// ORDER_CARD
    /// </summary>
    public string type { get; set; }

    /// <summary>
    /// 消息内容，采用JSON字符串格式。对于文本：（最多2000个字符。不允许使用敏感词。{“content”：“嗨，我想退款”}对于PRODUCT_CARD：{“product_id”：“7494560109732334265”}对于ORDER_CARD：{“order_id”：“7494560109732334267”}对于图像：{“url”：”https://p16-oec-va.ibyteimg.com/tos-maliva-i-o3syd03w52-us/2ca53c34ad8443e6b39f4e0153d3aed4~tplv-o3syd03w52-origin-image.image?from=1320446476“，”宽度“：1280，”高度“：720}
    /// </summary>
    public string content { get; set; }

}
/// <summary>
/// 获取代理设置请求参数
/// </summary>
public class GetAgentSettingsQuery
{
    /// <summary>
    /// 此应用中tts卖家的唯一标识，不等于shop_id。请使用我们的商店 API 获取您的商店 ID：获取授权商店 API
    /// </summary>
    public string OpenId { get; set; }

    /// <summary>
    /// 店铺授权
    /// </summary>
    public string shop_cipher { get; set; }

}
/// <summary>
/// 更新代理设置请求参数
/// </summary>
public class UpdateAgentSettingsRequest
{
    /// <summary>
    /// 此应用中tts卖家的唯一标识，不等于shop_id。请使用我们的商店 API 获取您的商店 ID：获取授权商店 API
    /// </summary>
    public string OpenId { get; set; }

    /// <summary>
    /// 店铺授权
    /// </summary>
    public string shop_cipher { get; set; }

    /// <summary>
    /// 如果为 true，则代理将收到自动分配的聊天。座席可以手动选择要响应的聊天。
    /// 如果为 false，则代理将仅接收手动分配的聊天。
    /// 使用 IM API 时，建议将此字段设置为 true
    /// </summary>
    public bool can_accept_chat { get; set; }

}
/// <summary>
/// 上传买家消息图片请求参数
/// </summary>
public class UploadBuyerMessagesImageRequest
{
    /// <summary>
    /// 此应用中tts卖家的唯一标识，不等于shop_id。请使用我们的商店 API 获取您的商店 ID：获取授权商店 API
    /// </summary>
    public string OpenId { get; set; }

    /// <summary>
    /// 店铺授权
    /// </summary>
    public string shop_cipher { get; set; }

    /// <summary>
    /// 图像数据
    /// </summary>
    public byte[] data { get; set; }

}
/// <summary>
/// 阅读消息请求参数
/// </summary>
public class ReadMessageRequest
{
    /// <summary>
    /// 此应用中tts卖家的唯一标识，不等于shop_id。请使用我们的商店 API 获取您的商店 ID：获取授权商店 API
    /// </summary>
    public string OpenId { get; set; }

    /// <summary>
    /// 店铺授权
    /// </summary>
    public string shop_cipher { get; set; }

    /// <summary>
    /// 买家与商店之间对话的唯一标识符
    /// </summary>
    public string conversation_id { get; set; }

}
/// <summary>
/// 创建对话请求参数
/// </summary>
public class CreateConversationRequest
{
    /// <summary>
    /// 此应用中tts卖家的唯一标识，不等于shop_id。请使用我们的商店 API 获取您的商店 ID：获取授权商店 API
    /// </summary>
    public string OpenId { get; set; }

    /// <summary>
    /// 店铺授权
    /// </summary>
    public string shop_cipher { get; set; }


    /// <summary>
    /// Customer Service API 中User_id的买方用户 ID
    /// 与订单 API 中的buyer_user_id相同。您可以使用“buyer_use_id”获取通过聊天联系您的买家的订单
    /// </summary>
    public string buyer_user_id { get; set; }
        
}

官网参考地址：

获取对话消息：https://partner.tiktokshop.com/docv2/page/650a587edefece02be664cd2?external_id=650a587edefece02be664cd2#Back%20To%20Top
获取对话：https://partner.tiktokshop.com/docv2/page/650a589f0fcef602bf29fecf?external_id=650a589f0fcef602bf29fecf
发送短信：https://partner.tiktokshop.com/docv2/page/650a58bbbace3e02b7556286?external_id=650a58bbbace3e02b7556286
获取代理设置：https://partner.tiktokshop.com/docv2/page/650a58d2bace3e02b7556575?external_id=650a58d2bace3e02b7556575
更新代理设置：https://partner.tiktokshop.com/docv2/page/650a59870fcef602bf2a1d79?external_id=650a59870fcef602bf2a1d79
上传买家消息图片：https://partner.tiktokshop.com/docv2/page/650a599d0fcef602bf2a1dc8?external_id=650a599d0fcef602bf2a1dc8
阅读消息：https://partner.tiktokshop.com/docv2/page/650a59f7c16ffe02b8e8db3f?external_id=650a59f7c16ffe02b8e8db3f
创建对话：https://partner.tiktokshop.com/docv2/page/650a5a0bf1fd3102b9245b8d?external_id=650a5a0bf1fd3102b9245b8d