187
web im通過鏈接添加客戶信息
一、概述：
網站登錄用戶通過web im進行聊天對話時，可以將客戶信息通過鏈接轉給Udesk，這樣客服在與客戶對話時，就可以直接查看客戶信息。通過客戶信息輔助組件也可以進一步了解此客戶的訂單等其他信息。
二、使用方法
在web im對話窗口的鏈接（https://xxx.udesk.cn/im_client）按照以下規則增加參數和加密信息，即可傳輸客戶信息。
其中郵箱和電話號碼用於客戶識別，即與Udesk係統內CRM中已有數據進行比對，如果為已有客戶會更新信息，如果沒有匹配則會新建客戶。
請求參數
-----------------
* c_name 客戶姓名
* c_email 郵箱（唯一）
* c_phone 電話號碼（唯一）
* c_desc 客戶描述
* c_org 公司名稱
* c_wx 微信號
* c_wb 微博號
* c_qq qq號
* c_tags 客戶標簽，逗號分隔 如："帥氣,漂亮"
* c_owner 負責人 （管理員查看員工信息可域名中的數字就是負責人ID）
* c_owner_group 負責組（管理員查看客服組域名中的數字就是負責組ID）
* c_other_emails 其他郵箱，逗號分隔 如："a@udesk.cn,b@udesk.cn"
* c_cf_名稱 自定義字段集合，如果名稱為漢字可以直接加漢字名稱
* nonce 隨機數［必填］
* timestamp 13位毫秒時間戳［必填］
* web_token 客戶ID，如果客戶ID為郵箱或手機號，可以用郵箱和手機號［必填］
* signature 加密簽名，對timestamp、nonce、web_token和c_key進行SHA1加密後的字符串［必填］
signature加密算法:
-----------------
1. 按以下參數及順序拚接字符: nonce/timestamp/web_token
sign_str = nonce=value×tamp=value&web_token=value
2. 以上字符串加入 &im_user_key
sign_str = nonce=value×tamp=value&web_token=value&im_user_key
im_user_key可以在【管理中心-即時通訊-自定義鏈接-添加客戶信息】中找到
3. 使用 sha1 計算出簽字並大寫
Digest::SHA1.hexdigest(sign_str).upcase
eg
nonce=9ca6fff5a509fb887ac72cf5c92010e7×tamp=1455675719000&web_token=123&b476f9f8-5309-4d0a-a2d4-af08c4507a15
三、一條帶客戶信息的案例：
https://xxx.udesk.cn/im_client?c_desc=test123456789&c_email=jiangst%40udesio.com&c_phone=15888888888&echostr=hello&nonce=cdebd5d13f4d331e&signature=693140534BDDDAF002A46F0027E06244DF0B21AB×tamp=1457696747000&web_token=42f6607e-8892-4fcf-889b-f9babf627060
最後更新：2017-01-17 10:01:45