Livechat 設定教學

在 Livechat 開發者控制台建立 PAT 驗證

請使用將被 AI Agent 接管的 LiveChat Agent 帳戶登入 Livechat 開發者控制台，並依下列步驟操作：

• 進入設定頁面，選擇 Personal Access Tokens，點擊「新增 Token +」
  

• 建立 PAT，權限範圍請選擇「全選」
  

• 複製並儲存「Account ID」與「Token」，稍後在「GPTBots - Agent Integration - Livechat」設定時需用到。
  

在 Livechat 建立應用程式 Build app 用於收發訊息

• 進入「Apps」頁面，點擊「建立應用程式」開始建立
  

• 輸入應用程式名稱，產品選擇 livechat，點擊「建立應用程式」完成
  

• 點擊應用程式進入詳情頁，選擇 Blocks 頁籤，點擊「新增區塊」
  

• 在「新增區塊」彈窗中，選擇「App Authorization」並點擊「新增區塊」
  

• 選擇 Server-side app 選項並點擊「儲存」完成建立
  

• 複製並儲存「Client Id」與「Client Secret」，稍後於「GPTBots - Agent Integration - Livechat」設定時需用到。
  

在 GPTBots 設定 Livechat 整合

• 於「GPTBots - Agent Settings - Integration - Livechat」頁面，填入上述資訊並點擊「Submit」完成設定。

  • AgentEmail：將被 AI Agent 接管的 LiveChat Agent 帳戶 Email 地址，需為同專案之人工客服帳號。
  • Account ID：建立 PAT 時取得的 Account ID（對應被接管帳號）。
  • Token：建立 PAT 時取得的 Token（對應被接管帳號）。
  • Client Id：建立應用程式時取得的 Client Id。
  • Client Secret：建立應用程式時取得的 Client Secret。

• Secret key：請輸入自訂金鑰並儲存，用於 webhook 驗證。
  

• 完成「Livechat 整合」設定後：

  • AI Agent 將接管 AgentEmail 帳號的用戶對話，直接回覆問題。
  • 支援用戶傳送文字、圖片、檔案等多模態訊息。
  • 平台將產生「Webhooks - 訊息與事件接收 URL」，可用於 Livechat 後台建立 Webhook。

設定聊天 webhook（進階功能：對話轉接／關閉）

建立 "incoming_event" 與 "incoming_chat" 事件

• 回到 Blocks 頁面，點擊「新增區塊」建立 webhook
  

• 在彈窗中，選擇「chat webhooks」（非 app webhooks），點擊「新增區塊」
  

• 複製「GPTBots Webhook URL」，於「GPTBots - Agent Configuration - Integration - Livechat」取得
  

• 在「建立 Chat Webhook」時設定下列選項並點擊「儲存」完成

  • Webhook URL：請貼上複製的「GPTBots Webhook URL」。
  • Secret key：輸入前述自訂金鑰
  • Type：選擇「License」
  • Webhook triggers：勾選「incoming_event」與「incoming_chat」事件並勾選「chat_presence_user_ids」項目
    
    
    

安裝應用程式並驗證

• 前往「Private Installation」頁面，點擊「安裝應用程式」。
  

• 最後，前往 https://my.livechatinc.com/apps/settings/manage-apps/private 檢查是否安裝完成。若顯示已安裝即代表成功。
  

設定 Livechat Agent

請於「Team」-「Group」建立新群組，將被 AI Agent 接管的 LiveChat Agent 帳戶及人工客服帳戶一同加入。

• 將被 AI Agent 接管的帳戶設為：Primary agent
• 將人工客服帳戶設為：Backup agent
  

Livechat 整合進階功能

設定 TAG

注意：啟用本功能後，系統會監控 Livedesk 專案所有目標事件並設定 TAG，可能消耗大量點數。
Livechat 驗證設定完成後，可啟用「設定 TAG」功能。設定方式如下：

• 選擇觸發情境：可由「關閉對話」或「轉接聊天」兩事件觸發設定 TAG。
  • 關閉對話：用戶於 Livechat 聊天視窗主動關閉對話時。
  • 轉接聊天：Livechat 聊天視窗對話被轉接至其他客服帳戶時。
• TAG：系統將自動取得 Livechat 專案現有 TAG 清單。
  當觸發情境發生時，AI Agent 會根據對話紀錄自動選擇最適合 TAG，並呼叫 Livechat TAG 設定 API，協助客服快速識別用戶需求、提升營運效率。
  

回覆狀態

Livechat 驗證設定完成後，可啟用「回覆狀態」功能。啟用後，用戶於 Livechat 聊天視窗發送訊息時，將看到「回覆動畫」，提升互動體驗。

預聊天表格

啟用 Livechat Widget「預聊天表格」功能後，用戶在 Livechat 聊天視窗發送訊息後，會被提示填寫預聊天表格以收集用戶資訊。
於 GPTBots - 設定 - 整合 - Livechat 頁面啟用預聊天表格功能後，AI Agent 可接收用戶提交的預聊天表格資料，作為對話上下文，協助 AI Agent 更精確理解需求並給予回應。

設定用戶 ID

當開發者使用 Livechat Widget 為網站用戶服務時，可透過設定用戶 ID，讓 Agent 用戶與網站登入用戶身份同步。當網站用戶登入後，呼叫 LiveChat Widget SDK API 設定 user_id，該 user_id 即可被 GPTBots Agent 使用，有助於 AI Agent 快速識別用戶、提升服務效率。

                      
                      LiveChatWidget.call("set_session_variables",{user_id: "your_user_id"});