回复润色

第三方 → Shulex：对一段待发送回复进行润色

当第三方已经生成或编辑了一段回复文本，希望由 Shulex AI 优化表达、语气或格式时，可调用此接口。

调用地址与鉴权

在 Shulex 中创建 Custom Ticket 渠道后，从渠道配置页面复制回复润色地址；请勿手动拼接 URL。

POST https://<host>/api_v2/intelli/custom-ticket/reply-rephrase/{xToken}/{channelId}
Content-Type: application/json

路径字段	类型	必填	说明
`xToken`	string	是	Shulex 生成的渠道访问凭证
`channelId`	number	是	Shulex 生成的 Custom Ticket 渠道 ID

Shulex 会校验凭证与渠道归属同一账号，且该渠道必须为 Custom Ticket 渠道。请求体不支持覆盖 xToken、channelId 或租户 ID。

请求格式

{
  "text": "Sorry for the issue. We will check it.",
  "referenceText": "Customer reported that the package arrived damaged.",
  "contentFormat": "PLAIN",
  "styleMode": 1,
  "styleValue": "FRIENDLY"
}

请求字段

字段	类型	必填	默认值	说明
`text`	string	是	无默认值	待润色文本
`referenceText`	string	否	不传时为空	参考上下文，例如客户最后一条消息
`contentFormat`	string	否	`HTML`	输出格式；可写值见下方 `contentFormat` 枚举表
`styleMode`	integer	否	不传时普通润色	风格来源；可写值见下方 `styleMode` 枚举表
`styleValue`	string	条件必填	无默认值	风格内容；当传入 `styleMode` 时必填，可写值见下方 `styleValue` 枚举表

text 不能为空。contentFormat 不传时按 HTML 处理。styleMode 与 styleValue 必须同时传入或同时不传；不传时保持普通润色，与旧行为一致。

枚举可写值

`contentFormat`

值	说明
`MARKDOWN`	Markdown 格式
`HTML`	HTML 格式
`PLAIN`	纯文本格式

`styleMode`

值	说明
`1`	预设风格；`styleValue` 必须使用支持的预设编码
`2`	自定义提示词；`styleValue` 为自然语言风格指令。该模式为预留能力，当前暂未开放

`styleValue`

当 styleMode=1 时，styleValue 可写值如下：

值	展示名称	说明
`EXPAND`	AI 扩写	在保留原始有效信息的基础上补充更完整、易理解的表达；不会凭空新增事实、政策、时效、链接或操作步骤
`FRIENDLY`	更友好	使用亲切、尊重、自然的客户服务语气；避免过度热情、口语化或新增承诺
`FORMAL`	更正式	使用专业、正式、客观的客户服务语气；措辞克制、结构清晰

当 styleMode=2 时，styleValue 为客户自定义的自然语言风格指令。

响应格式

成功时返回 ResponseResult 包装结构。data 中不会返回模型用量 usages；枚举字段统一返回字符串。

响应字段

字段	类型	说明
`code`	string	业务状态码；成功时为 `"200"`
`msg`	string	响应说明；成功时为 `"success"`
`success`	boolean	是否成功
`data.content`	string	润色后的回复内容
`data.language`	string	输出语言，例如 `ENGLISH`、`CHINESE`
`data.contentFormat`	string	内容格式，例如 `MARKDOWN`、`HTML`、`PLAIN`

成功响应

{
  "code": "200",
  "msg": "success",
  "success": true,
  "data": {
    "content": "I'm sorry for the inconvenience. We'll look into this right away and get back to you with an update.",
    "language": "ENGLISH",
    "contentFormat": "PLAIN"
  }
}

常见错误

code	场景	处理建议
`"400"`	`xToken` 无效	从渠道配置页面重新复制完整地址
`"400"`	渠道不存在或不属于当前账号	确认 `xToken` 与 `channelId` 来自同一 Custom Ticket 渠道
`"400"`	`text` 为空	提供非空的待润色文本
`"400"`	内容格式非法	检查 `contentFormat` 是否为支持值
`"400"`	`styleMode` 与 `styleValue` 未同时传入	两个字段同时传入，或两个字段都不传
`"400"`	`styleMode` 非法	只传 `1` 或 `2`
`"400"`	`styleValue` 预设编码非法	当 `styleMode=1` 时，只传 `EXPAND`、`FRIENDLY` 或 `FORMAL`
`"400"`	`styleMode=2` 暂未开放	当前仅使用预设风格；自定义提示词开放后再接入
`"500"`	回复润色异常	保留请求时间和渠道信息并联系 Shulex 支持排查

接入建议

只把待发送的回复正文放入 text，不要把完整工单内容混入待润色文本。
使用 referenceText 补充客户问题或摘要，帮助 AI 保持语义一致。
不需要传入语言字段；输出语言由 Shulex AI 根据原文、参考上下文和默认策略处理。
不传 contentFormat 时按 HTML 处理，适合保留邮件或富文本结构。
需要指定风格时，同时传入 styleMode 与 styleValue；当前可用预设为 EXPAND、FRIENDLY、FORMAL。
对润色结果做人工确认后再发送给客户。

总览

Webhook

Open API

回复润色

回复润色

调用地址与鉴权

请求格式

请求字段

枚举可写值

`contentFormat`

`styleMode`

`styleValue`

响应格式

响应字段

成功响应

常见错误

接入建议

​回复润色

​调用地址与鉴权

​请求格式

​请求字段

​枚举可写值

​contentFormat

​styleMode

​styleValue

​响应格式

​响应字段

​成功响应

​常见错误

​接入建议

回复润色

调用地址与鉴权

请求格式

请求字段

枚举可写值

`contentFormat`

`styleMode`

`styleValue`

响应格式

响应字段

成功响应

常见错误

接入建议