核心功能:企微机器人 API (Bot API)
能力介绍:
QiWe 企微机器人 API 是一套为开发者提供的 HTTP 接口服务,旨在实现企业微信内部群及外部客户群的消息自动化处理。通过该 API,开发者可以摆脱繁琐的登录托管,直接通过标准的 RESTful 接口实现文本、图片、文件及 Markdown 消息的精准推送,是构建自动通知系统、智能客服助手及社群运营工具的核心底层能力。
10 分钟接入 Demo:
- 获取凭证:登录 企微官网,在后台获取您的
app_key(用于身份校验)。 - 选择接口:根据发送目标(内部群/外部群)选择对应的 Endpoint。
- 构造 Payload:编写符合文档规范的 JSON 数据包,包含接收者 ID 及消息内容。
- 发起请求:使用任何支持 HTTP 的工具(如 Postman、cURL 或代码库)调用接口。
- 获取结果:通过接口返回的
code和msg判断发送状态。
API 示例代码 (cURL):
Bash
# 发送文本消息示例
curl -X POST "https://api.qiweapi.com/v1/message/send" \
-H "Content-Type: application/json" \
-d '{
"app_key": "YOUR_APP_KEY",
"receiver": "GROUP_OR_USER_ID",
"msg_type": "text",
"content": "系统通知:服务器资源监控异常,请及时处理。"
}'
使用场景说明:
- 自动化办公通知:集成 OA 系统,当流程审批到达、会议预约成功时,机器人自动在企微群内提醒。
- 技术监控告警:连接 Prometheus 或 Grafana,当服务指标触发阈值时,实时推送告警详情。
- 社群内容分发:在外部客户群中定时推送行业资讯或产品更新说明,维持社群活跃度。
FAQ:
-
Q:API 支持哪些消息类型?
- A:支持文本 (text)、图片 (image)、文件 (file)、图文链接 (news) 以及 Markdown 格式。
-
Q:如何获取接收者的 ID (receiver)?
- A:可以通过“获取联系人列表”或“获取群聊列表”接口预先检索,也可通过回调事件动态获取。
-
Q:接口调用是否有字符长度限制?
- A:文本消息通常限制在 2048 个字节以内,Markdown 消息建议控制在 4096 个字节以内。
引导入口: