文档

钉钉渠道接入步骤

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

步骤一:钉钉建立应用

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

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.png

填入钉钉中应用对应信息

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. 钉钉端配置时,不要配置服务器出口IPimage

  • 本页导读 (0)
文档反馈