背景

我們?nèi)粘Ｃ刻於夹枰獙懭請?用來匯報今日工作內(nèi)容和明日工作計劃。日報內(nèi)容維護在wiki里面。團隊TL每天會去wiki上收集工作內(nèi)容；在發(fā)送到公司大群。但是每天會有小伙伴會忘記寫。 導致 TL沒辦法收集今日內(nèi)容。很是苦惱。還有每次編寫都需要去wiki挨個復制每個人的。 工作效率很低；

思考

之前也了解過wechaty，就想著是否可以做一個每天快下班提醒團隊小伙伴，維護下工作日報。以及團隊TL便捷獲取團隊所有日報的系統(tǒng)。不需要一個個復制；

項目地址

github:https://github.com/zzhoouxin/wechaty-bot

基礎依賴

• wechaty --微信操作
• node-schedule --定時任務
• superagent --接口請求
• cheerio -- 抓取數(shù)據(jù)
• qrcode-terminal --終端顯示二維碼

功能

• 定時提醒組內(nèi)小伙伴填寫工作日報以及發(fā)送工作日報到工作群
• 根據(jù)關鍵字自動發(fā)送日報內(nèi)容
• 后續(xù)功能...(等待和小組人員討論)

項目成果

• 日常提醒

  
  
  日常提醒

• 定時發(fā)送日報

  
  
  定時發(fā)送日報

• 根據(jù)關鍵字發(fā)送日報內(nèi)容

  
  
  image.png

實現(xiàn)過程

1.項目結(jié)構(gòu)

image.png

• bot 存放wechaty每個狀態(tài)的回調(diào)函數(shù)
• schecdule 定時任務-獲取日報并發(fā)送
• config 基本配置-鏈接、群號等
• tool 封裝基礎請求、公共方法
• index.js 啟動入口

2.核心代碼

1.index.js -- wechaty啟動入口

const {Wechaty} = require('wechaty')
const {PuppetPadplus} = require("wechaty-puppet-padplus");
const config = require('./config')
const onScan = require('./bot/onScan')
const onLogin = require('./bot/onLogin')
const onMessage = require('./bot/onMessage')
const onLogout = require('./bot/onLogout')

const bot = new Wechaty({
    puppet: new PuppetPadplus({
        token: config.TOKEN
    }),
    name: "小艾"
});
bot
    .on('scan', onScan)
    .on('login', onLogin(bot))
    .on('logout', onLogout)
    .on('message', onMessage(bot))
    .start()
    .then(() => console.log('開始登陸微信'))
    .catch(e => console.error(e))

這邊使用的是wechaty-puppet-padplus基于ipad協(xié)議進行開發(fā)的；scan login logout message這些是Wechaty的基礎回調(diào)事件。

2.config 基礎文件配置這里面都是自己基于自己業(yè)務的參數(shù)-如果您也是用confluence wiki 那可以參考下

// 配置文件
module.exports = {
  // 每個人對應頁面的ID
  ALL_USER_LIST: [
    { id: 27169291, name: '小人頭'},
  ],
  WITHDRAWA_DATE: '00 50 17 * * *', //定時任務事件
  COLLOECT_DATE:'10 30 09 * * *', // 定時任務事件
  WIKI_URL: 'http://wiki.xxxxx.com/pages/viewpage.action?pageId=', //wiki內(nèi)容地址
  TOKEN: 'puppet_padplus_xxxxx',//token
  ROOM: '22186778457@chatroom',//需要發(fā)送的群號
  KEYWORDs:['本組','全部']
};

image.png

里面的wiki_url 是我們自己平常填寫日報的wiki地址。如果您使用其他方式-那就具體情況具體分析

3.定時任務提醒

• 在登錄后啟動定時任務
  這邊我們就使用到了- node-schedule 這個node庫 當然可以配置他的啟動時間。可以查看官網(wǎng)詳細說明。

3.1首頁我們在wechaty的onlogin事件里面加入定時任務

const dailyRemind = require('../schedule/dailyRemind')
const collectContent = require('../schedule/collectContent')
/**
 * 掃碼登錄
 * @param qrcode
 * @param status
 */
module.exports = bot => {
    return async function onLogin() {
        await dailyRemind(bot);//日常提醒
        await collectContent(bot);//所有匯總
    }
}

