跳至主要内容

建立機器人會話

建立一個由機器人接待的線上會話。呼叫前必須已開啟站點的機器人接待功能；未開啟時接口返回錯誤，不會建立會話。

請求​

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

Header 參數​

參數名類型必填說明
x-chat-signaturestring是根據實際發送的原始 JSON body 計算的 HMAC-SHA256 簽名
Acceptstring否預設：application/json
Content-Typestring是application/json

Body 參數​

參數類型必填說明
appidstring是控制台中的應用標識
timestampinteger是請求時間戳
ranstrstring是隨機字串
sbsstring/number是客戶唯一標識，1 到 64 個字元。客戶不存在時自動建立
ipstring是客戶 IP 地址
sbs_mcstring是客戶姓名，1 到 30 個字元
contentstring是初始訪客訊息，1 到 2000 個字元
titlestring否會話標題，1 到 120 個字元

請求範例​

{
  "appid": "42d7c13c16e7ed0479f2418eb8894310",
  "timestamp": 1767692611,
  "ranstr": "f86bbfa782c7e9fa",
  "sbs": "visitor-10001",
  "ip": "192.168.1.1",
  "sbs_mc": "訪客",
  "content": "我想了解一下你們的產品",
  "title": "產品諮詢"
}

返回響應​

200 成功​

{
  "code": 1,
  "msg": "ok",
  "data": {
    "chat_id": 900220
  }
}

機器人接待未開啟​

{
  "code": -1,
  "msg": "机器人接待未开启",
  "data": ""
}

注意事項​

  • 本接口不接收 kefu_id、fzr_uid 或 sender_type；初始訊息始終以訪客身份發送，會話由機器人接待。
  • 只有站點已開啟機器人接待時請求才會成功。未開啟時不會建立客戶或會話。
  • 建立成功後的會話狀態與訪客發起並分配給機器人一致：狀態為待回覆，負責人為空，不進入排隊。
  • content 必填，會作為觸發機器人接待的第一條訪客訊息。
  • 簽名必須基於實際發送的原始 JSON body 計算，欄位順序、空格和換行都需要保持一致。