联系商务
开通咨询 · 演示环境 · 方案报价
caiyun-biz商务微信（点击复制）
400-XXX-XXXX商务电话
① 扫码下载企业微信设备开通第一步 · 下载后登录企微账号
② 扫码下载机器人 APP设备开通第二步 · Android 安装包
工作日 9:00 - 18:00 · 1 个工作日内回复
彩云助手让每一个企业微信都成为 24 小时在线的 AI 客服和发单机器人： 咨询自动回复、链接自动转链、社群自动运营、客户自动跟进—— 一个人，管住几十个企微号。
从客户加上的第一秒，到成交后的每一次触达—— 彩云助手把私域运营里所有"必须有人盯着"的事，变成系统自动执行的事。 您定规则，它来执行：关键词回复、AI 客服、SOP 推进、转链发单、群发触达， 全部按真人节奏逐条进行，不漏一个客户，不错一次机会。
两个最核心的环节，交给系统自动完成。
把客户接待这件事做到极致；更多运营能力全部内置，开通即可使用。
所有企微号的客户会话聚合到一个操作台，像用微信一样集中聊天回复——自动接待在后台运行，需要人工时随时接管。
关键词规则 + AI 大模型双引擎，让每一个客户咨询都得到秒级回应——答得快、答得准、答得住。
几十个企微号的客户会话全部聚合到一个操作台，像用微信一样集中聊天回复——自动接待在后台运行，需要人工时随时接管。
收发覆盖企微全类型消息，自动回复与 API 对接均按类型处理。
按使用方式不同，开工前需要准备的东西如下：
所有自动化动作都不是"一口气全发"。系统内置节拍化执行机制： 每条消息独立延迟下发（不低于 3 秒）、随机化发送间隔、任务队列排队执行， 让机器人的行为节奏贴近真人操作，账号长期稳定可用。
所有企微号的会话聚合到一个操作台，像用微信一样集中聊天回复；自动接待在后台跑，需要人工时随时接管。
咨询高峰不再漏接：关键词秒回 + AI 兜底应答，新客户欢迎语自动送达，人工客服只处理真正需要人的问题。
批量建群、自动欢迎、定时群发、群公告触达——多个社群按节奏持续活跃，告别手工刷屏式运营。
客户自动打标签、按旅程自动推进 SOP、朋友圈定时种草，把一次性流量变成可反复触达的客户资产。
对于想把彩云助手接入自己业务系统的团队，我们提供完整的企业微信 SCRM SDK 网关： 申请到接入凭证后，基于在线完整文档即可直接开始开发，无需等待。
三种通信形态，均为 HTTPS + JSON：指令 API（贵方 → 我方）驱动机器人执行动作；事件推送（我方 → 贵方）实时回传业务数据。
| 凭证 | 说明 | 获取方式 |
|---|---|---|
| appId | 客户唯一身份标识（公开，用于鉴权 header） | 联系商务开通，管理端下发 |
| appSecret | 签名密钥（仅创建/重置时展示一次） | 同上，请立即保存 |
| callbackUrl | 事件推送回调地址（需公网可达） | 开通时登记，可修改 |
指令 API 与事件推送共用同一套 HMAC 签名，每个请求携带以下 3 个请求头：
| Header | 说明 |
|---|---|
| Authorization | Bearer {appId}，身份标识 |
| X-Icaiy-Timestamp | 毫秒级 Unix 时间戳，偏差超过 ±5 分钟拒绝（防重放） |
| X-Icaiy-Signature | HMAC-SHA256 请求签名（文档提供多语言计算示例） |
curl -X POST "{网关地址}/sdk/v2/robots/{wechatId}/messages" \ -H "Authorization: Bearer {appId}" \ -H "X-Icaiy-Timestamp: $(date +%s%3N)" \ -H "X-Icaiy-Signature: <按签名算法计算>" \ -H "Content-Type: application/json" \ -d '{"clientCmdId":"biz-001","friendId":"78813…","msgType":"text","text":"您好"}' # 响应：HTTP 恒为 200，业务判断以 body.code 为准 { "code": 200, "message": "操作成功", "data": { } }
统一挂载在 /sdk/v2 下（路径中的 {wechatId} 为机器人企微 ID），覆盖机器人、消息、好友、群、朋友圈、会话订阅、表情、标签、配置下发与运维诊断全部能力。
| 接口 | 路径 | 说明 |
|---|---|---|
| POST发送消息 | /robots/{id}/messages | 文本/图文/语音/视频/文件/小程序/引用全类型 |
| POST撤回消息 | /robots/{id}/messages/revoke | 撤回机器人发出的消息 |
| POST拉历史聊天 | /robots/{id}/messages/history | 拉取历史消息（history.batch 事件回传） |
| POST订阅好友消息 | /robots/{id}/subscribe | 订阅/取消指定好友消息上报 |
| POST标记会话已读 | /robots/{id}/conversations/read | 消除未读角标 |
| POST群操作 | /robots/{id}/group-actions | 建群、群管理等批量操作 |
| POST拉取群成员 | /robots/{id}/groups/{gid}/members | 单群成员明细刷新 |
| POST拉取群二维码 | /robots/{id}/groups/qrcode | 获取群二维码图片 URL |
| POST扫码进群 | /robots/{id}/groups/join-by-qr | 扫码批量进群 |
| POST审批入群邀请 | /robots/{id}/group-invites/approve | 审批入群邀请 |
| POST通过好友 | /robots/{id}/friends/accept | 通过好友申请 |
| POST修改好友备注 | /robots/{id}/friends/remark | 修改好友备注 |
| POST删除好友 | /robots/{id}/friends/delete | 删除好友 |
| POST好友打标签 | /robots/{id}/friends/labels | 设置好友标签 |
| POST主动加好友 | /robots/{id}/friends/add | 按手机号批量加好友 |
| POST手机号搜索 | /robots/{id}/friends/search | 只搜不添加，候选含个微/企微类型 |
| POST搜索加好友 | /robots/{id}/friends/search-add | 单手机号加好友，task.result 闭环 |
| POST刷新客户资料 | /robots/{id}/contacts/{cid}/refresh | 单客户完整资料刷新，回推 contact.updated |
| POST朋友圈发布 | /robots/{id}/circles | 发布朋友圈 |
| POST朋友圈删除/点赞/评论 | /robots/{id}/circles/* | 删除、点赞、评论、删评论、拉取 |
| POST修改机器人资料 | /robots/{id}/profile | 昵称/别名/头像/对外显示名 |
| POST拉自身二维码 | /robots/{id}/qrcode | 获取机器人本人二维码 |
| POST僵尸粉检测 | /robots/{id}/friends/detect | 检测删除/单向好友 |
| POST僵尸粉重加 | /robots/{id}/friends/readd | 单向好友重新添加 |
| POST语音转文字 | /robots/{id}/messages/voice-to-text | 语音消息转文本 |
| POST标签管理 | /robots/{id}/labels · DELETE /labels/{labelId} | 标签新建/删除 |
| POST触发数据同步 | /robots/{id}/sync | 会话/客户/群/标签按 scope 组合同步 |
| POST表情收藏 | /robots/{id}/emoji/* | 拉取/添加收藏表情 |
| POST发单配置下发 | /robots/{id}/sender-config | 下发发单/发送者配置 |
| POST开关配置下发 | /robots/{id}/device-config | 设备行为开关 + 消息过滤策略 |
| GET查询当前配置 | /robots/{id}/device-config | 设备当前生效配置快照 |
| GET机器人列表 | /robots | 名下机器人快照（含被踢设备） |
| GET查询在线状态 | /robots/{id}/status | 单机器人 TCP 在线态 |
| GET死信查看/重放 | /ops/dead-letters · /ops/dead-letters/replay | 投递失败事件自助查看与重放 |
| POST拉取 APP 日志 | /robots/{id}/logs/pull | 远程拉取设备日志排障（logs.pulled 回推） |
| GET调试事件轮询 | /debug/events | 无回调端点时的联调轮询通道 |
机器人产生数据/状态变化时，我方主动 POST 到贵方 callbackUrl。统一信封结构，payload 统一 camelCase、ID 一律字符串，一套解析函数覆盖全部类型。
{
"specVersion": 1,
"eventId": "evt_9f86a1c2-3d4e-4f5a", // 幂等去重键
"eventType": "message.received",
"occurredAt": 1760000000123,
"robot": { "wechatId": "1688857389" },
"payload": { }
}
# 贵方应答：验签 → 落库/入队 → 立即返回（10s 超时）
{ "code": 0, "message": "ok" }
| 事件类型 | 触发时机 |
|---|---|
| message.received | 机器人收到新消息（文本/媒体/表情等全类型） |
| message.receipt | 发出的消息送达回执 |
| message.revoked | 消息被撤回 |
| conversation.sync | 会话列表同步 |
| contact.sync / contact.add / contact.updated | 客户资料同步 / 新好友 / 资料变更 |
| group.sync / group.add / group.changed / group.del | 群同步 / 建群 / 群变更 / 解散 |
| group.members | 群成员列表同步 |
| tag.list / tag.add / tag.del | 标签同步 / 新建 / 删除 |
| history.batch | 历史消息分批回传 |
| circle.list / circle.published | 朋友圈拉取 / 发布结果 |
| robot.online / robot.offline | 机器人上下线 |
| task.result | 有结果语义任务的执行成败上报 |
| account.updated / device.low_battery | 账号资料变更 / 设备低电量预警 |
所有指令均为异步执行，"受理成功"≠"执行成功"。clientCmdId 是贯穿指令生命周期的关联键：指令受理时传入，回执事件 payload 回填，贵方以它做幂等去重与状态回填（重复提交同一 clientCmdId 将被拒绝，不会重复下发）。
指令 HTTP 同步响应。code=0 代表校验通过、限流放行并已下发设备。
设备执行完有结果语义的任务（改备注、打标签、标已读等）后，成败经 task.result 上报。
发消息 → message.receipt；撤回 → message.revoked；建群 → group.add。业务生效本身即最终回执。
指令 API 的 HTTP 状态码恒为 200，业务判断以 body 中的 code 为准：
| code | 含义 |
|---|---|
| 0 | 受理成功（指令已校验、限流通过并下发到设备） |
| 4001 | clientCmdId 重复提交（幂等拦截，不会重复下发） |
| 4003 | 时间戳偏差超过 ±5 分钟（防重放拒绝） |
| 其他 | 参数校验 / 签名错误 / 频控等，msg 返回人话原因；完整错误码见文档第 7 章 |
"我们 40 多个商品群全靠它发单，转链自动换自己的 PID，佣金一分不差。以前两个运营每天花 3 小时发单，现在完全无人值守，发单日志随时对账。"
"最直观的变化是回复速度：客户咨询基本秒回，AI 答不了的才转人工，客服只需要处理 20% 的问题。新好友加上自动发欢迎语和产品资料，转化率明显提升。"
"账号用了半年多一直很稳定。发单、群发都是按间隔一条条来，节奏跟真人一样，这在同类产品里很少见。后台几十个号的状态一目了然，管理成本低了很多。"
先用起来，再谈深度。
机器人 APP 运行在手机端企微环境上，支持多机器人集中管理。具体设备配比与容器化方案，开通时我们会根据您的号量给到建议配置，避免浪费。
发单采用"计划 + 日志"双机制：采集群→转链→转发群的每一步都有记录，发单日志完整可查（发送时间、目标群、发送结果）；计划支持暂停/启停，设备离线时任务排队不丢失，上线后自动续发最新计划。
可以。AI 回复与关键词回复双引擎配合：命中关键词的走您配置的精准话术（不会走 AI），未命中的才由 AI 兜底；您还可以配置消息过滤策略（接待范围、屏蔽对象、屏蔽关键词），精细控制机器人的应答边界。
系统内置类真人的节拍化执行机制：所有非人工消息强制延迟下发（不低于 3 秒）、随机化发送间隔、任务队列排队执行，避免机器式轰炸行为。同时支持消息过滤与接收范围控制，从行为层降低风控风险。诚实地说：任何自动化工具都无法承诺 100% 无风险，我们能做的是把行为特征做到最接近真人。
标准对接通常 1-2 个开发日：获取凭证、实现一个验签+落库的 HTTPS 回调端点、调用首批指令。本页开放平台文档已包含接入三步骤、签名算法、45 个指令端点、30+ 类事件、幂等回执模型与错误码——开通后即可按文档直接开发，联调阶段提供技术支持。
私有化部署：网关、中控与数据库全部落在您自己的服务器，客户、群、消息数据 100% 归属贵方，我方不留存业务数据。源码交付：在私有化基础上进一步开放三端源码，您可以自由修改、扩展与集成，适合有长期自研计划的团队。