绑定钉钉推送消息-操作指南

❶在钉钉开放平台自建应用 → ❷ 在紫鸟开放平台完成应用绑定 → ❸ 在紫鸟浏览器内绑定钉钉账号

一、钉钉自建应用创建流程

完成应用创建有4个步骤：创建应用**→为应用配置机器人（设置权限、安全配置）→ 应用版本发布****→**导入消息卡片模板。

1.1 进入开发者后台

• 使用管理员账号登录钉钉开放平台（https://open.dingtalk.com）

• 选择目标开发组织，进入应用开发平台

• 重要！！！进入应用开发平台后，请先找个小本本，把右上角区域的 CorpId 参数值（此参数值即表示钉钉企业id）记下来

1.2 创建应用

1、点击顶部菜单栏”应用开发”，进入应用管理界面

2、点击右上角”创建应用”，按照以下内容填写，点击[保存]完成创建：

• 应用名称：紫鸟助手
• 应用描述：紫鸟浏览器内的消息推送，包含设备到期提醒、账户余额告警，新成员加入申请，监管告警通知，成员访问申请等。
• 上传应用图标（右键保存图片）：
• 最后记得点击[保存]

3、创建应用之后，还需要再次拿出小本本，记录3个参数

• 在凭证与基础信息中找到所需参数复制

1.3 创建机器人

1、完成[应用]的创建之后，会自动跳转进入应用详情页面，如果不小心退出，还可以再次点击应用进入。

2、在应用页面内添加应用能力—机器人，点击[配置]按照以下内容填写

• 机器人名称（直接使用应用名称）：紫鸟助手
• 机器人图标（直接使用应用图标）：
• 机器人简介：紫鸟消息推送
• 机器人描述：紫鸟浏览器内的消息推送，包含设备到期提醒、账户余额告警，新成员加入申请，监管告警通知，成员访问申请等。
• 机器人消息预览图（右键保存图片）：
• 最后记得点击[发布]

3、为机器人添加必要的权限，以接收紫鸟消息

• 需要开通的权限如下（请仔细核对并开通，缺少权限将可能导致消息无法推送）

• 权限设置入口

• 复制“权限信息”的内容快速查找，申请权限

4、进行安全设置，以确保紫鸟推送消息不会被拦截

• 重定向URL（回调域名）： https://open-login.ziniao.com/loginResult,xxxxxxxxx待提供正式地址
• 端内免登地址：待提供正式地址

5、完成机器人所有配置之后，还需要再再次拿出小本本，记录1个参数

1.4 发布版本

1、在左侧菜单找到“版本管理与发布”，在右上角【创建新版本】

2、填写版本的基础内容，选择员工的范围，完成保存发布

• 保存后在弹窗内直接发布

1.5 创建接收消息的卡片模板

1、新建一个模板：在当前页面，顶部菜单区域，点击进入”开放能力- 卡片平台”，点击【新建模板】

2、填写模板名称，关联应用选择前面创建的应用，点击创建

• 模板名称：紫鸟消息推送
• 卡片类型（默认选择）：消息卡片
• 卡片模板场景（默认选择）：普通卡片
• 关联应用：选择已经创建的应用
• 从模板创建：不选

3、在创建完成的页面中导入紫鸟的消息模板

• 下载紫鸟模板文件：点此下载模板
  • 下载的文件名称：紫鸟助手钉钉消息模板
  • 下载的文件格式：JSON文件

• 导入已下载的卡片模板

• 点击右上角【发布】

4、消息卡片模板发布之后，最最后一次拿出小本本，记录1个参数

• 找到对应的模板，复制模板ID

——————————————————————————————————————————————————————————————————

到这里就完成钉钉应用的所有创建了，在整个流程中，总共记录了6个参数，请再确认是否都已复制

——————————————————————————————————————————————————————————————————

二、在紫鸟开放平台完成应用绑定

2.1 登录紫鸟开放平台

1、使用“紫鸟账号”登录紫鸟开发开放平台https://open.ziniao.com/

• 建议在紫鸟浏览器内打开，能够自动登录当前的紫鸟账号

2、如果在紫鸟浏览器外，需要手动登录

• 除了开发者和Boss账号，其他权限的紫鸟账号需要使用紫鸟账号登录

• 已经登录了紫鸟浏览器，可直接点击账号授权登录

• 未登录紫鸟浏览器也可通过账号密码的方式登录

2.2 绑定已创建的钉钉应用

1、登录后点击右上角【进入控制台】

2、在左侧菜单找到“钉钉/飞书同步”，选择“紫鸟消息推送钉钉”，并对照前面记录的6个参数一一一填入

• 请确保参数正确，有一个参数错误都将导致消息无法接收。

三、在紫鸟浏览器内绑定钉钉账号

恭喜您！到这里就已经完成所有的步骤了，目前仅需要成员在紫鸟内浏览器内绑定钉钉账号即可实时接收消息。

3.1 绑定流程

1、登录紫鸟浏览器，在右上角下拉弹窗中找到[账号设置]

2、在“绑定管理”中点击[绑定钉钉]

3、使用移动端钉钉APP，扫弹窗中的二维码绑定

• 未扫码的提示

• 钉钉APP扫码的提示，扫码成功后的消息

3.2 解绑和换绑

• 在“绑定管理”中“解除绑定”

• 解绑成功后收到的消息提醒

四、错误情况说明

1、成员无“开放平台”开发者权限的，需要先跟Boss申请开发者权限，才能设置

• 成员申请页面

• Boss审核入口

2、在绑定时系统将根据情况，给到异常提醒

（1）在给机器人配置权限时，漏配置了部分权限，在绑定时给到的提示如下：

• 应用尚未开通所需的权限：管理微应用的权限，请联系企业管理员前往钉钉开放平台申请并开通：https://open-dev.dingtalk.com/appscope/apply
• 应用尚未开通所需的权限：通讯录个人信息读权限，请联系企业管理员前往钉钉开放平台申请并开通：https://open-dev.dingtalk.com/appscope/apply
• 应用尚未开通所需的权限：成员信息读权限，请联系企业管理员前往钉钉开放平台申请并开通：https://open-dev.dingtalk.com/appscope/apply

（2）AgentId填写错误的提示：

• AgentId填写有误，请确认后再填写

（3）管理员在发布版本时，应用权限的范围选择了部分员工，不在权限范围内的员工，绑定时会提示无使用权限：

• 绑定失败，您的账号暂未获得此应用的使用权限。 请联系管理员，前往【钉钉开放平台 > 应用管理 > 版本管理与发布】中为您添加权限。

（4）钉钉账号若已被其他紫鸟用户绑定，绑定时将提示具体绑定的成员成员：

• 该账号已被紫鸟成员 用户名（姓名） 绑定

（5）若消息卡片模板id填写错误，绑定后将导致无法发送消息，错误提示如下

• 账号绑定失败，消息推送卡片模板不存在，请联系企业管理员操作。

（6）机器人code填写错误，绑定时的错误提示

• 应用机器人不存在，请联系企业管理员操作 关键字：消息，推送 需要实现紫鸟绑定钉钉消息推送主要有3个步骤