人工服務

當開發者選擇 Webhook（網路回呼）作為人工服務接入方式 時，需先於伺服器環境中建置 Webhook 服務。開發者需依據規範提供以下三種介面，以接收人工服務請求、用戶訊息及人工客服回覆訊息。同時，GPTBots 也提供兩種介面，供接收客服回覆訊息及對話關閉指令。

重要注意事項：

1. 開發者必須確保 Webhook 服務運作正常，因其直接影響人工支援服務運作狀態。
   • 若啟用人工支援後顯示「忙碌」，則表示開發者的 Webhook 服務 異常。
   • 若啟用人工支援後顯示「連接中」，則表示開發者的 Webhook 服務 正常運行。
2. 成功啟用人工支援服務請求後：
   • 開發者需呼叫 回覆用戶訊息 介面 (https://api.gptbots.ai/v1/human/message/receive)，至少回覆用戶一則訊息以建立對話連線。
   • 若開發者未於設定的 等待逾時 時間內（預設 60 秒）回覆用戶訊息，人工支援對話將自動終止。

接收人工服務對話請求通知

當終端用戶發起人工服務請求時，GPTBots 會將該請求轉發至開發者的 Webhook 服務。介面服務回應狀態碼為 200，表示成功建立人工服務對話。

請求方法

POST

端點

https://your_domain/conversation/establish

請求範例

                      
                      curl -X POST 'https://YOUR_DOMAIN/human/service/conversation/establish' \
-H 'Content-Type: application/json' \
-d '{
  "body": [
    {
      "text": "human service",
      "message_type": "QUESTION"
    },
    {
      "text": "",
      "message_type": "ANSWER"
    }
  ],
  "timestamp": 1742265090895,
  "email": "bob@gmail.com",
  "conversation_id": "67d8db020fa31d1ef64f53dg",
  "bot_id": "665d88b03ce2b13cf2d573454",
  "user_info": {
    "phone": null,
    "email": "bob@gmail.com",
    "user_id": "KDslas",
    "anonymous_id": "652face5184b30540a6ea7fe"
  }
}'

                    

注意：此請求主體中的 conversation_id 僅用於標識人工服務對話場景的唯一 ID，與 建立對話 ID 中的智能代理（Agent）對話場景生成的唯一 ID 不同。

請求參數

email 欄位注意事項：

• 透過 iframe/Share/Bubble Widget 發起人工服務時，需填寫用戶電子郵件。開發者亦可自訂用戶 email 以免用戶輸入。
• 透過 WhatsApp/Telegram/即時聊天等第三方平台請求人工服務時，預設 email 為 support@gptbots.ai。即時聊天可自訂 email。
• 透過 API 請求人工服務時，email 欄位可為空，預設 email 為 support@gptbots.ai。

回應

聊天介面

使用已建立的 conversation_id，將用戶訊息傳送至人工客服。

請求方法

POST

端點

https://your_domain/chat

請求參數

回應

關閉對話介面

當用戶對話逾時或智能代理用戶主動關閉對話時，調用此介面關閉對話。

請求方法

POST

端點

https://your_domain/conversation/close

請求標頭

請求參數

回應

回覆用戶訊息

當開發者選擇 webhook 作為人工服務整合方式時，GPTBots 提供回覆用戶訊息介面，讓人工客服可將訊息內容回傳給用戶。

請求方法

POST

端點

https://api-${endpoint}.gptbots.ai/v1/human/message/receive

請求標頭

請求參數

回應

人工客服主動關閉對話

當開發者選擇 webhook 作為人工服務接入方式時，GPTBots 所提供的人工客服可於需要時主動關閉對話。關閉後，除非用戶再次發起人工客服對話，否則不會再收到客服訊息。

請求方法

POST

端點

https://api-${endpoint}.gptbots.ai/v1/human/close

請求標頭

請求參數

回應