系统设置

帮助主题为工单的类别，支持设置多级别的帮助主题。帮助主题将在工单创建时显示，并支持自定义帮助主题的查询与统计。

共支持10级帮助主题，第一级不超过30个分类，一共不超过1000个帮助主题选项。

进入“管理员模式 > 工单 > 工单帮助主题自定义”页面，可以自定义帮助主题选项。

优先级用于标记工单的紧急或重要程度。在工单创建、工单处理过程中，可以选择或修改工单优先级。支持根据工单优先级筛选工单。

进入“管理员模式 > 工单 > 工单优先级自定义”页面，可以自定义优先级选项。

• 帮助主题变更事件。
• 优先级变更事件。
• 状态变更事件。
• 分配坐席变更事件。
• 技能组变更事件。
• 标题变更事件。
• 工单创建事件。
• 工单公开回复事件/工单内部回复事件。
• 工单最新属性信息。

• 工单系统将向用户配置URL以POST方法推送消息。
• QueryParameters。
  1. timestamp:时间戳(String)。
  2. nonce: 随机字符串(String)。
  3. signature: 签名(String)。
• requestBody: 事件详情(jsonString)。
• signature 生成算法。

String [] array = {token, timestamp, nonce, message};//message 为通知事件
Arrays.sort(arrays);//自然排序
StringBuilder sb = new StringBuilder();
for (String array : arrays) {
   		sb.append(array);//拼接所有字符串
}
signature = DigestUtils.sha1Hex(sb.toString());//生成签名

1. 概要: {token, timestamp, nonce, message}进行自然排序，依次拼接形成新字符串，对新的字符串采用SHA-1算法生成签名。
2. 签名开源算法参考。

<dependency>
<groupId>commons-codec</groupId>
<artifactId>commons-codec</artifactId>
<version>1.10</version>
</dependency>

• 注意
  1. 工单系统向URL进行事件推送,其responseCode 为2XXX认定为推送成功。
  2. 因为某些原因，系统判定没有推送成功时,会进行有限次重复推送(可以通过事件中id属性进行去重)。
  3. 有限次推送后没有推送成功的，将不在进行事件推送。

{
    "id": "aab80b90-5bc6-11e7-b868-373cdc119881",
    "timestamp": 1498629448393,
    "type": "event",
    "body": {
        "ticket_id": "aab80b90-5bc6-11e7-b868-373cdc119883",
        "ticket_no": "T0000100",
        "subject": "工单标题",
        "sla_date": "SLA日期",
        "created_date": "工单创建时间",
        "updated_date": "工单更新时间",
        "close_date": "工单关闭时间",
        "operator_info": {
            "id": "操作人id",
            "email": "操作人邮箱",
            "phone": "操作人手机号",
            "nickname": "操作人昵称"
        },
        "assign_info": {
            "id": "分配人id",
            "email": "分配人邮箱",
            "phone": "分配人手机号",
            "nickname": "分配人昵称"
        },
        "detailInfo": {
            "content": "工单详情",
            "help_topic": {
                "name": "帮助主题名称",
                "full_name": "帮助主题全路径名称"
            },
            "priority": {
                "name": "优先级信息"
            },
            "status": {
                "name": "状态信息"
            },
            "visitor": {
                "nickname": "访客昵称",
                "phone": "访客手机信息",
                "email": "访客邮箱"
            },
            "attachments": [
                {
                    "name": "附件名称",
                    "url": "附件地址",
                    "file_type": "文件类型",
                    "size": 1111
                }
            ],
            "form_name": "自定义表单名称",
            "form_value": {
                "field_name": "field_value"
            }
        },
        "events": {
            "created": "创建时间",
            "closed": "关闭时间",
            "reopened": "重新打开时间",
            "topic": [
                "topicA",
                "topicB"
            ],
            "priority": [
                "priorityA",
                "priorityB"
            ],
            "status": [
                "statusA",
                "statusB"
            ],
            "transferred": [
                "teamA",
                "teamB"
            ],
            "assigned": [
                "staffA",
                "staffB"
            ],
            "subject": [
                "titleA",
                "titleB"
            ]
        }
    }
}

• id: 事件的唯一标识。
• type:推送事件类型。
  1. event 工单属性变更事件。
  2. entry 工单公开回复。
  3. note 工单内部回复。
• body 详情。
  1. ticket_id 工单唯一标识。
  2. ticket_no 工单编号。
  3. subject 工单主题。
  4. xxx_date 日期相关采用ISO8601日期格式。
  5. operator_info 事件发起人信息。
  6. assign_info 工单当前分配人信息。
  7. detailInfo 工单其他属性详情。
     • content 工单内容。
     • help_topic 帮助主题信息。
     • priority 优先级信息。
     • status 工单状态。
     • visitor 工单相关访客信息。
     • attachments 工单相关附件信息。
     • form_name 绑定的自定义表单。
     • form_value 自定义表单信息。
       1. key 自定义字段标识。
       2. value 自定义属性值。
  8. events 工单属性变更事件详情。
     • created 工单创建。
     • closed 工单关闭。
     • reopen 工单被重新打开。
     • topic 主题变更。
     • priority 优先级变更。
     • status 状态变更。
     • transferred 技能组变更。
     • assigned 坐席变更。
     • subject 主题变更。
  9. 变更类事件，值为数组array，array[0]为原始值，array[1]为最新值。

• 工单公开回复(非邮件转工单)。
• 工单的分配提醒(已经开启租户)。
• 工单SLA到期提醒(SLA计划中配置)。
• 工单满意度评价发送(满意度评价邀请设置配置)。
• 工单触发器中发送邮件(触发器发送邮件操作)。

