package com.ruoyi.jarvis.service;

import java.util.List;

/**
 * 「开/慢开」TG 查询完成后，经 wxSend 主动推送文本（已按企微单条上限切分）。
 * 实现类在 ruoyi-admin，委托 WxSendWeComPushClient。
 */
public interface IPhoneForwardActivePush {

    /**
     * 在被动回复已发出后，按序推送到企微成员（首条前短暂延迟，避免次序错乱）。
     *
     * @param toUser  企微 message/send 的 touser（可与 XML FromUserName 相同，或由超级管理员 touser 解析为 {@code |} 分隔多成员）
     * @param wecomCallbackAgentId 回调明文 XML 中的 AgentId（字符串）；空则 wxSend 使用默认 {@code qywx.app.agentId}
     * @param chunks  每段不超过 UTF-8 2048 字节的正文
     * @return {@code true} 表示配置齐全且每一段非空正文均收到 wxSend 2xx 响应
     */
    boolean schedulePushChunks(String toUser, String wecomCallbackAgentId, List<String> chunks);
}
