外部系統串接讓既有工具接上服務流程

將已設定的外部服務連到需要它們的工作步驟。

看清連線狀態

依需要啟用服務

異常時交由人員處理

從問題到下一步

  1. 選擇外部服務

  2. 完成授權設定

  3. 確認連接狀態

  4. 處理例外

可連接什麼

依外部系統提供的介面設定查詢或操作。匯入會先顯示候選操作與欄位,並非任何外部 API 都能免設定直接使用。

操作來源與資料範圍

串接要從外部系統實際提供的介面開始。匯入 JSON 或 OpenAPI 3 規格時,先看到的是候選操作、路徑、欄位與型態,不是已能執行的工具。商家要核對每個欄位代表什麼、是否需要系統識別 ID,以及查詢結果會包含哪些資料。公開說明只放顧客能理解的服務能力,連線憑證和私人回傳資料留在受保護的流程。若外部系統的規格和實際回應不同,應以測試結果修正設定,而不是要求助手猜出正確欄位。

設定步驟

在後台建立串接、檢查匯入預覽及欄位型態,設定必要的連線與憑證,再依方案和人員權限測試、啟用並指派給助手。憑證只在受保護的後台設定,不應放在公開說明或顧客對話。

權限與顧客確認

有權限的人員才可建立、測試、啟用與指派串接;商家方案和外部系統的授權也決定哪些操作可用。只讀查詢與會改動外部資料的操作應分開評估。涉及預約、訂單或其他寫入時,顧客應先看清楚對象、時間、數量等摘要並明確確認,系統再按原定流程執行。顧客輸入的店名或人名不能直接當作外部系統所需的 ID;要先用可信查詢取得識別值。

限制與責任

可用操作取決於商家方案、授權、串接設定及外部系統狀態。匯入後仍需核對欄位、測試真實回應;外部系統失敗時不能把操作說成已完成。

啟用前的核對

用外部系統實際可用的測試資料檢查欄位型態、必填值、授權失效、找不到紀錄和回應延遲。確認哪些結果能顯示給顧客、哪些只能讓後台人員查看。把成功、失敗和不明狀態都走過一次,確認助手不會把失敗寫成完成,也不會因重送建立重複動作。若供應商改了介面或憑證過期,先暫停相關操作並由負責人重新驗證。對外說明以已完成設定和實測的能力為準。接入前還應選定誰負責外部服務帳號、誰能更換憑證、發現查詢資料不一致時由誰聯絡供應商。顧客要修改已送出的資料時,先核對外部系統是否提供相應的變更能力;沒有就交給人員,不把『可以新增』誤說成『可以修改或取消』。完成測試後,用顧客角度檢查說明文字,確保看得懂何時需要他確認,以及發生不明結果時如何追蹤。若同一個動作從網站與聊天兩個入口啟動,應確認回傳狀態和顧客看到的摘要一致,避免一個入口顯示完成、另一個仍顯示待確認。人員也應知道暫停外部連線後哪些入口需同步關閉。

常見問題

匯入規格後就能立即使用嗎?

不能。先檢查預覽、設定連線與憑證,完成權限檢查、測試、啟用和助手指派,再核對實際結果。

外部系統用名稱查詢時怎麼辦?

依該系統的介面取得正確識別 ID;不要把顯示名稱直接填進要求 ID 的欄位。

匯入後就能給顧客使用嗎?

不能;還要核對欄位、授權、測試與指派。

可以把 API 金鑰寫進知識嗎?

不可以;憑證應保留在受保護的設定。

外部系統沒回成功時怎麼說?

說明狀態未確認,請人員查核,不能宣稱完成。

從一個真實需求開始

告訴我們目前如何接待顧客與處理工作,一起找出適合的起點。

申請測試
kakinang 如何協助我處理「讓助手使用已授權的外部能力」? 直接問 kakinang 官方助手