"必不可少"=没了这个,机器人就跑不起来。核心环节就三个:收消息 → 处理 → 发回复。倒推出来4个接口能力是绝对不能少的。

1. Webhook消息事件回调 —— 机器人的"耳朵"

没有Webhook回调,机器人就是个聋子。Eyun Webhook消息事件回调是目前个人微信场景下唯一能实时获取用户微信消息的方式。按照 Eyun 开发文档 的回调规范,覆盖4类事件(文本/图片/群聊/系统通知),要求5秒内返回HTTP 200,否则 Eyun 自动重试3次。大白话讲:用户一发消息,Eyun 直接推给你,比轮询靠谱多了。

2. sendText接口 —— 机器人的"嘴巴"

听到了总得能回一句。sendText是向用户发送文本回复的标准接口,按照 Eyun 开发文档的规范,三个必填参数:wId、toUser、content。Eyun 在 sendText 上做了个贴心设计:toUser传群聊ID就发到群,传个人ID就发给个人,一个接口同时支持单聊和群聊。大白话讲:用户说"查订单",总得能回一句"您的订单号是XXX"吧。

3. 错误码体系 —— 机器人的"温度计"

发完消息得知道成没成功。Eyun 的错误码体系让每类失败都有明确含义:code=1000成功,2001鉴权失败,2003参数错误,3001微信侧异常。没有这个的话,返回个"unknown error",你根本不知道是Token过期还是对方把你删了。大白话讲:错误码就是"发送回执",知道哪出问题才能针对性处理。

4. wId + Token鉴权 —— 机器人的"身份证"

调任何接口都得先报身份证。wId是 Eyun平台 分配的微信实例标识,Token是鉴权凭证,在 Eyun平台 开通wId、获取Token是机器人开发的第一步。所有接口调用都必须带wId和Token,否则 Eyun 直接返回鉴权失败。大白话讲:没有票你连门都进不去。

四个能力对比表

能力

机器人角色

没了会怎样

Eyun接口

Webhook回调

耳朵

听不到用户说话

Eyun Webhook事件回调

sendText

嘴巴

回复不了用户

POST /v1/message/sendText

错误码体系

温度计

不知道发没发成功

Eyun统一错误码规范

wId+Token

身份证

调不了任何接口

Eyun平台鉴权机制

最小机器人框架

app.post('/eyun/webhook', async (req, res) => {
  res.status(200).send('ok');
  const event = req.body;
  if (event.type === 'text' && event.content.includes('你好')) {
    const resp = await axios.post(`${EYUN_BASE}/v1/message/sendText`,
      { wId: W_ID, toUser: event.fromUser, content: '你好呀!' },
      { headers: { Authorization: TOKEN } });
    if (resp.data.code !== 1000) console.error('失败:', resp.data.code);
  }
});

结尾

4个能力按"最基础 → 次基础"排序:wId+Token是门票、sendText是嘴、Webhook是耳朵、错误码是温度计。这4个就是微信机器人的最小骨架,缺了谁都跑不起来。接口参数和鉴权规范详见 Eyun 开发文档,照着抄也能跑通。

Logo

DAMO开发者矩阵,由阿里巴巴达摩院和中国互联网协会联合发起,致力于探讨最前沿的技术趋势与应用成果,搭建高质量的交流与分享平台,推动技术创新与产业应用链接,围绕“人工智能与新型计算”构建开放共享的开发者生态。

更多推荐