【2021年】ボットを作成してSlack APIをGASから叩く方法 | SlackAppライブラリ未使用

こんばんは、しーまんです。

最近多くの会社ではSlackというチャットツールを使用してコミュニケーションをしてるところが増えました。コロナ化時代ではチャットツールの使用が必須化されているということですね。

私もSREという職業をしているとSlackを使うことがよくあり、ボットを作成したりAPIを叩いたりなどはよくしております。

そこで今回はSlackボットの作成方法とGASを使用して簡単にSlackAPIを叩くまでを紹介していこうと思います。

やることとやらないこと

SlackのAPIに関してはとても数が多いので、今回の記事だけでは紹介しきれません。
またボットの機能や、GASについても全てを紹介しだしたらきりがありません。

ですので最初に今回紹介することとしないことを明確にしておきたいと思います。

やること

• Slackボットの作成
• GASでSlackに対してユーザ取得とDMを送るAPIを実装

やらないこと

▼ Slack

▼ GAS

ということで前提条件を設定できましたので、実際に作成してきましょう。

Slackボット作成

まずはSlack側でbotの作成をしていきます。
下記からslack appsのページを開きます。

Slack API: Applications | Slack

api.slack.com

画面が遷移すると上部にある「Create New App」をクリックします。

するとポップアップが表示されます。
アプリの作成方法を選択できますので、こちらは「From scratch」を選択します。

次にアプリ名と連携するworkspaceを選択していきます。
アプリ名は自由に設定してください。

入力できたら、「Create App」をクリックします。

アプリの作成ができると「Basic Information」画面が表示されていると思います。
ここからボットの設定をしていきます。

まず左の項目かBasec Informationの右下にある「Permissions」の画面に遷移し、ボットのSlackに対する権限を設定していきましょう。

遷移して少し下にスクロールすると「Scopes」->「Bot Token Scopes」をいう権限を設定する箇所が見つかります。

ここから「Add an Oauth Scope」をクリックして権限を追加しましょう。
今回は「users.list」と「conversations.open」と「chat.postMessage」3つのAPIを使用しますので、「users:read」と「im:write」と「chat:write」の3つの権限を追加します。

APIに必要な権限は公式のドキュメントを確認しましょう。

「users.list」「conversations.open」 「chat.postMessage」

権限の設定が終わったら、ページの一番上に戻りworkspaceにアプリをインストールしていきます。
「Install to Workspace」をクリックしましょう。

クリックすると連携確認画面に遷移しますので、問題なければ「許可する」をクリックします。

連携が完了すると画面が戻り「OAuth Tokens for Your Workspace」に「Bot User OAuth Token」が発行されていると思います。こちらのトークンを後のGASで使用しますので、コピーしておきましょう。

こちらでボットの最低限の設定は終わりです。

GASの作成

Slack側の設定が完了しましたので、次にGAS側の設定をしていきます。

Googleドライブ上で右クリックすると作成したいファイルの種類が表示されます。
ここから「Google Apps Script」を選択して開きましょう。

GASの編集画面が開いたら下記コードを登録していきます。

// SlackAPIで登録したボットのトークンを設定する.
let token = "xoxb-から始まる上記Slack側の設定で取得したトークン";
let method = "post";
let contentType = "application/x-www-form-urlencoded";

// 取得したslackのユーザから特定の名前のユーザにDMを送る
function postTestMessage() {
  let members = getSlackUsers();
  let message = "通知テスト!!!";

  for(let i=0;i<members.length;i++) {
    if(members[i].name == "xxxxx_xxxxx") {

      console.log(members[i].id);
      let channel_id = getChannelID(members[i].id);
      console.log(channel_id);
      postMessage(channel_id, message);
      break;
    }
  }
}

// slackユーザの取得.
// https://api.slack.com/methods/users.list
function getSlackUsers() {
  let options = {
    "method" : method,
    "contentType": contentType,
    "payload" : {
      "token": token
    }
  }

  // 必要scope = users:read.
  let url = 'https://slack.com/api/users.list';
  let response = UrlFetchApp.fetch(url, options);
  let obj = JSON.parse(response);
  return obj.members;
}

// メンバーIDを受け取りチャンネルIDを返す.
// https://api.slack.com/methods/conversations.open
function getChannelID(user_id) {
  let options = {
    "method" : method,
    "contentType": contentType,
    "payload" : {
      "token": token,
      "users": user_id
    }
  }

  // 必要scope = im:write.
  let url = 'https://slack.com/api/conversations.open';
  let response = UrlFetchApp.fetch(url, options);
  let obj = JSON.parse(response);

  return obj.channel.id;
}

// メッセージを送る.
// https://api.slack.com/methods/chat.postMessage
function postMessage(channel_id, message) {
  let options = {
    "method" : method,
    "contentType": contentType,
    "payload" : {
      "token": token,
      "channel": channel_id,
      "text": message
    }
  }

  // 必要scope = chat:write.
  let url = 'https://slack.com/api/chat.postMessage';
  UrlFetchApp.fetch(url, options);
}

簡単に説明すると一番上で token の設定をしています。これはSlackボットの設定時に取得したトークンになります。

あとは3つのAPIを呼び出すAPIをそれぞれ実装し、最後に postTestMessage という実際にテストメッセージを送るメソッドを追加しました。このメソッドを呼び出すことでSlackに通知を送ることができます。

成功すると下記のようなメッセージが送られてきます。
ちゃんと作成したボットからダイレクトメッセージが送られてきていますね。

まとめ

今回はSlackのボット作成方法とGASを使ってSlack APIを使用する方法を紹介しました。

今回のボットは一番シンプルなものを作成しましたが、アイデア次第で色々便利なボットを作成することが可能です。

例えばスプレッドシートからデータを読み込んでSlackに通知するとか、インタラクティブにボットに質問したら返答を返すとか。ボットの機能は無限大です。

業務の効率化を図るにはボットの作成はもってこいですので、ぜひ皆さんもいろいろなボットを作成してみてください。