钉钉网页应用部署指引

操作步骤

创建钉钉应用及配置

1. 钉钉管理员通过钉钉开放平台创建应用。

   

2. 创建应用后，在应用详情中的corpId、appId等信息后续会在智能对话机器人渠道部署中使用。

   

3. 在钉钉应用中，单击添加应用能力->网页应用新增网页应用。

   

4. 配置网页应用。

   1. 独立页面部署地址需要进入智能对话机器人的机器人空间，选择部署渠道->服务界面部署->独立页面部署查看。

   2. 获取独立页面部署地址之后，在钉钉网页应用->应用首页地址和PC首页地址配置上独立页面部署地址，并在地址结尾拼接上&corpId=$CORPID$，例如渠道部署的独立页面部署地址是https://chatbot.aliyuncs.com/intl/index.htm?locale=zh-CN&from=xxxx，则输入框中输入https://chatbot.aliyuncs.com/intl/index.htm?locale=zh-CN&from=xxxx&corpId=$CORPID$。

      

5. 在权限管理中为应用授予如下权限。

   

6. 在版本管理与发布页面，创建新版本并发布。

   

配置智能对话机器人

1. 进入机器人空间，选择部署渠道->网页渠道->服务界面部署->钉钉H5页面部署，单击钉钉授权管理按钮。

2. 填入钉钉中应用对应信息。

   

3. 确定后，单击列表中的绑定至当前渠道。

   

4. 最后单击部署按钮即可将配置部署到指定环境。

   

验证信息获取

1. 上述步骤完成后，即可在钉钉端工作台搜索到对应应用，在应用中即会展示渠道部署的c端页面，在c端问答时，将会携带钉钉的账户信息到智能客服的随路参数中。

   

   随路参数映射如下（注意，假如钉钉中对应账号没有维护账户的对应信息，则取不到对应值）。

   随路参数	钉钉中变量	含义
   ding_name	name	员工钉钉企业中名称
   ding_unionid	unionid	员工在钉钉企业中的唯一ID
   ding_work_place	work_place	工作地点
   ding_email	email	邮箱
   ding_dept_id_list	dept_id_list	部门ID列表
   ding_job_number	job_number	工号
   ding_hired_date	hired_date	入职时间
   ding_title	title	职位
   ding_extension	extension	钉钉中自定义字段，例如自定义字段名称为“自定义”，则在流程中使用时使用${envVars['VENDOR_PARAM']['ding_extension']['自定义']} 获取字段的值

2. 后续客户可以通过接口API或者通过多轮对话的形式，根据账户信息来进行自定义的处理，例如下面是拿到账户名并输出的示例， 在编辑完成对话流并将对话流&机器人发布到线上后，在钉钉端输入对应意图问法即可输出钉钉账户名称。

   

3. 钉钉端搜索应用，在应用内输入问法，即可触发机器人回复，根据回复验证是否获取到用户信息。

   

其他配置

问答视角配置

在机器人回复消息时，我们希望根据用户的标识提供个性化的答案。通过在配置知识库时设定不同的视角，可以使机器人在回应时自动选择与用户身份相匹配的答案。在钉钉中通过以下方式为特定用户设置相应的视角：

1. 在钉钉管理后台中打开成员信息管理，添加自定义字段。

2. 配置视角，请参考：视角管理。获得视角编码，如：FJnby7YfJf。

3. 在钉钉管理后台中填写用户的视角编码。

   • 方式1：在成员管理中选择对应的成员，单击更多>编辑人员信息>填写更多信息，填写视角编码。

   • 方式2：批量导出后，针对不同成员填写视角编码后，再导入。

常见问题