本文内容

通过接口推送消息

WPS协作内的开发者在创建了应用之后,面临的第一个需求就是通过应用机器人向WPS协作的用户发送一条消息。接下来介绍如何顺利的发出第一条应用消息。首先你需要创建一个应用,并在开发者后台获取到应用的 AppId 和 SecretKey,下述的流程都是建立在你已经拥有了一个应用的前提下的。

如果想测试发送消息效果,可创建测试应用,并在测试应用上调接口发送消息(值得注意的是,测试应用申请接口权限,仍需要企业管理员审核,这点与正式应用一致)。

准备工作

1. 获取接口权限

在开发者后台权限管理栏,申请相关接口权限。其中发送消息、更新消息需要申请“通过接口发送消息“和“企业通讯录”接口权限。

(图 1:权限管理)

2. 获取企业授权

当应用需要获取企业内通讯录信息以及调用接口发送消息时,需要获取企业授权才可以调通接口,获取数据。

3. 获取消息接收者 id

  • 如需发送给用户,则需提供消息接收方的企业 id(company_id)和用户 id(company_uid)。

  • 如需发送给部门,则需提供消息接收方的企业 id(company_id)和部门 id(dept_id)。

  • 如需发送给企业,则需提供消息接收方的企业 id(company_id)。

  • 如需发送到群聊,则需提供消息接收方的群聊 id(chat_id)。

有多种通讯录接口可以获取部门 id 和用户 id,可根据接口信息按需调用。

消息接收者需在应用的可见范围内,否则将无法发送成功,如未配置可前往开发者后台配置应用可见范围。


发送应用消息

根据接口要求构造消息体发送应用消息

  • 支持将消息发送给用户、部门、企业、群聊。
  • 支持的消息类型有文本消息,卡片消息,文件消息,图片消息,图文链接消息,图文混排消息,语音消息,视频消息,模板卡片消息。

(图 2:应用消息)

更新应用消息

如需更新应用消息,可调用更新消息接口更新应用消息。

(图 3:更新应用消息)
本文内容