Administrator
发布于 2025-03-18 / 22 阅读
0
0

企微消息API接入(应用、客服、bot)

一、简介

本文介绍企业微信的接入,主要实现下面几个功能:

  • 实现客服的消息接收和回复(用途:AI 智能客服)

  • 通过机器人 Bot 推送信息(仅适用于内部群)

  • 接收应用消息和回复、推送应用消息(企业人员、内部人员)

注意:

1、应用仅企业人员可见,能被外部人员(客户)搜索、添加、使用的是第三方应用。第三方应用开发要注册服务商、上架审核等等,比较麻烦,不在本文涉及范围之内。后面提到的应用都是指企业内部应用

2、针对外部群、外部客户的信息发送,企微没有提供相应的 API。官方提供的群发助手工具,对同一个客户、客户群一天也只能发送一条。

3、企微官方没有提供群消息监听。

企微后台地址:work.weixin.qq.com (管理员扫码登录)

开发者中心(API 对接):developer.work.weixin.qq.com

企微服务商后台(开发第三方应用,类似钉钉的 ISV):open.work.weixin.qq.com

二、前期工作

1、设置超级管理员(可选)

设置管理员主要原因是:企微登录会话有效期较短,上午扫码中午就失效了。对接过程因为失效需要多次麻烦管理员扫码,把开发人员设置成超级管理员,开发就会比较顺畅。

设置方式:

位置:我的企业 | 权限管理 | 管理员一栏 "+" 号。添加后会提示【需要管理员手机端确认】,手机端确认后即完成管理员设置。

2、获取 CorpId

位置:我的企业 | 企业信息 | 企业 ID

三、应用

1、创建应用

位置:应用管理 | 应用 | 自建 | 创建应用。上传 logo、输入应用名称,保存即可创建成功。点击应用图标,进入详情页,获取应用对接参数:AgentId、Secret。

2、应用配置

2.1 消息回调配置

配置消息服务器,用于接收应用和客服收到的消息。

位置:进入应用 | 接收消息 | 设置 API 接收。

2.2 编写回调接口(URL)

上一步配置需要填写回调 URL,需要我们实现消息的接收和回复。这一步需要我们根据官方 API 文档和 DEMO 编写相应程序。

强烈建议使用官方 DEMO 的实现。如果自行实现,有一个坑需要注意,加密用到的 AES 加密,其中明文分块填充 Paddding 用的是 32 字节,很多第三方库默认用的是 16 字节填充,不能直接使用第三方库。Padding 实现请参考 DEMO。如果不熟悉 AES 加密,建议使用 DEMO 的实现。

2.3 配置 ip 白名单

很多接口只有白名单的 ip 才能访问,比如发送应用消息。

位置:进入应用 | 企业可信IP

四、客服(外部群)

1、创建客服账号

位置:应用管理 | 微信客服

2、通过 API 管理客服消息

通过 API 管理需要依赖【应用】的回调。回调通知客服接收到的消息和相关事件。需要把上述【应用】相关的内容跑通。

位置:应用管理 | 微信客服 | 页面底部 | 通过API管理会话消息 | 企业内部开发,选择【应用】,绑定客服账号。

3、配置客服接待人员

第一步创建的客户账号,其中配置的【人工接待人员】,需要在应用的【可见范围】内,不然不能通过此客服 id 发送信息给客户。

五、群机器人

把自己添加进【可创建机器人的白名单】,位置:应用管理 | 自建 | 机器人

创建机器人:

位置:企微手机端、PC端 > 内部群 > 右上角三个点(详情)> 添加群机器人。

创建完成之后可以获取到机器人的 Webhook 地址,通过 Webhook 地址直接 HTTP POST 请求推送消息即可,十分简单。

有几点需要注意:

  • 机器人只能在企业内部群创建,外部群不支持。

  • 企微不支持群消息监听,机器人也仅仅只能推送消息。

六、补充

1、参数清单(自用)

Token、EncodingAESKey 用于回调接收消息,OPEN_KF_ID 用于收到回调后发送客服回复消息。

CorpId:

AgentId:

Secret:

Token:

EncodingAESKey:

OPEN_KF_ID:

2、微信默认创建的机器人

1、【小助理】机器人

用于自动回复,群详情开启【自动回复】后会自动添加。

企微后台添加回复规则,位置:客户与上下游 | 客户联系 | 自动回复

2、【客服助理】

在群聊中@客服助理,自动发送【推荐客服】名片。

  • 创建客服账号

  • 设置【推荐客服】。位置:客户与上下游 | 客服助理

手机端 > 群设置,启用客服助理。启动后,群聊自动添加【客服助理】机器人。


评论