企业微信第三方应用
应用介绍
企业微信免费提供专业的协作、管理和客户运营工具,实现对内协同高效,对外连接12亿微信用户。当我们需要结合企业微信和业务系统的时候,我们需要建立一个企业微信第三方应用,企业微信第三方应用能通过调用企业微信的API接口,将企业已有应用接入企业微信,并展示在工作台中,实现发送消息/接收消息/自动回复。
官网:https://work.weixin.qq.com/
应用场景介绍
通过HiFlow场景连接器,可以快速打通企业微信第三方应用和其他应用之间消息&数据,实现比如定时/自动发送消息/接收消息/自动回复等。
应用支持的触发条件和执行操作
(一)企业微信第三方应用应用支持的触发条件如下:
1、增加客户:添加新的客户
2、删除客户:员工主动删除客户
3、编辑客户:编辑已有的客户信息
4、接替客户失败:员工A将客户接替给员工B,接替失败
5、接收文本消息:可接受发给此应用的文本消息
(二)企业微信第三方应用应用支持的执行操作如下:
1、发送文本消息:发送纯文本消息
2、发送富文本消息:可以给文本添加样式,比如加粗、更改颜色、加超链接等
3、获取客户详情:查询外部客户的昵称、备注、描述标签等内容
4、获取部门成员详情:通过部门ID,获取部门内的成员名称、成员ID等内容
应用账号和参数配置
(一)企业微信第三方应用使用应用的前置条件
1、需要是企业微信管理员 2、需要在企业微信第三方应用的可见范围 3、需要付费,由于企业微信第三方应用调整了收费政策,故安装该应用之后,90天内免费使用,90天后继续使用需要付费,否则接口将被限制,具体收费说明详见企业微信第三方应用收费说明
(二)添加新的企业微信第三方应用应用账户
添加新的企业微信第三方应用应用账户需要:
1、管理员扫码添加 2、设置应用可见范围 3、安装之日起90天免费,90天后继续使用,需付费。特别注意收费是根据可见范围进行收费的,如果修改可见范围,可以在企业微信管理后台-应用管理-第三方-HiFlow场景连接器-可见范围中修改
(三)企业微信第三方应用的配置参数
作为触发条件时,以【接收文本消息】为例,配置参数如下 1、添加账号
- 添加账号前,仔细阅读付费说明,90天试用期,从首次安装之日起开始计算,90天后继续使用,需要付费,否则将限制使用
- 添加账号:需要企业微信的管理员扫码,并安装应用,设置可见范围,并同意安装授权后,可添加成功
- 若在安装之后,还需要修改可见范围,则可以在企业微信管理后台-应用管理-第三方-HiFlow场景连接器-可见范围中修改
2、配置参数 配置参数1:企业微信第三方应用触发条件:接收文本消息
- webhook地址:此处无需修改内容,只做展示用
- 样本数据:先在企业微信客户端的对话列表中,找到【腾讯轻联】,发送一条消息,再点击测试并预览(此步骤非常重要,一定要流程配置)
- 发消息具体步骤 -先在企业微信客户端的对话列表中,找到【腾讯轻联】,再发送一条测试消息
① 先在企业微信客户端-工作台-找到【腾讯轻联】
② 点击右上角设置,点击发送消息,发送消息后,需要再在流程中的【测试并预览】获取到最新的样本数据,并选中
配置参数2:企业微信第三方应用执行条件:发送富文本消息
- 消息内容:可以添加变量,或填入文本,内容将被企业微信第三方应用发出,注意仅支持绿色、黄色、浅灰色,若选择其他的颜色,则默认使用黑色
- 发送给【指定成员】:可以输入@all,提醒全部成员,或者添加变量;可以选择候选值,即从通讯录中选择,或者输入企业成员的openid(必须是此第三方应用的openid),用来提醒多人,注意发送多人需要用中/英文逗号隔开
- 发送给【指定部门】:可以填写部门的openid(必须是此第三方应用的openid),用来部门下的全部成员
- 关于企业成员的openid说明:每个企业授权给企业微信第三方应用的时候,会默认生成对应的openid,来替代通讯录中的账号id,可以理解成是加密后的数据,所以openid只能通过流程中的某些事件获取,比如接收文本消息的时候,会返回成员userid,即企业成员的openid。 关于发送指定成员和指定部门,至少选择一种发送范围,重复的人员只发送一次 以下为流程配置的示意图,可参考
常见问题
- 添加账号时,出现下方提示,证明曾经安装过,可以重新安装。(重新安装,不会影响90天的计算,90天是按照首次安装时间计算的)
应用相关说明
1、付费说明 由于企业微信第三方应用调整了收费政策,故安装该应用之后,90天内免费使用,90天后继续使用需要付费,否则接口将被限制,具体收费说明详见企业微信第三方应用收费说明
2、访问频次限制 每应用不可超过帐号上限数200人次/天(注:若调用api一次发给1000人,算1000人次;若企业帐号上限是500人,则每个应用每天可发送100000人次的消息) 每应用对同一个成员不可超过30次/分钟,超过部分会被丢弃不下发 发消息频率不计入基础频率*