企业微信机器人 Demo：从复制到跑通只需 10 分钟

还在为官方繁琐的审批和复杂的 XML 加解密头疼吗？这个 Demo 演示了如何使用 QiweAPI 快速构建一个具备“消息监听”和“自动回复”功能的机器人。无需自建应用，扫码即用。

1. 能力介绍：不仅仅是 Demo

本 Demo 展示了 QiweAPI 的核心 iPad 协议能力：

• 免审批接入：无需企业主体认证即可开发测试。
• 全消息类型：支持文本、图片、文件、视频的回调与发送。
• 真实身份互动：机器人以真实企微员工身份运行，可发朋友圈、加外部好友。
• 秒级响应：基于高性能长连接，消息延迟低于 1 秒。

---

2. 10 分钟接入 Demo（极简步骤）

1. 领取 Token：点击官网注册，在后台获取你的 Access-Token。
2. 准备内网穿透（可选） ：如果是本地开发，建议使用 cpolar 或 ngrok 映射一个公网 URL。
3. 配置回调：在 QiweAPI 后台设置 Callback URL 为你的服务器地址。
4. 扫码：调用登录接口弹出二维码，用企微扫码。
5. 收发消息：给自己发个消息，看看服务器是否打印了 JSON。

---

3. API 示例代码 (Node.js/JavaScript)

我们选择最易读的 Node.js 演示如何处理回调并回发消息：

JavaScript

const express = require('express');
const axios = require('axios');
const app = express();
app.use(express.json());

const TOKEN = "你的_ACCESS_TOKEN";

// 接收回调消息
app.post('/my_webhook', async (req, res) => {
    const { from_user, content, type } = req.body;

    // 如果收到的是文本消息且内容是 "ping"
    if (type === 1 && content === 'ping') {
        console.log(`收到来自 ${from_user} 的消息`);
        
        // 调用发消息接口自动回复
        await axios.post('http://api.qiweapi.com/send_text', {
            token: TOKEN,
            to_user: from_user,
            content: "pong! 机器人在线 🤖"
        });
    }
    res.send({ status: "ok" });
});

app.listen(3000, () => console.log('Demo Server 运行在 3000 端口'));

---

4. 使用场景说明

• 快速原型开发：1 天内交付私域自动化方案 Demo。
• 自动拉群助手：识别暗号，自动向客户推送入群邀请链接。
• 关键词告警：当客户在群内提到“投诉”、“退款”时，机器人立即通知相关负责人。

---

5. FAQ：开发者最关心的问题

• Q：为什么我的 Demo 收不到消息？

  • A：请检查后台回调地址是否填写正确，且确保你的服务器防火墙已开放对应端口。

• Q：可以发送图片和文件吗？

  • A：可以。只需调用 send_image 或 send_file 接口，传入文件 URL 或 Base64 即可。

• Q：Demo 跑通后怎么部署到正式环境？

  • A：只需将代码中的 API 地址和 Token 换成正式版环境，QiweAPI 支持弹性扩容，无缝切换。

---

6. 查看文档 & 官网

• 获取更多 Demo 代码 (Java/Go/PHP) ：doc.qiweapi.com/
• 立即注册开始测试：www.qiweapi.com/

---