@jiexiaoyin/wecom-api 0.0.2

package/src/modules/intelligence/index.js

@@ -0,0 +1,346 @@
+/**
+ * 数据与智能专区模块
+ * API 章节：十二
+ */
+
+const WeComSDK = require('../../sdk');
+
+class Intelligence extends WeComSDK {
+  constructor(config) {
+    super(config);
+  }
+
+  // ========== 基础接口 ==========
+
+  /**
+   * 设置公钥
+   * @param {string} publicKey 公钥
+   */
+  async setPublicKey(publicKey) {
+    return this.post('/managle/setpublickey', { public_key: publicKey });
+  }
+
+  /**
+   * 获取授权存档的成员列表
+   */
+  async getAllowedMembers() {
+    return this.post('/managle/get_allow_list', {});
+  }
+
+  /**
+   * 设置专区接收回调事件
+   * @param {string} callbackUrl 回调 URL
+   */
+  async setCallbackUrl(callbackUrl) {
+    return this.post('/managle/set_callback', { callback_url: callbackUrl });
+  }
+
+  /**
+   * 会话组件敏感信息隐藏设置
+   * @param {number} secretEnable 是否开启: 0-关闭 1-开启
+   */
+  async setSecret(secretEnable) {
+    return this.post('/managle/set_secret', { secret: secretEnable });
+  }
+
+  /**
+   * 设置日志打印级别
+   * @param {number} logLevel 日志级别: 1-调试 2-提示 3-警告 4-错误
+   */
+  async setLogLevel(logLevel) {
+    return this.post('/managle/set_log_level', { log_level: logLevel });
+  }
+
+  /**
+   * 上传临时文件到专区
+   * @param {string} filePath 文件路径
+   */
+  async uploadTempFile(filePath) {
+    return this.uploadFile(filePath, 'media');
+  }
+
+  // ========== 会话记录获取 ==========
+
+  /**
+   * 获取会话记录
+   * @param {string} seqId 消息序列号
+   * @param {number} limit 返回数量
+   */
+  async getChatRecords(seqId, limit = 100) {
+    return this.post('/managle/chatdata/get', {
+      seq_id: seqId,
+      limit
+    });
+  }
+
+  /**
+   * 获取会话同意情况
+   */
+  async getConsentList() {
+    return this.post('/managle/chatdata/get_consent_list', {});
+  }
+
+  /**
+   * 获取内部群信息
+   * @param {string} roomId 群聊 id
+   */
+  async getGroupInfo(roomId) {
+    return this.post('/managle/chatdata/get_room_info', { room_id: roomId });
+  }
+
+  /**
+   * 会话名称搜索
+   * @param {string} keyword 关键词
+   * @param {number} limit 返回数量
+   */
+  async searchByRoomName(keyword, limit = 10) {
+    return this.post('/managle/chatdata/search_by_room_name', {
+      keyword,
+      limit
+    });
+  }
+
+  /**
+   * 会话消息搜索
+   * @param {string} keyword 关键词
+   * @param {string} roomId 群聊 id (可选)
+   * @param {number} limit 返回数量
+   */
+  async searchMessages(keyword, roomId, limit = 10) {
+    return this.post('/managle/chatdata/search_by_msg', {
+      keyword,
+      room_id: roomId,
+      limit
+    });
+  }
+
+  /**
+   * 员工或客户名称搜索
+   * @param {string} keyword 关键词
+   * @param {number} limit 返回数量
+   */
+  async searchUser(keyword, limit = 10) {
+    return this.post('/managle/chatdata/search_by_user', {
+      keyword,
+      limit
+    });
+  }
+
+  // ========== 关键词规则管理 ==========
+
+  /**
+   * 获取关键词规则列表
+   */
+  async getKeywordRules() {
+    return this.post('/managle/keyword/get_rules', {});
+  }
+
+  /**
+   * 新增关键词规则
+   * @param {string} ruleName 规则名称
+   * @param {string[]} keywords 关键词列表
+   * @param {string} wordGroupId 词库组 id
+   */
+  async addKeywordRule(ruleName, keywords, wordGroupId) {
+    return this.post('/managle/keyword/add_rule', {
+      rule_name: ruleName,
+      keyword_list: keywords,
+      word_group_id: wordGroupId
+    });
+  }
+
+  /**
+   * 删除关键词规则
+   * @param {string} ruleId 规则 id
+   */
+  async deleteKeywordRule(ruleId) {
+    return this.post('/managle/keyword/del_rule', { rule_id: ruleId });
+  }
+
+  /**
+   * 获取命中关键词规则的会话记录
+   * @param {string} ruleId 规则 id
+   * @param {number} limit 返回数量
+   */
+  async getHitRecords(ruleId, limit = 100) {
+    return this.post('/managle/keyword/get_hit_records', {
+      rule_id: ruleId,
+      limit
+    });
+  }
+
+  // ========== 知识库管理 ==========
+
+  /**
+   * 获取企业知识集列表
+   */
+  async getKnowledgeList() {
+    return this.post('/managle/knowledge/list', {});
+  }
+
+  /**
+   * 创建知识集
+   * @param {string} name 知识集名称
+   * @param {string} description 描述
+   */
+  async createKnowledge(name, description) {
+    return this.post('/managle/knowledge/create', {
+      name,
+      description
+    });
+  }
+
+  /**
+   * 删除知识集
+   * @param {string} knowledgeId 知识集 id
+   */
+  async deleteKnowledge(knowledgeId) {
+    return this.post('/managle/knowledge/delete', { knowledge_id: knowledgeId });
+  }
+
+  /**
+   * 添加知识条目
+   * @param {string} knowledgeId 知识集 id
+   * @param {string} question 问题
+   * @param {string} answer 答案
+   */
+  async addKnowledgeItem(knowledgeId, question, answer) {
+    return this.post('/managle/knowledge/add_item', {
+      knowledge_id: knowledgeId,
+      question,
+      answer
+    });
+  }
+
+  // ========== 会话内容导出 ==========
+
+  /**
+   * 会话内容导出
+   * @param {string} roomId 群聊 id
+   * @param {number} startTime 开始时间戳
+   * @param {number} endTime 结束时间戳
+   * @param {string} exportType 导出类型: all-全部, text-文本, file-文件
+   */
+  async exportChat(roomId, startTime, endTime, exportType = 'all') {
+    return this.post('/managle/chatdata/export', {
+      room_id: roomId,
+      start_time: startTime,
+      end_time: endTime,
+      export_type: exportType
+    });
+  }
+
+  /**
+   * 获取导出结果
+   * @param {string} taskId 任务 id
+   */
+  async getExportResult(taskId) {
+    return this.post('/managle/chatdata/get_export_result', { task_id: taskId });
+  }
+
+  // ========== 情感分析 ==========
+
+  /**
+   * 情感分析
+   * @param {string} content 待分析内容
+   */
+  async sentimentAnalysis(content) {
+    return this.post('/managle/analysis/sentiment', { content });
+  }
+
+  // ========== 通用模型 ==========
+
+  /**
+   * 通用模型分析
+   * @param {string} prompt 提示词
+   * @param {string} query 查询内容
+   */
+  async generalModelAnalysis(prompt, query) {
+    return this.post('/managle/model/general', { prompt, query });
+  }
+
+  // ========== 客户标签模型 ==========
+
+  /**
+   * 客户标签推荐
+   * @param {string} userId 成员 ID
+   * @param {string} externalUserId 外部客户 ID
+   */
+  async getCustomerTags(userId, externalUserId) {
+    return this.post('/managle/model/customer_tag', {
+      userid: userId,
+      external_userid: externalUserId
+    });
+  }
+
+  // ========== 会话摘要模型 ==========
+
+  /**
+   * 会话摘要
+   * @param {string} roomId 群聊 ID
+   * @param {string} msgId 消息 ID
+   */
+  async getChatSummary(roomId, msgId) {
+    return this.post('/managle/model/summary', {
+      room_id: roomId,
+      msgid: msgId
+    });
+  }
+
+  // ========== 自有模型分析 ==========
+
+  /**
+   * 异步调用自有分析程序
+   * @param {string} programId 程序 ID
+   * @param {object} inputData 输入数据
+   */
+  async callSelfModel(programId, inputData) {
+    return this.post('/managle/model/self_analysis/async', {
+      program_id: programId,
+      input_data: inputData
+    });
+  }
+
+  /**
+   * 上报异步任务结果
+   * @param {string} programId 程序 ID
+   * @param {string} taskId 任务 ID
+   * @param {string} result 结果
+   * @param {string} errorMsg 错误信息
+   */
+  async reportTaskResult(programId, taskId, result, errorMsg = '') {
+    return this.post('/managle/model/self_analysis/report', {
+      program_id: programId,
+      task_id: taskId,
+      result,
+      error_msg: errorMsg
+    });
+  }
+
+  // ========== 会话反垃圾分析 ==========
+
+  /**
+   * 会话反垃圾分析
+   * @param {string} content 待分析内容
+   * @param {string} msgType 消息类型
+   */
+  async spamAnalysis(content, msgType = 'text') {
+    return this.post('/managle/analysis/spam', { content, msg_type: msgType });
+  }
+
+  // ========== 话术推荐 ==========
+
+  /**
+   * 获取话术推荐
+   * @param {string} content 客户消息
+   * @param {string} scene 场景
+   */
+  async getRecommendReply(content, scene = 'default') {
+    return this.post('/managle/recommend/get', {
+      content,
+      scene
+    });
+  }
+}
+
+module.exports = Intelligence;

