反馈标签支持传参

Udesk反馈标签

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_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_email=feedback@udesk.cn&u_description=简单的描述&

客户身份认证 - 请求参数

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

鉴权参数

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

signature加密算法

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

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

sign_str = u_nonce=value&u_timestamp=valuie&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_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.反馈标签表单设置中,工单模板选项作用为生成工单后默认展示的模板,实际在参数填充时可以填充其他模板的自定义字段.