一、概述:

网站登录用户通过web im进行聊天对话时,可以将客户信息通过链接转给Udesk,这样客服在与客户对话时,就可以直接查看客户信息。通过客户信息辅助组件也可以进一步了解此客户的订单等其他信息。

二、使用方法

在web im对话窗口的链接(http://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&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


相关推荐:web im自定义界面