package com.ruoyi.system.service;

/**
 * 企业微信服务接口
 * 
 * @author ruoyi
 * @date 2025-12-11
 */
public interface IQyWechatService {

    /**
     * 发送企业微信消息
     * 
     * @param userId 用户ID
     * @param title 消息标题
     * @param content 消息内容
     * @return 是否发送成功
     */
    boolean sendNotifyMessage(Long userId, String title, String content, String notifyUrl);

    /**
     * 发送企业微信消息，带小程序路径链接
     * @param userId
     * @param title
     * @param content
     * @param appId
     * @param businessUrl 小程序访问路径
     * @return
     */
    boolean sendNotifyMessage(Long userId, String title, String content, String appId,String businessUrl);

    /**
     * 发送企业微信文本消息
     * 
     * @param qyUserId 企业微信用户ID
     * @param title 消息标题
     * @param content 消息内容
     * @param notifyUrl 通知链接
     * @return 是否发送成功
     */
    boolean sendTextMessage(String qyUserId, String title, String content, String notifyUrl);

    boolean sendTextMessage(String qyUserId, String title, String content, String appId,String businessUrl);

    /**
     * 获取用户的企业微信ID
     * 
     * @param userId 系统用户ID
     * @return 企业微信用户ID
     */
    String getQyUserIdByUserId(Long userId);

    /**
     * 检查企业微信服务是否启用
     * 
     * @return true=启用, false=未启用
     */
    boolean isEnabled();
}