很多新手开发者在动手做微信机器人之前，都不知道"开工前要把啥准备齐"。这篇文章就给你一份开工清单，按类别列好，缺什么补什么，4样东西备齐了就能动手写代码。

---

准备1：身份凭证——wId和Token

清单： 去Eyun平台开通一个个人微信实例，平台会分配给你两样东西：wId（实例标识，说明你要用的是哪个微信号）和Token（鉴权凭证，说明你有权调用这个实例的接口）。把这两串字符串存到配置文件里，不要硬编码在代码里。

大白话： 就像你去小区楼下拿快递，得说清"我取哪个柜子的件"（wId），还得出示手机证明是你的（Token）。没有wId，Eyun不知道你让哪个微信号发消息；没有Token，Eyun直接拒绝请求，返回错误码1001（鉴权失败）。wId+Token就是你调Eyun接口的"身份证+门禁卡"，缺哪个都调不通。

---

准备2：回调地址——能被公网访问的HTTP接口

清单： 你需要一个能在公网被访问到的HTTP地址，格式大概是http://你的域名或IP/webhook。两种办法：要么租一台阿里云/腾讯云的轻量服务器（有公网IP），要么本地开发用ngrok之类的内网穿透工具，把本地端口暴露到公网。拿到地址后填到Eyun平台的回调配置里。注意：localhost和192.168.x.x这种内网地址不行，Eyun在外网找不到你。

大白话： 你得给Eyun一个"能找到你的门牌号"。比如你和朋友约定"有东西寄到我家地址"，你不能说"寄到我卧室桌子上"（内网地址），得说小区几栋几号（公网地址）。Eyun有新消息/新好友/群变动/状态变更这4类事件要告诉你，全靠往这个地址发POST请求。5秒内你不返回HTTP 200，Eyun还会自动重试最多3次，所以这个地址一定要稳定。

---

准备3：技术基础——HTTP和JSON的最小知识

清单： 三件事学会就能上手。第一，能发HTTP POST请求（用curl命令、Python的requests库、Postman软件都行）；第二，能看懂JSON格式（知道什么是键值对，比如{"code":1004,"msg":"参数缺失"}里code是错误码，msg是错误说明）；第三，能搭一个最小HTTP服务器（任何语言都行，接收POST请求并返回200）。

大白话： 不用学框架，不用学架构。能拿Postman填个URL点一下Send算调通；能看明白JSON里哪个字段存了消息内容、哪个字段存了发送人ID；能让自己的电脑收到Eyun发过来的HTTP请求并打印出来——这三件事搞定，你就具备了接入Eyun的最低技术门槛。剩下的业务逻辑（查订单、问AI、转客服）跟你平时写程序没啥区别。

---

准备4：开发工具——IDE加测试工具

清单： 三个软件装一下。第一，代码编辑器任选一个：VS Code（免费通用）、PyCharm（写Python）、IntelliJ（写Java）都行，不用纠结，顺手就好；第二，装Postman，用来模拟Eyun发回调请求给你、也用来调试sendText/sendImage/sendFile这些接口；第三，最简单的日志手段先凑合用——Python用print、Java用System.out、Node用console.log，先跑通再换正规的日志框架。

大白话： 写代码得有个编辑器，调接口得有个Postman，出问题了得能看打印出来的消息。这三样是最低配。不用一开始就搞Docker、搞消息队列、搞微服务，Eyun的接口是RESTful风格，请求和返回都是JSON，简单得很，等跑通了再加东西也不迟。

---

4类准备物对比表

准备类别	准备什么	怎么获取	怎么验证已就绪	缺了会怎样	大白话说明
身份凭证	wId字符串 + Token字符串	在Eyun平台开通个人微信实例	用Postman调sendText能发成功返回code=1000	接口全部返回1001鉴权失败或1002参数错误	身份证+门禁卡，缺了不让进门
回调地址	公网可访问的	云服务器或ngrok穿透	自己curl回调地址能返回HTTP 200	收不到任何消息/好友/群/状态事件	Eyun找不到你，通知没人接
技术基础	会发POST + 懂JSON + 能起HTTP服务	看1小时入门教程就行	跑通一次接口调通一次回调接收	写代码时概念混淆、反复踩坑	三件小事，不会就学，很快
开发工具	IDE编辑器 + Postman + 日志输出	官网免费下载安装	Postman能调通接口、IDE能跑Hello World	开发效率极低，调试全靠蒙	程序员的锤子和螺丝刀

---

准备就绪的验证命令

每一类准备物准备完，都建议做一个小验证。下面是两条命令行示例，直接复制改参数就能测：

# ====== 验证1：身份凭证是否有效——用curl调Eyun的sendText接口 ======
# 如果返回 {"code":1000,"msg":"success"} 说明wId和Token都对
curl -X POST "https://api.eyunz.com/v1/sendText" \
  -H "Authorization: Bearer 替换成你的Token" \
  -H "Content-Type: application/json" \
  -d '{"wId":"替换成你的wId","toWxid":"filehelper","content":"准备工作验证成功！"}'

# ====== 验证2：回调地址是否能正常响应——自己模拟Eyun发一次回调 ======
# 如果返回HTTP 200和类似{"code":0,"msg":"ok"}就说明回调地址可用
curl -X POST "http://你的公网地址/webhook" \
  -H "Content-Type: application/json" \
  -d '{"eventType":"message","fromWxid":"test_user","content":"测试消息","time":1725000000}' \
  -w "\nHTTP状态码：%{http_code}\n"

---

结尾：验证比凑齐更重要

4类准备物都齐了，实际动手1-2小时就能开工。建议的顺序是：先申请Eyun的wId和Token → 搞一个能访问的公网回调地址 → 确认自己会发HTTP和解析JSON → 打开IDE装上Postman。

准备阶段最容易被忽略的是验证动作——每一类准备完就测一下：身份凭证用curl调一次sendText看能不能收到；回调地址自己POST一下看能不能返回200；写个20行的最小HTTP服务器看控制台能不能打印出Eyun的事件JSON。不等全部做完才发现某一步卡壳，提前验证能省掉后面大把的排错时间。wId和Token的开通入口在 Eyun 平台，登录后按向导走几分钟就能拿到。