自建应用开发
创建应用-H5
-
通过以下两种途径，可新建自建应用：
- 登录蓝信管理平台，选择“应用中心 - 应用管理”，“自建应用”分组中点击“新建应用”。
- 登录蓝信开发者中心，选择“应用开发 - 自建应用开发”，点击“新建应用”。
-
填写应用基本信息，点击“保存”，即可创建应用!
- 应用如需在蓝信客户端工作台列表中展示入口，需提供“移动端地址/桌面端”链接地址
- 应用如需在蓝信管理平台中，直接打开应用管理后台，需提供“管理后台地址”
- 应用创建成功后，即可在应用列表中看到。
- 点击应用卡片，进入应用详情页面，可以查看生成的 AppId、AppSecret 和开放平台接入地址，用于获取 APP_TOKEN 进行开发，同时支持对应用进行相关配置。
新创建的自建应用，在蓝信管理平台中，应用的“测试模式”默认打开，仅在组织管理员和应用运营者的工作台可见。
创建应用-原生
-
通过以下两种途径，可新建自建应用：
- 登录蓝信管理平台，选择“应用中心 - 应用管理”，“自建应用”分组中点击“新建应用”。
- 登录蓝信开发者中心，选择“应用开发 - 自建应用开发”，点击“新建应用”。
-
蓝信开放平台支持蓝信工作台打开第三方原生应用的接入方式。如果是原生应用接入蓝信，蓝信开发者中心创建自建应用时选择“原生应用”的应用类型，并根据提示填写相关参数，目前蓝信仅支持Android 和 iOS两个客户端类型的原生应用。
Android原生应用接入蓝信工作台，“常规方式” 需要填写的参数如下：
-
Android三方应用的下载地址（Android设备在手机没有安装第三方应用时跳转到对应下载地址，如不需要此功能可不填写），地址为应用市场或企业包地址，例如应用宝中的下载地址。
-
输入第三方应用的Android包名，例如:com.tencent.mm
-
输入打开第三方应用的指定跳转类路径（包名+类名），蓝信将通过该路径跳转到第三方应用的指定页面 例如:com.tencent.base.SplashActivity
-
授权登陆选项开启后，人员在蓝信工作台打开原生应用时，蓝信客户端将会在Intent中以“code”为key传递人员身份信息免登授权码。应用使用人员身份信息免登授权码通过蓝信开放平台服务端接口可以获取人员身份信息，详情参考认证授权页面中的 “免登授权码获取用户身份信息流程”
Android原生应用接入蓝信工作台，“Scheme方式” 需要填写的参数如下：
-
Android三方应用的下载地址（Android设备在手机没有安装第三方应用时跳转到对应下载地址，如不需要此功能可不填写）
-
输入打开第三方应用的路由URL，格式为：schemes://path?source=lanxin；schemes: 必填，被打开应用的.plist文件中必须包含了这个对应的字段才可打开，可直接把该值schemes://输入浏览器中进行验证打开; path: 地址，建议使用bundleId反序，可不填；source：标示来源，必填。
-
授权登陆选项开启后，人员在蓝信工作台打开原生应用时，蓝信客户端通过schemes打开应用时以“code”为key传递人员身份信息免登授权码，例如：schemes://path?source=lanxin&
code=xxxx。应用使用人员身份信息免登授权码通过蓝信开放平台服务端接口可以获取人员身份信息，详情参考认证授权页面中的 “免登授权码获取用户身份信息流程”
iOS原生应用接入蓝信工作台，“Scheme方式” 需要填写的参数如下：
-
iOS三方应用的下载地址（iOS设备在手机没有安装第三方应用时跳转到对应下载地址，如不需要此功能可不填写）
-
输入打开第三方应用的路由URL，格式为：schemes://path?source=lanxin；schemes: 必填，被打开应用的.plist文件中必须包含了这个对应的字段才可打开，可直接把该值schemes://输入safari浏览器中进行验证打开; path: 地址，建议使用bundleId反序，可不填；source：标示来源，必填。
-
授权登陆选项开启后，人员在蓝信工作台打开原生应用时，蓝信客户端通过schemes打开应用时以“code”为key传递人员身份信息免登授权码，例如：schemes://path?source=lanxin&
code=xxxx。应用使用人员身份信息免登授权码通过蓝信开放平台服务端接口可以获取人员身份信息，详情参考认证授权页面中的 “免登授权码获取用户身份信息流程”
- 应用创建成功后，即可在应用列表中看到。
- 如果需要对原生应用的相关参数进行编辑，应用详情->基本信息->编辑，可以打开编辑页面对相关信息进行编辑。
- 点击应用卡片，进入应用详情页面，可以查看生成的 AppId、AppSecret 和开放平台接入地址，用于获取 APP_TOKEN 进行开发，同时支持对应用进行相关配置。
新创建的自建应用，在蓝信管理平台中，应用的“测试模式”默认打开，仅在组织管理员和应用运营者的工作台可见。
开发和配置应用
针对自建应用，目前支持对应用的基本信息、工作台入口、快捷入口、可信域名和智能机器人进行配置。
基本信息
进入某个应用，在“基本信息”页面可对应用的基本信息进行设置。
- 应用类型： 目前支持打开H5应用和原生应用。
- 管理后台地址： 即通过蓝信管理平台，跳转值应用管理后台的链接地址。
- 支持客户端： 即当前应用所支持的终端类型。
- 删除应用： 应用被删除后，所有已安装该应用的组织将不可用。
入口管理
工作台入口
工作台入口，即在蓝信客户端“工作台”点击进入的入口。 进入某个应用，在“入口管理”页面可对应用的工作台入口跳转地址进行设置。自建应用支持添加多个工作台入口，每个入口可以有自己独立的名称，头像，入口地址，消息通道等。
快捷入口
快捷入口，即在蓝信客户端私聊会话、群聊会话、导航栏+号等位置点击进入的入口。 进入某个应用，在“入口管理”页面可对应用的快捷入口进行添加、编辑和删除操作。
- 自建应用，支持添加多个快捷入口。
- 目前支持以下位置的快捷入口设置：
- 群会话+号
- 私聊会话+号
- 公众号会话+号
- 个人中心
可信域名
蓝信通过 OAuth 2.0 协议授权向应用提供蓝信的数据和能力，应用如需调用蓝信开放平台接口获取蓝信用户信息，需提供“可信域名”地址。可信域名对应于应用获取免登录授权码（OAuth code）时使用的 redirect_uri 所指定的应用接口地址。
进入某个应用，在“可信域名”页面，授权方选蓝信授权（注：第三方平台授权不适应于直接对接蓝信的应用），可添加当前应用的可信域名，支持添加多个地址。 在进行前端页面调试时，可以将本地域名添加至其中，在正式上线时删除。
回调事件
应用如需蓝信开放平台推送或拉取应用数据，如同步蓝信分支、人员的修改，需提供“回调地址”。
通过对回调事件的订阅，应用可监听蓝信对应的操作。
- 进入某个应用，在“回调页面”中，配置回调地址。
- 订阅事件回调地址： 用于应用订阅平台内事件回调，例如人员和部门信息的变更等，平台通过该接口将平台内应用订阅事件数据主动推送到应用。
- 动态数据拉取地址： 用于工作台角标，或客户端离线情况下的应通知事件回调拉取等，平台通过该接口拉取和该应用相关的某些业务数据。
- 回调地址添加后，在下方可看到目前蓝信提供的回调事件，通过是否开启来监听/取消监听回调事件。
目前支持回调事件如下：
- 公众号回复
- 公众号订阅
- 人员变更
- 电话追状态变更
- 人员增加
- 人员删除
- 分支增加
- 分支变更
- 分支删除
- 安装应用
- 卸载应用
- 证书创建
- 证书撤销
- 位置通知
- 用户退出
- 数据读取范围变更
- 开放平台推送事件时会使用提供的回调密钥对消息内容进行加密和签名。 应用需要试用该密钥和签名令牌对收到的回调事件数据进行验签和解密。
接口权限
蓝信开放平台提供了丰富的服务端接口能力，创建应用后，默认开启了获取用户身份、发消息等基本权限。 应用如需调用其他高级权限，需在开发者中心单独设置，如获取通讯录权限、获取人员手机号信息等。为防止人员敏感信息泄露，应用应该根据实际需要按最小集进行设置。
基本权限
高级权限
智能机器人
蓝信智能机器人功能可以让应用以智能机器人的身份和自然人进行私聊和群聊，开发者可以在智能机器人管理页进行机器人的功能的开启与管理功能。
发布应用
应用发布
自建应用，默认为“已发布”状态，本组织自动安装。
在蓝信管理平台中，关闭“测试模式”后，工作台入口的可见范围，以实际设置为准。
邀请码安装
自建应用发布后， 同一部署环境中的其他组织如需安装该应用，可生成该应用的安装邀请码，使用该邀请码可以安装应用到同一部署环境中的其他组织。
一个邀请码仅可使用一次，有效时长为 24 小时，如果有效期内未使用，过期后不可使用。
安装及使用
安装应用
组织安装应用的方式有以下 3 种：
- 组织内部应用： 本组织自动安装
- 第三方应用：需组织管理员在蓝信管理平台的应用市场中手动安装
- 邀请码安装：自建应用发布后，同一部署环境的其他组织支持通过“邀请码安装”的方式进行安装。
设置应用权限和可见范围
在蓝信管理平台，可对当前组织已安装的应用进行管理。
- 应用运营者设置： 安装了应用的组织可以设置组织内该应用的运营者作为应用的管理员。
- 应用数据读取范围设置： 安装了应用的组织可以通过应用数据读取范围来限制应用读取该组织的组织架构数据的范围。
- 应用归属分支设置： 安装了应用的组织可以将该应用挂接到组织内的某个分支下，方便分支管理员进行管理，不需要分级分权时，设置为根分支即可。
- 应用工作台入口可见范围设置：组织内安装的应用，“测试模式”默认打开，仅在组织管理员和应用运营者的工作台可见。关闭“测试模式”后，工作台入口的可见范围，以实际设置为准。
