文章摘要：一、概述：網(wǎng)站登錄用戶通過webim進行聊天對話時，可以將客戶信息通過鏈接轉(zhuǎn)給Udesk，這樣客服在與客戶對話時，就可以直接查看客戶信息。通過客戶信息輔助組件也可以進一步了解此客戶的訂單等其他信息。二、...

一、概述：

網(wǎng)站登錄用戶通過web im進行聊天對話時，可以將客戶信息通過鏈接轉(zhuǎn)給Udesk，這樣客服在與客戶對話時，就可以直接查看客戶信息。通過客戶信息輔助組件也可以進一步了解此客戶的訂單等其他信息。

二、使用方法

在web im對話窗口的鏈接（http://xxx.udesk.cn/im_client）按照以下規(guī)則增加參數(shù)和加密信息，即可傳輸客戶信息。

其中郵箱和電話號碼用于客戶識別，即與Udesk系統(tǒng)內(nèi)CRM中已有數(shù)據(jù)進行比對，如果為已有客戶會更新信息，如果沒有匹配則會新建客戶。

請求參數(shù)
-----------------
* c_name 客戶姓名
* c_email 郵箱（唯一）
* c_phone 電話號碼（唯一）
* c_desc 客戶描述
* c_org 公司名稱
* c_wx 微信號
* c_wb 微博號
* c_qq qq號
* c_tags 客戶標(biāo)簽，逗號分隔 如："帥氣,漂亮"
* c_owner 負責(zé)人 ? ?（管理員查看員工信息可域名中的數(shù)字就是負責(zé)人ID）
* c_owner_group 負責(zé)組（管理員查看客服組域名中的數(shù)字就是負責(zé)組ID）
* c_other_emails 其他郵箱，逗號分隔 如："a@udesk.cn,b@udesk.cn"
* c_cf_名稱?自定義字段集合，如果名稱為漢字可以直接加漢字名稱

* nonce 隨機數(shù)［必填］
* timestamp 13位毫秒時間戳［必填］
* web_token ?客戶ID，如果客戶ID為郵箱或手機號，可以用郵箱和手機號［必填］
* signature 加密簽名，對timestamp、nonce、web_token和c_key進行SHA1加密后的字符串［必填］

signature加密算法:
-----------------
1. 按以下參數(shù)及順序拼接字符: nonce/timestamp/web_token
sign_str = nonce=value&timestamp=value&web_token=value
2. 以上字符串加入 &im_user_key
sign_str = nonce=value&timestamp=value&web_token=value&im_user_key

im_user_key可以在【管理中心-即時通訊-自定義鏈接-添加客戶信息】中找到

3. 使用 sha1 計算出簽字并大寫
Digest::SHA1.hexdigest(sign_str).upcase

eg
nonce=9ca6fff5a509fb887ac72cf5c92010e7&timestamp=1455675719000&web_token=123&b476f9f8-5309-4d0a-a2d4-af08c4507a15

三、一條帶客戶信息的案例：

http://xxx.udesk.cn/im_client?c_desc=test123456789&c_email=jiangst%40udesio.com&c_phone=15888888888&echostr=hello&nonce=cdebd5d13f4d331e&signature=693140534BDDDAF002A46F0027E06244DF0B21AB&timestamp=1457696747000&web_token=42f6607e-8892-4fcf-889b-f9babf627060

文章為沃豐科技原創(chuàng)，轉(zhuǎn)載需注明來源：http://yzny.net.cn/ucm/faq/11298