【GAS】Slackのbotを利用してメールアドレスからDMを送る #Slack

はじめに

Google Apps Scriptを用いてSlackAPIを利用したDM送信については記事がいくつかあります。
実際に利用してみるとメールアドレスからIDを検索してDMを送るにはSlack APIを3回叩く必要があるため、一回利用したものはGoogle SpreadSheetでリスト化し、以降はそこからIDを検索して読み出すようにします。

Slack API用トークンを取得

トークンを取得するまでの流れは他の記事にもあるので紹介しておきます。
参考：Slack API を使って email から User ID を取得
必要なScopeだけ下記に記載します。

メールアドレスからSlackのユーザIDを取得

他記事を見るとGETリクエストでIDを取得しているものが多いのですが、現在だとtokenはpostで送ってくださいとあるので、postで送ります(getで送るとinvalid_authでエラーになります)。
SLACK_APP_TOKENには取得したトークンが入ります。

//=========================================================================================
// メールアドレスからSlackのユーザIDを戻す
//=========================================================================================
function getSlackIdfromEmail(email) {
  var options = {
    "method": "post",
    "contentType": "application/x-www-form-urlencoded",
    "payload" : {
      "token": SLACK_APP_TOKEN,
      "email":email
    }
  };
  var response = UrlFetchApp.fetch('https://slack.com/api/users.lookupByEmail', options);
  var res = JSON.parse(response);

  if(res.ok){
    return res.user.id;
  }else{
    Logger.log(res);
    return null;
  }
}

ユーザIDからDMのIDを取得

ユーザIDだけではDM送信できないので、DMのチャンネルIDを取得します。

//=========================================================================================
// SlackのユーザIDからDM用のIDを戻す
//=========================================================================================
function getChannelID(memberId) {
 
  var options = {
    "method" : "post",
    "contentType": "application/x-www-form-urlencoded",
    "payload" : {
      "token": SLACK_APP_TOKEN,
      "users": memberId
    }
  };
  

  var response = UrlFetchApp.fetch('https://slack.com/api/conversations.open', options);
  var res = JSON.parse(response);
  
  if(res.ok){
    return res.channel.id;
  }else{
    Logger.log(res);
    return null;
  }
}

リスト保存用のスプレッドシートを作る

ここまでで取得した、

メールアドレス
SlackのユーザID
DMのチャンネルID
の3つをリストとして保存するためのシートを作ります。

作成したリストをメールアドレスで検索し、あればその情報を返す関数を作ります。
MEMBER_SHEET_IDにはスプレッドシートのIDが、SLACKID_LIST_NAMEにはシート名が入ります。

//=========================================================================================
// スプレッドシートにメールアドレスがあるか検索し、あれば詳細を返す（なければnull）
//=========================================================================================
function getSlackUserfromSpreadSheet(email){
  var ss = SpreadsheetApp.openById(MEMBER_SHEET_ID).getSheetByName(SLACKID_LIST_NAME);
  var values = ss.getRange(1,1,ss.getLastRow(),3).getValues();
  values.forEach(function(value){
    if(value[0] == email){
      var response = {
        "mail":email,
        "id":value[1],
        "channelId":value[2]
      }
      return response;
    }
  });
  return null;
}

DMを送信＆ID情報を保存

DMを送りつつ、新しいユーザ情報だった場合はSpreadSheetに保存するようにします。

//=========================================================================================
// SlackのメールアドレスからIDを取得してDMを送る
//=========================================================================================
function postDirectMessage(email,message) {

  var id;
  var channelId;

  //スプレッドシートにユーザ情報があるか検索
  var user = getSlackUserfromSpreadSheet(email);

  //ユーザ情報があればそのまま格納
  if(user != null){
    id = user.id;
    channelId = user.channelId

  //ユーザ情報が無い場合はSlackAPIを叩いて取得し、スプレッドシートに追加する
  }else{
    id = getSlackIdfromEmail(email);
    if(id != null){
      channelId = getChannelID(id);
      //チャンネルIDもあればスプレッドシートに追加
      if(channelId != null){
        var ss = SpreadsheetApp.openById(MEMBER_SHEET_ID).getSheetByName(SLACKID_LIST_NAME);
        ss.appendRow([email,id,channelId]);
      }
    }
  }

  //ユーザがいた場合
  if(id != null && channelId != null){

    var message_options = {
      "method" : "post",
      "contentType": "application/x-www-form-urlencoded",
      "payload" : {
        "token": SLACK_APP_TOKEN,
        "channel":channelId,
        "text": '<@' + id + '>\n' + message
      }
    };
    
    //DM送信
    UrlFetchApp.fetch('https://slack.com/api/chat.postMessage', message_options);
  }
}

これで取得～送信～保存までの処理ができるようになりました。