文档

钉钉网页应用部署指引

更新时间:

智能对话机器人提供钉钉网页应用接入方案,需要钉钉管理员按照如下步骤完成配置。

具体步骤

步骤一:钉钉建立应用

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

image.png

创建应用后,在应用详情中的corpId、appId等信息后续会配置到“阿里云智能客服”渠道部署配置中使用

image.png

在钉钉应用中,点击“添加应用能力->网页应用”新增网页应用

image.png

在网页首页地址&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$

image.png

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

image.png

在“版本管理与发布”页面,创建新版本并发布

image.png

步骤二:对话机器人新增钉钉渠道配置

在智能对话机器人的渠道部署管理页面,服务界面部署

image.png

在弹窗中,通过新增授权钉钉

image

填入钉钉中应用对应信息

image.png

确定后,点击列表中的“绑定至当前渠道”

image.png

最后点击渠道部署的“部署”即可将配置部署到指定环境。

image.png

步骤三:验证信息获取及后续使用

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

image.png

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

随路参数

钉钉中变量

含义

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']['自定义']} 获取字段的值

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

image.png

image.png

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

image.png

image.png

其他配置

问答视角配置

在机器人回复消息时,期望根据用户的标识回复不同的答案,在配置知识的时候可以配置视角,回复答案的时候会回复对应的视角答案。那么如何在钉钉中针对用户配置对应的视角呢?

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

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

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

    1. 方式1:在成员管理中选择对应的成员,点击更多>编辑人员信息>填写更多信息,填写视角编码image

    2. 方式2:批量导出后,针对不同成员填写视角编码后,再导入。导入导出链接

常见问题

Q:打开时为什么弹出安全校验按钮?流程中无法拿到用户信息?

A:钉钉端配置时,不要配置服务器出口IPimage