3.2創(chuàng)建一個定時提醒的任務

• 通過bot.Room.find(id)找到需要提醒的群
• 在使用announce創(chuàng)建群公告 @所有人 即可做到提醒

const schedule = require('./index');
const config = require('../config');
const utils = require('../tool/utils')
module.exports =async  function dailyRemind(bot) {
    schedule.setSchedule(config.WITHDRAWA_DATE, async () => {
        if(!utils.judgeIsJob()){ //周末的話，不做提醒
           return false;
        }
       try {
           //提醒組內(nèi)人發(fā)送日報
           const searchRoom = await bot.Room.find({ id: config.ROOM});
           await searchRoom.announce("快下班了~大佬們可以更新一下日報啦~/:@)")
       } catch (e) {
           console.log("error:",e.message);
       }
   });
}

4.根據(jù)關鍵字。發(fā)送日報內(nèi)容

• 上圖中 機器人會自動提示，需要回復什么關鍵字。當然這一步是我們自己配置的。在config.js里面有關鍵字配置屬性。直接看代碼
• 機器人自動回復-就需要在message事件里面處理啦-message的官方文檔

// 監(jiān)聽對話
const { Message } = require('wechaty');
const config = require('../config');
module.exports = (bot) => {
  return async function onMessage(msg) {
    const contact = msg.from(); // 發(fā)消息人
    const content = msg.text(); //消息內(nèi)容
    const room = msg.room(); //是否是群消息
    if (msg.self()) {
      return;
    }
    //如果是文本消息
    if (msg.type() == Message.Type.Text) {
      // await textJ(bot);
      if (room) {
        console.log('room===>', room);
        // 如果是群消息
        const topic = await room.topic();
        console.log(
          `群名: ${topic} 發(fā)消息人: ${contact.name()} 內(nèi)容: ${content}`
        );
      } else {
        let info = `日報查詢僅支持2種，回復【】內(nèi)文字即可查詢~\n`;
        config.KEYWORDs.map((v) => {
          info += '【' + v + '】' + '\n';
        });
        msg.say(info);
      }
    }
  };
};

5.獲取自己需要的信息

• 上文中提交到我們有日報填寫的地址
• 以及 superagent 、cheerio 2個依賴庫-主要用到請求我們?nèi)請蟮刂?并且獲取所需要的內(nèi)容
  
  wiki基礎頁面結(jié)構(gòu)

這個是我們wiki文檔的項目結(jié)構(gòu)-我們首先需求通過superagent請求訪問該頁面-并且通過cheero獲取內(nèi)容。當然這2個依賴庫使用。建議先熟悉一下官方文檔。下文代碼做了一些兼容--

async function collectUserContent() {
  let str = '';
  for (let user of config.ALL_USER_LIST) {
    const url = `${config.WIKI_URL}${user.id}`;
    const res = await fetch(url);
    let $ = cheerio.load(res.text);
    // const data = $('.wiki-content .p1').text();
    str += `\n ${user.name} \n`;
    $('.wiki-content p').each(function (i, e) {
      let text = $(e).text();
      if (text !== '\xa0') {
        str += ` ${text} \n`;
      }
    });
    $('.wiki-content .p1pkss0x').each(function (i, e) {
      let html = $(e).children();
      if (html.length === 0) {
        let text = $(e).text();
        if (text !== '\xa0') {
          str += ` ${text} \n`;
        }
      }
    });
 
   $('.wiki-content .pd7nslm').each(function (i, e) {
      let html = $(e).children();
      if (html.length === 1) {
        let text = $(e).text();
        if (text !== '\xa0') {
          str += ` ${text} \n`;
        }
      }
    });
  }
  return str;
}

獲取到自己需要的內(nèi)容，依舊可以通過room.say發(fā)送出去;
至此我們一個簡單的日報收集的系統(tǒng)機器人簡單的實現(xiàn)了。

總結(jié)

相信很多公司都有發(fā)送日報的要求。以上代碼實現(xiàn)也是依賴了自己所需業(yè)務場景進行實現(xiàn)。通過wechaty改變了我們傳統(tǒng)的工作流程。大大的提高了工作效率。避免很多重復行為。當然還有更多好玩有趣的功能區(qū)可以加入。希望自己可以和團隊進行溝通，提高我們流程。大家可以參考以上流程。