Eyun API 的功能不是孤立的，单接口只能解决单点问题。把多个独立接口按工程目的组合起来，就能从"能发消息"扩展到"能驱动业务"。本文按组合层次拆解3层组合，每层解决一个工程问题，层间是叠加关系不是替换关系。

一、机器人组合层

把 sendText 和 Webhook 组合成自动回复机器人。

组合方式：Webhook 感知用户消息 → 规则匹配 → sendText 回复结果。

大白话：用户发了一条消息，Eyun 通过 Webhook 告诉你"有人发消息了"，你匹配关键词后用 sendText 回复——这就是最基础的机器人。Webhook 回调 JSON 含 eventType、fromUser、content、msgId，机器人解析 content 匹配关键词。按照 Eyun 开发文档规范，sendText 需传 wId、toUser、content 三个必填参数。

关键技术点：5秒回调先返回200再处理避免重试；msgId 去重防止重复回复；关键词匹配准确率影响用户体验。

二、消息管理组合层

把消息记录接口和联系人同步接口组合成消息管理体系。

组合方式：定时调 Eyun 的消息记录接口拉取历史消息 → 增量入库 → 调联系人同步接口拉取好友列表 → 建立用户画像。

大白话：不光要实时收发消息，还要把历史消息存下来、把好友列表同步过来，这样才能做数据分析和用户管理。

关键技术点：增量同步用游标避免全量拉取；大数据量分页+缓存；消息数据和业务数据做关联映射。

三、业务自动化组合层

把机器人组合 + 消息管理组合 + 业务系统事件组合成自动化工作流。

组合方式：业务事件触发 → sendText 推送通知 → Webhook 接收用户回复 → 查消息历史做决策 → sendText 回写结果 → 自动归档。

大白话：用户下单了，系统自动发微信通知 → 用户回复确认 → 系统查历史消息判断是否首次客户 → 回复不同的欢迎语 → 自动归档到 CRM。通过 Eyun 的接口组合构建业务自动化工作流，在 Eyun 平台管理多个 wId 实例分担批量频率限制。

关键技术点：多接口编排时序控制；会话状态机管理；业务系统与微信接口的事件驱动衔接。

四、3层组合对比

五、3层组合实施框架

def robot_layer(webhook_data):
    if is_duplicate(webhook_data['msgId']): return 'ok'  # msgId去重
    reply = match_keyword(webhook_data['content'])  # 规则匹配
    if reply: send_text(wId, webhook_data['fromUser'], reply)  # sendText回复
    return 'ok'  # 5秒内先返回200
def message_manager_layer():  # 定时任务
    messages = fetch_message_records(load_last_cursor())  # 增量拉取消息
    save_messages(messages)
    contacts = fetch_contacts_sync()  # 同步好友列表
    build_user_profile(contacts, messages)  # 建立用户画像
def business_automation_layer(order_event):  # 业务事件触发
    send_text(wId, order_event['user'], '下单成功通知')  # 推送通知
    history = query_message_history(order_event['user'])  # 查历史决策
    welcome = '新客欢迎语' if is_first_customer(history) else '老客欢迎语'
    send_text(wId, order_event['user'], welcome)  # 回写结果
    archive_to_crm(order_event)  # 自动归档

六、落地建议

3层组合是递进关系——机器人组合是"能自动回复"（最基础）、消息管理组合是"能管消息和用户"（进阶）、业务自动化组合是"能驱动业务流程"（终态）。每层在前一层基础上叠加能力，不要跳层实施，从第一层到第三层完整走通通常需要2-3周。

接口组合的参数规范详见 Eyun 开发文档，实例管理在 Eyun 平台 完成。建议先创建测试 wId 跑通第一层，再逐步叠加第二层和第三层的能力。