Skip to content

从注册到首条消息

新账号不需要先创建应用。兑换试用后,控制台会自动生成「默认应用」和 API 凭证。先在控制台跑通真实消息,再把同一套参数接入后端。

最短路径

阶段在哪里操作完成标志
1. 兑换试用控制台概览出现 7 天试用和「默认应用」
2. 登录微信微信执行实例实例状态显示在线,并获得 wId
3. 测试发送API Playgroundfilehelper 收到测试文本
4. 接入后端你的服务端使用 API 凭证和真实 wId 调用成功

为什么先用 Playground

它能先证明账号、网络、微信实例和 Auth 都可用。若这里成功而业务代码失败,排查范围就只剩请求地址、请求头和参数。

1. 兑换试用

登录 Eyun 控制台,在概览页选择「立即激活试用」,按页面要求填写试用信息。

激活成功后,系统会自动创建:

  • 一份 7 天试用权益。
  • 一个名为「默认应用」的应用凭证。
  • 一个以 eyk_ 开头的 API 凭证。

2. 登录微信

进入「微信执行实例」,选择新增实例并扫码登录。登录网络必须在以下三种方式中选择一种:

网络方式适合场景
平台代理已有适合账号常用地区的平台线路
自定义代理团队已有稳定、可控的代理出口
Aid 本地代理使用办公室、门店、家宽或同城设备作为出口

不知道怎么选时,先阅读 Aid 本地代理

3. 在 Playground 发送消息

微信实例显示在线后,打开 API Playground

  1. 选择「默认应用」。
  2. 选择刚登录的微信实例。
  3. 选择发送文本接口。
  4. 将目标 wcId 填为 filehelper
  5. 发送一条测试文本。

手机微信的「文件传输助手」收到消息,即表示首次链路已跑通。

4. 接入后端

在「应用凭证」打开「默认应用」,复制 API 凭证。生产代码只在服务端保存该凭证,不要放入浏览器、App 包或公开仓库。

bash
curl -X POST https://你的接口域名/sendText \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer eyk_your_auth" \
  -d '{
    "wId": "你的登录实例ID",
    "wcId": "filehelper",
    "content": "Hello from Eyun"
  }'

下一步:查看 API 参考配置 Webhook