package/src/modules/kf/index.js

@@ -0,0 +1,74 @@
+const WeComSDK = require("../../sdk");
+
+class KF extends WeComSDK {
+    /** 获取客服账号列表 */
+    async accountList() {
+        return this.get("/kf/account/list", {});
+    }
+
+    /** 获取在线客服账号列表 */
+    async onlineList() {
+        return this.get("/kf/account/getonline_list", {});
+    }
+
+    /** 获取客服账号详情 */
+    async accountGet(openKfid) {
+        return this.post("/kf/account/get", { open_kfid: openKfid });
+    }
+
+    /** 添加客服账号 */
+    async accountAdd(name, mediaId) {
+        return this.post("/kf/account/add", { name, media_id: mediaId });
+    }
+
+    /** 删除客服账号 */
+    async accountDel(openKfid) {
+        return this.post("/kf/account/del", { open_kfid: openKfid });
+    }
+
+    /** 修改客服账号 */
+    async accountUpdate(openKfid, name, mediaId) {
+        return this.post("/kf/account/update", { open_kfid: openKfid, name, media_id: mediaId });
+    }
+
+    /** 获取客服账号链接 */
+    async addContactWay(openKfid, scene, style, remark) {
+        return this.post("/kf/add_contact_way", {
+            open_kfid: openKfid,
+            scene: scene || 1,
+            style: style || 1,
+            remark: remark || ""
+        });
+    }
+
+    /** 获取会话状态 */
+    async getState(openKfid) {
+        return this.post("/kf/service_state/get", { open_kfid: openKfid });
+    }
+
+    /** 变更会话状态 */
+    async stateTrans(openKfid, serviceState, servicerUserid) {
+        return this.post("/kf/service_state/trans", {
+            open_kfid: openKfid,
+            service_state: serviceState,
+            servicer_userid: servicerUserid || ""
+        });
+    }
+
+    /** 同步消息 */
+    async syncMsg(token) {
+        return this.post("/kf/sync_msg", { token, limit: 100, voice_format: 0, openids: [] });
+    }
+
+    /** 发送消息 */
+    async sendMsg({ openKfid, touser, msgtype, text }) {
+        return this.post("/kf/send_msg", { open_kfid: openKfid, touser, msgtype, text });
+    }
+
+    /** 发送事件消息 */
+    async sendEvent(msg) {
+        return this.post("/kf/send_msg_on_event", msg);
+    }
+}
+
+module.exports = KF;

