[Slack×GAS]Slackの絵文字を大きくしてスタンプ投稿するSlashコマンドを作る

テニス観戦が趣味の、カルロビッチと申します。初投稿です。

# 作るもの
Slackの絵文字が小さいので、LINEスタンプくらい大きくできたら楽しいなと思い、投稿された絵文字をもとにBotが大きなスタンプを投稿するコマンドを作りました。
既存記事がサーバー用意系でハードル高かったため、Google Apps Script（GAS）だけで作ります！非エンジニアの方でもわかるように書きます :umbrella:

![スクリーンショット 2022-04-16 16.07.19.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2631270/de80c70b-0cc1-13ba-170f-2ad5e7b8c2af.png)

# 全体像
SlackAppからスラッシュコマンドでスタンプ名をGASに対してPOSTし、GASでそのスタンプ名をSlack APIのemoji:listに投げて画像URLを取得、その画像をattachmentにもったJSONをSlack側に返して画像を表示させる。

# Slack側の設定
## 1. Slack Appを作成
https://api.slack.com/apps?new_app=1
「From Scratch」 → 名前とワークスペースを設定 → 「Create」

## 2. Commandを作る
![スクリーンショット 2022-04-16 16.15.43.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2631270/d5c4e410-cf53-b091-ab1d-f12d9a5c4989.png)
「Slash Commands」 → 「Create New Command」

![スクリーンショット 2022-04-16 16.17.51.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2631270/d5921198-9893-4fce-833d-51c1aed57e13.png)
Commandの設定を入力します。Request URLはあとで入力するので、とりあえず仮のURLを入れてSaveしましょう。

## 3. ワークスペースにAppをインストール
### ① サイドバーの「App Home」からPresenseの欄を「Edit」、Botの見た目を設定
わたしは、名前が見えると可愛くないので、今回全部「.」や「l」という名前にしました。
![スクリーンショット 2022-04-16 16.20.16.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2631270/3daee475-794a-bed0-2304-a20db59c21b9.png)

※ ここを設定せずInstallすると謎のエラーになります。

### ② サイドバーの「Basic Information」から「Install to Workspace」
![スクリーンショット 2022-04-16 16.25.17.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2631270/13f03537-670c-820d-de6f-f17fb3ac7d95.png)

## 4. Scopeを設定
このアプリはコマンドを受け取る以外何の権限ももっていないので、権限を持たせます。
サイドバーの「OAuth & Permissions」から、「Scopes」で、「Add an OAuth scope」で、絵文字を読むために「emoji:read」を選択しましょう。Bot側だけで大丈夫なはずなのですが、僕はUser側のtokenで作ってしまったので、両方に付与しちゃいました。
![スクリーンショット 2022-04-16 16.28.28.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2631270/d8df6f78-11b5-562a-c2d7-a1654cb94aee.png)
この画像のようになればok。
※ 今回のGASアプリケーションは全体に公開されるため、不要なscopeを与えないようにしましょう。レガシーなトークンで実装するのもやめましょう。

## 5. tokenを取得
サイドバーの「OAuth & Permissions」から、「User OAuth token」をコピーしておきましょう。これを後ほどGASで使います。
![スクリーンショット 2022-04-16 16.31.12.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2631270/35b9a7a3-1d93-1785-be92-5454501081a8.png)
※ このtokenは公開しないようにしましょう。

# GAS側の設定
## １. 任意の場所にスプレッドシートを作り、上のバーから「拡張機能」→「Apps Script」を開く
Googleドライブから直接作っても問題ないです。

## 2. コードを記述
このコードをコピペしてください。
```javascript

// 関数名がこの名前でなければGASがPOSTを受け取れない
function doPost(e) {
  const stamp = encodeURIComponent(e.parameter.text);
  // スタンプの前後のエンコードされた「:」を削除
  const name = stamp.replace(/%3A/g, '');
  const img = getEmojiBy(name);
  if (!img) {
    return ContentService.createTextOutput('絵文字がありません');
  }
  const response = {
    "response_type": "in_channel",
    "attachments": [
      {
        "image_url": img
      }
    ],
  };
  const payload = JSON.stringify(response);

  const output = ContentService.createTextOutput();
  output.setMimeType(ContentService.MimeType.JSON);
  output.setContent(payload);
  return output;
}

function getEmojiBy(name) {
  const token = 'ここに先ほどのtokenを入力';
  const url = 'https://slack.com/api/emoji.list?pretty=1';
  const headers = {
    'Authorization': 'Bearer ' + token
  };
  const options = {
    'method': 'GET',
    'headers': headers,
  };
  const res = UrlFetchApp.fetch(url, options);
  const data = JSON.parse(res);
  if (!data.ok) {
    return '';
  }
  const img = data.emoji[name];
  if (!img) {
    return '';
  }
  return img;
}
```

**上記関数内の`const token = ''`の部分の''の中に、先ほどSlackでコピーしたtokenを貼り付け、保存してください。**

※ ちなみに、doPest()内でLoggerを置いてもLogが出力されません。GCP連携を行えばいけるようです。僕は、doPost関数の外でなるべくデバッグして、createTextOutputでテキスト出力する、という感じで頑張りました。

## 3. デプロイ
このコードを外部から実行できるようにします。GAS画面の右上から「デプロイ」を押してください。
![スクリーンショット 2022-04-16 17.01.16.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2631270/f24de3e5-1155-6766-a0be-84ae0ae1d9c0.png)

「新しいデプロイ」→「ウェブアプリケーションとして」→「次のユーザーとして実行：自分」「アクセスできるユーザー：全員」にして、デプロイを押してください。
完了したら、`https://script.google.com/macros/s/----/exec`というURLが発行されるので、これを「コピー」。

# Slackにもどる
## slackに戻ってSlashコマンドのリクエスト先を変更
![スクリーンショット 2022-04-16 17.05.21.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2631270/a092ef35-9c7b-2587-534a-60d19a107b77.png)
サイドバーの「Slash Commands」から、先ほど作った/stampの右側の編集マーク✏️を押して、「Request URL」に上でコピーした`https://script.google.com/macros/s/----/exec`のURLを入力し、「Save」してください。

## slackで試してみる
`/stamp :スタンプ名:`と打ってみてください。無事にBotが現れたらOK！

![スクリーンショット 2022-04-16 16.07.19.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2631270/8edf8c03-d8bf-7948-dbad-6d4107771d05.png)

楽しいスラックライフを！

# 参考
https://tech.grooves.com/entry/2017/04/04/122107
https://qiita.com/dbgso/items/54cfa5c79d119888747c

ありがとうございました！