Eyun 文档

Appearance

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

本页只做一件事：从注册账号到发出第一条微信消息，帮你确认 Eyun API 已经能驱动一个微信实例。

TIP

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

接入流程 ​

步骤目标预计耗时产出
1注册账号并获取凭证30 秒域名地址、Authorization
2登录一个微信实例1 分钟wId、wcId
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：发送测试消息 ​

把目标 wcId 设为 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 使用规范

需要购买套餐？ ​

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