Eyun 文档

Appearance

发送文本 ​

向指定好友、文件传输助手或群聊发送文本消息。建议首次联调时将 wcId 设为 filehelper，方便在手机微信中直接验证。

接口地址： POST /sendText

前置条件 ​

  • 微信账号已登录，并已获得可用的 wId。
  • 发送目标是好友、文件传输助手或当前微信所在群聊。
  • 同一微信账号发送消息建议进入队列，避免并发直发。

请求参数 ​

参数名必选类型说明
wId是string登录实例标识
wcId是string接收方微信 ID、filehelper 或群 ID（如 24187765053@chatroom）
content是string文本消息内容

响应参数 ​

参数名类型说明
codestring1000 成功，1001 失败
messagestring反馈信息
data.typeint消息类型
data.msgIdlong消息 ID
data.newMsgIdlong新消息 ID
data.createTimelong发送时间戳（秒）
data.wcIdstring接收方 ID

请求示例 ​

json
{
  "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"
  }
}

错误响应 ​

json
{
  "code": "1001",
  "message": "失败",
  "data": null
}

使用建议 ​

  • 首次接入建议先发到 filehelper，确认 wId、签名和网络链路正常。
  • 文本消息适合通知、客服回复和简单指令；富媒体内容建议使用对应的图片、文件、链接接口。
  • 高频发送时建议按微信实例做队列和限速，避免同一实例并发直发。

验证与排查 ​

场景处理方式
首次联调发送到 filehelper，手机微信能看到消息即表示链路正常
返回成功但目标没收到检查 wId 是否为当前在线实例，目标 wcId 是否正确
返回失败参考 发送接口通用错误码
高频发送参考 API 使用规范 配置队列和限速