Ｕdesk反馈标签

Udesk反馈标签适用于嵌入在第三方系统，第三方系统可以在提交反馈标签的接口添加参数从而更改/添加客户及生成工单信息．

基本用法

内嵌代码示例

<body>
    <!-- 网页内容 具体代码请在管理中心渠道管理反馈标签处复制 -->

    <script src="xxxx://xxxx.xxx.cn/im_client/js/udesk_feedback.js"></script>
    <style type="text/css" media="screen, projection">
        @import url(xxxx://xxxx.xxx.cn/im_client/css/udesk_feedback.css);
    </style>

    <script type="text/javascript">
        if ("undefined" !== typeof(UdeskFeedback)) {
            UdeskFeedback.init({
                url: "xxxx://xxxx.xxxx.cn",
                mode: "knowledge_search",
                color: "rgb(175, 56, 56)",
                title: "反馈标签",
                position: "right",
                "u_customer_token": "abcdefghijklmn",
                "u_nick_name": "客户姓名tom",
                "u_email": "test@udesk.cn",
                "u_cellphone": "187xxxxxxxx",
                "u_organization": "Udesk",
                "u_description": "简单的描述",
                "u_customer_tags": "vip",
                "u_owner_id": "3",
                "u_owner_group_id": "62",
                "u_TextField_xxx": "",
                "u_SelectField_xx": "",
                "u_subject": "反馈主题",
                "u_content": "反馈内容",
                "u_status_id": "3",
                "u_priority_id": "2",
                "u_company_tags": "",
                "u_nonce":"694db2645b3f69a8",
                "u_signature":"315345C77C73A128CF9850EAD777F7A71D423A36",
                "u_timestamp":"1465878579000",
                "u_email":"feedback@udesk.cn"
            });
        }
    </script>
</body>

链接示例

http://rd-dota.udesk.cn/im_client/feedback_tab/new.html?u_nick_name=客户姓名tom&u_cellphone=187xxxxxxxx&u_organization=Udesk&u_customer_tags=vip&u_owner_id=3&u_owner_group_id=62&u_TextField_xxx=&u_SelectField_xx=&u_subject=反馈主题&u_content=反馈内容&u_status_id=3&u_priority_id=2&u_company_tags=&u_nonce=694db2645b3f69a8&u_signature=315345C77C73A128CF9850EAD777F7A71D423A36&u_timestamp=1465878579000&u_customer_token=abcdefghijklmn&u_email=feedback@udesk.cn&u_description=简单的描述&

客户身份认证 - 请求参数

当传递customer_token或客户邮箱或电话时会认为是已有客户登陆，会对客户身份认证;如果是访客的话不需要客户身份认证．如果是客户，请参考下面的加密算法．客户身份的识别顺序为：u_customer_token->u_email->u_cellphone.客户识别有效时间：１小时．

鉴权参数

参数名称	类型	值	是否必选	说明
u_nonce	String	随机数	是	随机数，动态的随机数安全系数更高
u_timestamp	String	时间戳	是	当前时间戳(13位毫秒)
u_customer_token/u_email/u_cellphone	String	客户ID	是	客户唯一标示，使用customer_token或邮箱或手机号
u_signature	String	加密算法	是	signature加密算法

signature加密算法

1.按后面参数及顺序拼接字符，以key=value&形式:u_nonce,u_timestamp,u_customer_token(u_email(u_cellphone)),im_user_key.

im_user_key获取位置【管理中心-即时通讯-网页插件-管理/添加客户信息中的KEY】

sign_str = u_nonce=value&u_timestamp=valuie&u_customer_token/u_email/u_cellphone=value&im_user_key

2.使用sha1计算出签名字符串

sign_str = sha1(sign_str)

3.将字符串转换为大写

sign_str = sign_str.toUpperCase()

示例
    sign_str = "u_nonce=9ca6fff5a509fb887ac72cf5c92010e7&u_timestamp=1455675719000&u_email=feedback@udesk.cn&b476f9f8-5309-4d0a-a2d4-af08c4507a15";
    sign_str = sha1(sign_str);
    sign_str = sign_str.toUpperCase();

传参示例

{
  "u_nonce":"694db2645b3f69a8",
  "u_signature":"315345C77C73A128CF9850EAD777F7A71D423A36",
  "u_timestamp":"1465878579000",
  "u_email":"feedback@udesk.cn"
}

客户参数

参数名称	类型	值	是否必选	说明
u_customer_token	String	鉴权token	否
u_email	String	客户邮箱	否
u_cellphone	String	客户电话	否
u_description	String	客户描述	否
u_organization	String	客户公司	否
u_owner_id	String	客户负责人ID	否
u_owner_group_id	String	客户负责组ID	否
u_customer_tags	String	客户标签	否	传入工单标签，用逗号分隔如："xx,xx"
u_SelectField_xxx	String	客户自定义字段	否	客户自定义字段唯一标识,可在自定义字段处查看

工单参数

参数名称	类型	值	是否必选	说明
u_subject	String	工单主题	否
u_content	String	工单内容	否
u_status_id	String	工单状态ID	否
u_priority_id	String	工单紧急度ID	否
u_company_tags	String	工单标签	否	传入工单标签，用逗号分隔如："xx,xx"
u_TextField_xxx	String	客户自定义字段	否	客户自定义字段唯一标识,可在自定义字段处查看

使用须知

1.用户自定义的请求参数不要以 u_ 开头，以避免与预置参数重复．

2.当url参数与表单参数（客户自定义参数）产生冲突时，系统将以url中预设的参数为准．

3.反馈标签表单设置中，工单模板选项作用为生成工单后默认展示的模板，实际在参数填充时可以填充其他模板的自定义字段．

Keys	Action
`?`	Open this help
`n`	Next page
`p`	Previous page
`s`	Search