跳至主要内容

添加客服

向已有工單會話新增客服參與人。

請求​

POST https://apichat.twt.com/openapi/chat/add_kf

Header 參數​

參數名類型必填說明
x-chat-signaturestring是HMAC-SHA256 簽名。使用實際發送的原始 JSON body 計算 hash_hmac('sha256', raw_body, app_secret)
Acceptstring否預設：application/json
Content-Typestring是application/json

Body 參數​

參數類型必填說明
appidstring是控制台中的應用標識
timestampinteger是請求時間戳，生產環境中過期時間戳可能被拒絕
ranstrstring是隨機字串
chat_idinteger是工單會話 ID。會話必須屬於 appid 對應站點
kefu_idsstring 或 array[integer]是要新增的客服 ID。建議使用英文逗號拼接字串，例如 10427,10428；也相容整數陣列

請求範例​

curl --location --request POST 'https://apichat.twt.com/openapi/chat/add_kf' \
--header 'x-chat-signature: 0bf19198ab2dd65a407ca8d57fbb3f6ebca71d22709a1f5d53c685e9e25abdbc' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data-raw '{
    "appid": "42d7c13c16e7ed0479f2418eb8894310",
    "timestamp": 1781683144,
    "ranstr": "codex1033048655",
    "chat_id": 900220,
    "kefu_ids": "10427,10428"
}'

相容陣列範例​

{
    "appid": "42d7c13c16e7ed0479f2418eb8894310",
    "timestamp": 1781683144,
    "ranstr": "codex1033048655",
    "chat_id": 900220,
    "kefu_ids": [
        10427,
        10428
    ]
}

返回響應​

200 成功​

參數類型必填說明
codeinteger是1 成功，-1 失敗
msgstring是響應提示
datastring是成功時為空字串
{
  "code": 1,
  "msg": "ok",
  "data": ""
}

失敗範例​

{
  "code": -1,
  "msg": "token验证失败!",
  "data": ""
}
{
  "code": -1,
  "msg": "会话不存在",
  "data": ""
}
{
  "code": -1,
  "msg": "当前状态不允许操作",
  "data": ""
}

注意事項​

  • 該接口僅適用於工單會話。
  • 會話必須已有負責人客服。系統新增參與人時，會使用目前負責人客服作為操作人。
  • 新增客服必須屬於同一站點，並且處於正常狀態。
  • 已在服務中的客服會由底層服務流程忽略。如果沒有剩餘有效新客服，本次請求會失敗。
  • 簽名必須基於實際發送的原始 JSON body 計算。