Slack上でチームの雑談を促進するBotをつくる！(2/2)

Last updated at 2024-10-26Posted at 2024-10-26

概要

前回の続きです。

前回はSlack Botの作成まで終わったので、本記事ではSlackへのメッセージの送信機能を実装します。
完成イメージは以下の通りです。

実装

スプレッドシートの準備

メンバーと質問の管理をするためのシートをそれぞれ準備します。

1. 「送信先」シートの作成

質問を送るメンバーの名簿シートです。
シート名は「送信先」にし、メンバーを一意に特定するためのメンバーID、名前を記載します。
全員が平等に指名されるような実装をあとで行うので、出題回数の列も用意しておきます。

メンバーIDはプロフィールから確認できます。

2. 「質問」シートの作成

メンバーに投げかける質問を溜めておくシートです。
シート名は「質問」にし、質問を記載します。
こちらも先ほどと同様に、同じ質問が連続しないよう、出題回数の列を用意しておきます。

GASの準備

拡張機能から「Apps Script」をクリックし、メッセージの送信機能を実装します！

具体的には下記要件を満たすようなスクリプトを書きます。

質問シートにある、出題回数が最も少ない質問の中から、ランダムに1つ選ぶ
送信先シートにある、出題回数が最も少ない人の中から、ランダムに1人の回答者を選ぶ
回答者をSlack上でメンションして、質問を投げかける

1. 環境変数と定数の定義

GASの設定画面から、スクリプトプロパティを編集し、前回取得したBot User OAuth Tokenを入力します。

下記のように環境変数と定数を定義します。
（SlackのチャンネルIDの確認方法）

const SLACK_TOKEN = PropertiesService.getScriptProperties().getProperty('SLACK_TOKEN'); // SlackのBot User OAuth Token
const SLACK_CHANNEL = 'XXXXX'; // 質問を投稿するSlackチャンネルのID

const question_sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('質問'); // 質問シート
const answerer_sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('送信先'); // 送信先シート

2. ランダムに質問や回答者を選択する関数

質問シートや送信先シートにある、出題回数が最も少ない項目の中からランダムに選ぶ関数を作成します。

// 指定されたシートと列範囲から、最小値を持つ行番号を取得する
function getRowsWithMinCount(sheet, columnRange) {
  let columnData = sheet.getRange(columnRange).getValues();
  let filteredData = columnData.filter(row => row[0] !== '');
  const min = Math.min.apply(null, filteredData);

  return filteredData.reduce((rows, row, index) => {
    if (row[0] == min) rows.push(index + 2);
    return rows;
  }, []);
}

// ランダムな行番号を取得する
function getRandomRow(rows) {
  const randomIndex = Math.floor(Math.random() * rows.length);
  return rows[randomIndex];
}

getRowsWithMinCount()は、シートと列範囲を引数に取り、指定された列内で最小値を持つ行番号の配列を返します。
例えば、下記のような状態では、getRowsWithMinCount(questionSheet, 'B2:B')の返り値は[3, 5]になります。

getRandomRow()は、getRowsWithMinCount()で取得した行番号の配列の中から、ランダムに行番号を取得します。先ほどの例では、[3, 5]のうち、ランダムに3または5を返します。

3. 休日かどうかを判定する関数

土日はメッセージを投稿しないようにするため、土日かどうかを判定する関数を作成します。

// 休日判定
function isWeekend() {
  const today = new Date();
  const dayOfWeek = today.getDay();
  return dayOfWeek === 0 || dayOfWeek === 6;
}

4. 出題回数を更新する関数

選ばれた回答者および質問の「出題回数」列の値を更新する（+1する）関数を作成します。

// 出題回数を更新する
function updateCount(sheet, row, column) {
  const count = sheet.getRange(row, column).getValue();
  sheet.getRange(row, column).setValue(count + 1);
}

5. メッセージを投稿する関数

上記を組み合わせて、回答者をメンションして質問を投げかける関数を作成します。

// 質問と回答者を投稿する
function postQuestion() {
  // 土日の場合は終了
  if (isWeekend()) return;

  // 質問を取得
  const questionRows = getRowsWithMinCount(questionSheet, 'B2:B');
  const randomQuestionRow = getRandomRow(questionRows);
  const question = questionSheet.getRange('A' + randomQuestionRow).getValue();

  // 回答者を取得
  const answererRows = getRowsWithMinCount(answererSheet, 'C2:C');
  const randomAnswererRow = getRandomRow(answererRows);
  const answerer = answererSheet.getRange('A' + randomAnswererRow).getValue();

  // Slackへの投稿
  const payload = {
    "channel": SLACK_CHANNEL,
    "text": "今日の質問",
    "blocks": [
      {
        "type": "section",
        "text": {
          "type": "mrkdwn",
          "text": "*<@" + answerer + ">さんに質問です！*\n\n" + question
        }
      }
    ]
  };

  const options = {
    'method': 'post',
    'contentType': 'application/json; charset=UTF-8',
    'headers': {
      'Authorization': 'Bearer ' + SLACK_TOKEN
    },
    'payload': JSON.stringify(payload),
    'muteHttpExceptions': true
  };

  try {
    const response = UrlFetchApp.fetch('https://slack.com/api/chat.postMessage', options);
    Logger.log(response.getContentText());

    // 出題回数の更新
    updateCount(answererSheet, randomAnswererRow, 3);
    updateCount(questionSheet, randomQuestionRow, 2);
  } catch (e) {
    Logger.log('エラー発生：' + e.message);
  }
}