829
逸創雲客服
如何使用“外部數據獲取字段”的工單自定義字段
外部數據獲取字段可以和您的第三方係統進行交互，進行一些數據獲取，在工單提交頁麵顯示，下麵將對該字段進行詳細描述。
外部數據獲取字段有什麼用？
例如您的企業運營著一個網上商城係統，您的用戶在您的商城裏購買東西，在購買東西的時候用戶會下訂單，這樣一來一個用戶也許在您的商城係統裏麵有多個訂單。
您希望您的客戶在提交工單的時候，能方便的選擇這些訂單列表，來對某個訂單提出工單問題請求
如圖：
這些訂單編號是從您的商城係統裏當前用戶的信息中獲取的，需要進行一些配置後才能正常使用該功能。
如何使用和配置外部數據獲取字段
外部數據獲取字段是用來獲取外部係統用戶的某些額外信息列表，所以這個字段必須與外部係統的用戶相關聯，如果不能和外部係統的用戶相關聯，這個字段是沒有意義的。
要添加一個外部數據獲取字段，將菜單轉到 係統設置 > 工單 > 工單自定義字段， 點擊添加工單自定義字段，然後選擇 外部數據獲取字段。
在打開的字段配置頁麵，您可以設置要顯示給哪些用戶，最重要的是要配置好 數據獲取URL 和 數據獲取TOKEN 這兩個信息。
數據獲取URL
這個是指您的外部係統的一個URL地址，KF5幫助台會通過這個地址來訪問您的係統，從而獲取到您外部係統中的用戶信息來生成該字段的信息列表。它的格式形如： https://sample.com/obtain/?email={{email}} &phone={{phone}}&landline={{landline}}。請不要刪除地址中的{{email}} 、{{phone}}、{{landline}}，它代表所要數據的當前用戶的郵箱、手機號、座機號，並以此作為用戶的匹配方式來獲取目標係統該用戶的相關信息。
數據獲取TOKEN
這個是指您外部係統指定的數據獲取通信密鑰，設置TOKEN是為了增加數據請求的安全性。具體如何獲取我們將在下麵具體描述到。
如何配置或二次開發您的外部係統
逸創雲客服目前已經讓一些開源係統能支持該字段的設置，無需進行二次開發，如果您使用的是以下係統，則可以輕鬆配置和使用
- ecshop
配置ECSHOP讓用戶提交工單時能選擇在商城係統的訂單號
請根據 ECSHOP整合幫助文檔 配置好ECSHOP係統和逸創雲客服的整合，並在逸創雲客服配置好單點登錄，讓用戶必須登錄才可以提交工單，同時關閉雲客服平台的注冊功能。
在 外部數據獲取字段 的數據獲取URL 處，填入： https://www.yourecshop.com/kf5.php?act=getOrderList&email={{email}}
下麵的 外部數據獲取字段 的 數據獲取TOKEN 留空，係統會使用API密鑰作為TOKEN來進行加密。
這樣，用戶通過單點登錄提交工單時，可以顯示自己的訂單號列表了。
其他外部係統的二次開發指導 （您需要有一定的代碼開發基礎才能配置好該字段功能）
如果您使用的是您自己開發的外部係統，則需要進行一些簡單的二次開發
- 您需要寫一個函數來處理用郵箱來查找用戶信息，並返回這些指定的信息
- 您需要自行設定一個TOKEN通信密鑰，這個密鑰隻是為了數據獲取使用，並填入 數據獲取TOKEN 中
下麵是一個PHP語言開發示例代碼段：
$email = isset($_GET['email']) ? $_GET['email'] : '';
$token = isset($_GET['token']) ? $_GET['token'] : '';
//您設定的數據獲取驗證token
$secret_key = '********';
$results = array();
//驗證token是否正確
if($email && $token && $token == $secret_key）{
/*
* 可查詢數據庫獲取和用戶郵箱匹配的數據
* 此處僅為演示，請根據具體情況開發
*/
$data = array('訂單1號','訂單2號');
foreach($data as $key=>$value){
$results[$value] = $value;
}
}
echo json_encode($results);
注意事項
- 因為該字段是和外部用戶係統相關聯的，所以最好是做好SSO單點登錄整合集成後，再添加該字段，否則單獨添加該字段是沒有任何意義的。
- 如果沒有獲取到外部係統用戶的任何信息，或者因為配置不當沒有獲取到用戶，該字段是不會顯示任何下拉數據的。
- 如果用戶沒有以任何方式登錄係統時，在任何情況下都是不會顯示該字段的。
最後更新：2017-02-07 22:26:56