• 账号:邮箱登陆的用户名(包含@字符)。
• 密码:邮箱登陆的密码。
• 发信服务器:支持smtp协议的邮件服务器。
• 发送端口:smtp协议支持端⼝(通常为465或25)。

通常企业级邮箱，SMTP协议是默认开启的，私人邮箱需要开启协议，不同的邮箱在密码的使用上有一定的差异，请参考以下几种邮箱的开启方式。

• 开启发信协议支持:设置→账户→POP3/IMAP/SMTP/Exchange/CardDAV/CalDAV服务→IMAP/SMTP服务。
• QQ邮箱使用的是授权码方式，而不是密码。
• 发信服务器: smtp.qq.com。
• 发送端⼝: 465。

• smtp协议默认是开启的，确认方式:设置→客户端设置→开启服务。
• 账号密码与邮箱⼀致。
• 发信服务器: smtp.exmail.qq.com。
• 发送端⼝: 465。

• 开启协议⽀持: 设置→POP3/SMTP/IMAP。

• 163个⼈邮箱使用客户端授权密码进⾏登陆,在设置/客户端授权。

• 发信服务器: smtp.163.com。
• 发送端⼝: 465。

• 用户名密码与邮箱账号相同
• 开启协议,设置→客户端pop/imap/smtp
• 发信服务器: smtp.sina.com
• 发送端⼝: 465

• 邮件的每日的发送频率与发送总量受到不同的邮箱服务供应商的限制，详情请咨询相应邮箱的客服
• ⽤户名一般与发送地址是相同的，若是有差异，需要特殊设定，可联系⽀持部门

支持自定义工单状态，可以添加工单状态，或修改、删除系统默认工单状态（打开、已解决、已关闭）。

进入“工单 > 工单状态自定义”页面，点击“新增状态”按钮，添加自定义工单状态。

支持设置工单的SLA（Service Level Agreement，服务等级协议），对不同帮助主题下的工单进行特定的服务时长承诺。如超过服务期限，则将工单自动关闭。从而定期清除无效过期工单，也使工单各个状态统计更加合理准确，方便工单管理及提供坐席的KPI考核指标。

进入“工单 > SLA计划”页面，点击“新增SLA计划”按钮，添加SLA计划。

设置宽限期后，当工单创建后处理时间超过宽限期，则自动关闭工单，同时通过系统消息对当前处理人发自定义提醒。可通过系统消息内工单编号再次打开工单。

支持设置多个邮箱地址，作为工单系统的渠道邮箱。这些邮箱地址收到的邮件，将自动转为工单。

添加渠道邮箱：

1. 进入“管理员模式 > 工单 > 渠道邮箱”页面，点击右上角“添加渠道邮箱”按钮。
2. 填写邮箱账号、密码、发信服务器地址/端口、收信服务器/端口等信息，并保存。
3. 在渠道邮箱自定义页面的“开关”一列，勾选添加的渠道邮箱。

添加渠道邮箱过程中，可配置以下功能：

• 自动分配：将通过该渠道邮箱创建的工单自动分配至某个技能组。
• 自动回复：设置收取邮件后的自动回复模版，包括标题和内容。
• 邮箱签名：设置通过该渠道邮箱发出的邮件的签名（请尽量保证同时仅启用一个签名）。
• SSL连接：是否启用SSL安全连接。
• 保留备份：是否在原收件箱中保留邮件备份。

支持设置工单的字段（系统字段和自定义字段）。系统字段仅支持排序，不可修改或删除；支持添加、修改、删除自定义字段。 进入“管理员模式 > 工单 > 字段自定义”页面，可以添加自定义字段，对字段进行排序。

新建表单时，可通过新建字段来对表单进行编辑，字段包含单行文本、多行文本、下拉选项。自定义表单中设置的字段将显示在工单创建时填写的表单中。

可通过触发器设置支持工单自动任务，支持最大1000条触发器同时执行。

触发器条件支持：状态、优先级、帮助主题、分配技能组、分配坐席、渠道邮箱； 触发器动作支持：更新状态、更新优先级、更新帮助主题、更新分配技能组、更新分配坐席、发送邮件、设定SLA、系统消息

管理员自定义工单满意度评价邀请信息，可通过设置特定的发送时机来主动邀请用户对工单处理作出满意度评级（1-5星），每个档位评价可自定义备注。评价信息由系统邮箱发送到用户邮箱。

网页表单是嵌入到网页上的一个自定义表单，字段可灵活控制，不受其他渠道的终端限制，可灵活应用于PC、WEB、App、H5、公众号底部菜单、客服欢迎语、机器人自动应答等场景中。客户通过填写网页表单，可快速将服务请求提交到客服那里。

• 提供H5页面用来提交工单。
• 不同H5渠道的工单的自动流转。
• 集成到iframe中进行提交工单。

管理员模式→工单→网页渠道→新增网页渠道。

• 工单页面tab名称。
• 工单页面标题。

定义网页渠道使用的自定义表单。

• 分配至: 定义网页渠道创建工单自动流转，可以到技能组或者是某个组下具体坐席。
• 初始化状态
  1. 当设定“分配至”后，设定工单状态有效(当初始化状态设置为“未分配”时，设置无效，系统将默认设置为“已分配”状态)。
  2. 当未设定“分配至”设置，初始化状态配置无效，系统默认设置为“未分配”状态。

• 工单属性字段: 工单标题、工单内容,上传附件(附件将保留3-6月时间)。
• 访客属性字段: 访客昵称，访客手机号，访客邮箱。

提交全部信息后系统将自动生成一个URL展示在网页渠道列表中，可以点击复制按钮移植到需要的终端中进行工单收集（移动端适配）。