Eyun 文档

Appearance

5 分钟发送第一条微信消息 ​

本页带你完成一次真实调用：注册账号、登录微信实例、发送一条测试消息，再配置 Webhook 接收消息。

跑通后，你会知道三件事：

  • Eyun 的 API 凭证是否可用。
  • 当前微信实例是否能被 API 驱动。
  • 你的系统后续如何接收微信消息并自动回复。

TIP

这不是完整上线方案，只用于验证最小闭环。正式上线前，请继续阅读 API 使用规范。

进入控制台联系开通

适合先这样测试 ​

你是谁这一步能帮你确认什么
开发者凭证、登录、发送接口和 Webhook 回调是否跑通
产品经理Eyun 是否能支撑 AI 客服、CRM、通知、群运营等业务闭环
运营人员微信消息、客户触达和群消息是否能进入你的业务系统

接入流程 ​

步骤目标预计耗时产出
1注册账号并获取凭证30 秒域名地址、Authorization
2登录一个微信实例1 分钟登录结果和微信 ID
3发送第一条消息2 分钟手机微信收到测试消息
4配置消息回调2 分钟你的服务开始接收微信消息

Step 1：获取开发者凭证 ​

  1. 打开 Eyun 控制台 并注册账号。
  2. 进入「我的 API → 开通信息」。
  3. 复制域名地址和 Authorization。
text
域名地址      = https://api.e-yun.example
Authorization = eyJ0eXAiOiJKV1...

TIP

Authorization 生成后长期有效。后续所有接口调用都需要在请求头中携带它。

Step 2：登录微信实例 ​

新用户先在控制台完成登录，最快能看到结果：

  1. 进入「微信管理」。
  2. 点击「扫码登录」。
  3. 使用手机微信扫码并确认。
  4. 登录成功后保存以下两个值：
字段含义使用场景
wId登录实例标识调用发送、好友、群聊等接口时使用
wcId微信 ID掉线重登时必须传入，用于保持同一个微信实例

WARNING

首次登录后 24 小时内可能掉线一次。掉线后重新登录时必须传入原 wcId，否则可能创建新设备并导致频繁掉线。

需要把登录流程接入自己的系统时，再按顺序调用 API：

  1. 登录平台（Step 1）
  2. 获取登录二维码（Step 2）
  3. 执行微信登录（Step 3）

获取二维码时默认可以直接扫码登录。只有需要固定登录地区、本地网络或自有代理时，才按需选择平台线路、Aid 或自定义代理。

Step 3：发送测试消息 ​

第一次测试建议发给微信内置的「文件传输助手」。它的接收方 ID 固定是 filehelper，不会打扰客户，也能最快确认调用链路。

bash
curl -X POST https://api.e-yun.example/sendText \
  -H "Content-Type: application/json" \
  -H "Authorization: eyJ0eXAiOiJKV1..." \
  -d '{
    "wId": "0000016e-63eb-f319-0001-ed01076abf1f",
    "wcId": "filehelper",
    "content": "Hello from Eyun"
  }'

成功响应示例：

json
{
  "code": "1000",
  "message": "处理成功",
  "data": {
    "type": 1,
    "msgId": 2562652205,
    "newMsgId": 4482117376572170921,
    "createTime": 1641457769,
    "wcId": "filehelper"
  }
}

验证结果 ​

接口返回 code = "1000" 后，打开手机微信的文件传输助手。

结果说明下一步
能看到测试消息API 已经成功驱动当前微信实例继续配置 Webhook
接口成功但手机未显示检查 wId、账号在线状态和目标 wcId参考 API 使用规范
接口返回失败根据 message 和发送错误码排查参考 发送接口错误码

Step 4：接收微信消息 ​

接入成功后，继续配置 Webhook：

  1. 调用 设置回调地址。
  2. 微信消息会以 HTTP POST 推送到你的服务。
  3. 按 回调消息释义 解析 messageType 和 data。

如果还没有公网服务器，可先按 Webhook 本地联调 查看回调内容，或用临时公网地址调试本地接口。

WARNING

通过 API 主动发送的消息不会产生回调。只有对方或群成员发送到当前微信实例的消息才会回调。

常见下一步 ​

场景推荐阅读
AI 自动回复设置回调地址 + 发送文本
群聊运营群聊管理
客户管理好友操作
朋友圈运营朋友圈
上线前检查API 使用规范

什么时候算测试成功 ​

验证点成功标准
API 凭证请求没有鉴权错误，控制台域名和 Authorization 能正常使用
微信实例登录成功后拿到 wId 和 wcId，在线状态可查询
消息发送文件传输助手能看到测试消息
消息接收Webhook 能收到对方或群成员发来的消息

完成这 4 个验证点后，再接入正式业务接口会更稳。

需要购买套餐？ ​

完成接口验证后，再根据实例数量、发送频率和部署方式选择套餐。详细价格请查看 资费说明 或进入 控制台。