package/src/modules/live/index.js

@@ -0,0 +1,122 @@
+/**
+ * 直播管理模块
+ * API 章节：十九
+ */
+
+const WeComSDK = require('../../sdk');
+
+class Live extends WeComSDK {
+  constructor(config) {
+    super(config);
+  }
+
+  /**
+   * 创建预约直播
+   * @param {object} params 直播参数
+   */
+  async createLive(params) {
+    const {
+      title,           // 直播标题
+      startTime,       // 开始时间戳
+      endTime,         // 结束时间戳
+      description,    // 直播简介
+      coverMediaId,   // 封面 media_id
+      type,           // 直播类型: 0-通用直播
+      remindTime,      // 提醒时间 (秒)
+      agenda,         // 直播日程
+      groupId,        // 群直播ID
+      broadcasterName, // 主播名称
+      broadcasterUserId // 主播 userid
+    } = params;
+
+    return this.post('/live/create', {
+      title,
+      start_time: startTime,
+      end_time: endTime,
+      description,
+      cover_media_id: coverMediaId,
+      type,
+      remind_time: remindTime,
+      agenda,
+      groupid: groupId,
+      broadcaster_name: broadcasterName,
+      broadcaster_userid: broadcasterUserId
+    });
+  }
+
+  /**
+   * 修改预约直播
+   * @param {string} livingId 直播ID
+   * @param {object} params 更新参数
+   */
+  async updateLive(livingId, params) {
+    return this.post('/live/modify', {
+      living_id: livingId,
+      ...params
+    });
+  }
+
+  /**
+   * 取消预约直播
+   * @param {string} livingId 直播ID
+   */
+  async cancelLive(livingId) {
+    return this.post('/live/delete', { living_id: livingId });
+  }
+
+  /**
+   * 获取成员直播 ID 列表
+   * @param {string} userId 成员 userid
+   * @param {number} limit 返回数量
+   */
+  async getUserLiveIds(userId, limit = 100) {
+    return this.post('/live/get_user_living_id_list', {
+      userid: userId,
+      limit
+    });
+  }
+
+  /**
+   * 获取直播详情
+   * @param {string} livingId 直播ID
+   */
+  async getLiveDetail(livingId) {
+    return this.post('/live/get_living_info', { living_id: livingId });
+  }
+
+  /**
+   * 获取直播观看明细
+   * @param {string} livingId 直播ID
+   * @param {number} offset 分页偏移
+   * @param {number} limit 每页数量
+   */
+  async getWatchers(livingId, offset = 0, limit = 100) {
+    return this.post('/live/get_watch_stat', {
+      living_id: livingId,
+      offset,
+      limit
+    });
+  }
+
+  /**
+   * 删除直播回放
+   * @param {string} livingId 直播ID
+   */
+  async deleteReplay(livingId) {
+    return this.post('/live/delete_replay', { living_id: livingId });
+  }
+
+  /**
+   * 获取跳转小程序商城的直播观众信息
+   * @param {string} livingId 直播ID
+   * @param {string} userId 成员 userid
+   */
+  async getMallInfo(livingId, userId) {
+    return this.post('/live/get_mall_info', {
+      living_id: livingId,
+      userid: userId
+    });
+  }
+}
+
+module.exports = Live;