株式会社NucoAdvent Calendar 2023

【2023年最新版】便利機能からサービス連携までSlack活用術総まとめ

Posted at 2023-12-11

この記事はNuco Advent Calendar 2023の11日目の記事です。

はじめに

業務で当たり前のように使っているSlackですが、長年使っているうちに様々な便利機能の存在や連携できる外部サービスの幅広さなどに気付いたので、この機会に一度活用術としてまとめてみることにしました。
Slackをこれから使う初心者の方は全体像の外観と学習に、スラッシュコマンドやbotをバリバリ自作しているベテランSlackerの方は理解度の確認などにお役立てください。

主なトピック

Slackの概要と最新動向
基本の便利機能（表記方法、ショートカット、スラッシュコマンド）
Slackと外部サービスの連携（Incoming Webhook、GitHubなど）
おすすめのSlackアプリ
Slackアプリの自作(スラッシュコマンド、Bot）

細かい仕様や繰り返しの説明などは一部割愛しています。
まとめと使用方法・手順の簡単な紹介がメインテーマです。

そもそもSlackとは？

リモートワークが浸透した昨今において、社内外でコミュニケーションを取るためのチャットツールはもはや必需品と言えるでしょう。
Slackは普及率の高い代表的なチャットツールの一つであり、2013年にアメリカで公開されました。
デスクトップ版、ブラウザ版（Web版）、スマートフォン版があるので場所を選ばず使用でき、数あるチャットツールと比較すると、メインのチャット機能だけでなく様々な業務効率化の機能を備えているという点が特徴的です。
無料版と有料版がありますが、無料版でも十分に業務に使用可能で、実際にSlackユーザーの9割は無料ユーザーと言われています。

基本の便利機能

ここからは早速活用術の紹介に入っていきます。
Slackを使う上では基本となる、表記方法、ショートカット、スラッシュコマンドについてまとめています。

表記方法

メンション

@ユーザー名orグループ名

メンション＝メッセージを送る相手の指定です。
相手側で通知設定がオフになっていなければ、ポップアップで相手に通知が飛びます。
なお、クリックすればそのユーザーの簡易プロフィールを表示することもできます。

チャンネルリンク

#チャンネル名

特定のSlackチャンネルへのリンクになります。

引用表現

> 文章（※間に半角スペースを入れる）

先頭に｜が付いたインデントになります。
他のユーザーの発言を引用して一つずつ答える際などに便利です。

インライン引用表現

　`文章`　

文章がボーターで囲まれる＋文字色と背景色が変わって強調表示されます。
（ライトモードの時は文字色赤＋背景色グレー
ダークモードの時は文字色オレンジ＋背景色やや薄い黒）
ファイルパスなどを強調表示する時に便利です。

ボーダー付き引用段落表現

```文章```

文章が行単位にボーターで囲まれる＋背景色がグレーに変わって引用表示されます。
コードの共有に使われることが多いです。

イタリック

_文章_

イタリック体になります。

ボールド

*文章*

太字になります。

ストライク（取り消し線）

~文章~

文字に取り消し線をひけます。

絵文字

:絵文字名:

絵文字を打てます。（上記は:ok_hand:と打った場合）

ただ絵文字名は普通覚えてないので、絵文字ボタンを使う方が楽かもしれません。
一応先頭に:を打ってから単語を打てば、予測変換は可能です。

リアクション追加

+:絵文字名:

絵文字表記の先頭に+をつければ、直前のメッセージに絵文字でリアクションすることができます。

リアクション削除

-:絵文字名:

絵文字表記の先頭に-をつければ、直前のメッセージに自分で付けた同じ絵文字リアクションを削除することができます。

No.リスト

1. 文章（※間に半角スペースを入れる）

先頭にナンバーが付いたリスト表記になります。
ナンバーリスト化した行から改行すると、自動的に次のナンバーでのリスト表記になります。

色見本

#カラーコード

カラーコードの色見本が末尾に付きます。
ただしインラインでは色見本は表示されません。

ショートカット

`cmd + K` （チャンネル、DM、ワークスペースの切り替え）

チャンネル、DM、ワークスペースの切り替えが簡単にできる、言わずと知れたショートカットです。
チャンネル数やメンバーが増えてくると探すのが大変なので必須機能と言えます。
なお、create チャンネル名でチャンネル作成も可能です。

`cmd + G` or `cmd + F` （検索）

実行したチャンネル内でキーワードに一致するメッセージを検索できます。

`テキスト入力中 + cmd + ↑` （メッセージ編集）

実行したチャンネル内の直近の自分のメッセージを編集できます。
間に他のユーザーのメッセージがあっても大丈夫です。

`テキスト入力中 + cmd + Z` （メッセージ送信取り消し）

実行したチャンネル内の直近の自分のメッセージを送信取り消しできます。
ただし有効なのは以下の状況に当てはまる場合だけなので、ちょっと条件が厳しめ。

メッセージを送信してから 15 秒以内
会話の画面から移動していない
メッセージ入力が空の状態

送信先のチャンネルを間違えた時にすぐ消したりするのに使えます。
なお、取り消しできない場合は削除して対応するしかありません。

`shift + cmd + D` （サイドバーの表示/非表示を切り替え）

サイドバーの表示/非表示を切り替えられます。
狭い画面でスレッドの会話を追う時などに便利です。

`shift + cmd + J` （ダウンロードしたファイルの一覧表示）

ワークスペース内でこれまでにダウンロードしたファイルの一覧が表示できます。
履歴管理に使うもので、ダウンロード先ディレクトリの表示と履歴の削除ができます。
ただしダウンロード元のメッセージに飛ぶことはできません。

なお、ダウンロードしていない共有されたファイルなどを全てみたい場合は、ファイルビューを見る必要があります。
cmd + Kでファイルと入力して移動するか、新UIのサイドバーからその他 → 自分のオーガナイゼーション → ファイルで移動できます。
ファイルの詳細の共有情報から元のスレッドなどにも飛べます。

`shift + cmd + U` （リンク挿入）

リンクを挿入できます。
文字列を選択した状態で打てばリンクに変換することもできます。

`shift cmd + C` （インラインコード挿入）

インラインコードを挿入できます。
文字列を選択した状態で打てばインライン引用表現に変換することもできます。

`shift + cmd + H` （ハドルの開始/終了）

実行したチャンネル内でハドルミーティングの開始/終了ができます。

なお、ハドルミーティングとは、必要な時に短時間(10分〜30分)だけ集まって行う会議のことで、Slackではワークスペースのメンバー同士での音声会話機能のことを指します。

`shift + cmd + space` （ミュートON/OFF切り替え）

ハドル中にミュートON/OFFの切り替えができます。

スラッシュコマンド

スラッシュコマンドはSlackの特徴的な機能の一つで、リマインダや画面表示変更、ステータス操作など様々な機能をメッセージ投稿フォームにコマンドを打つことで実行できます。
メッセージ投稿フォームをSlack専用のターミナルやコマンドプロンプトだと考えれば分かりやすいでしょう。

その名の通りスラッシュ（/）でコマンドが始まります。
スラッシュを打つだけでもコマンド一覧が表示されるので、汎用的なものは覚えなくても使えます。

`/remind` （リマインド）

/remind {宛先} {メッセージ} {リマインド時間}

スラッシュコマンドの定番、リマインドを設定できるコマンドです。
自分や特定のユーザー、チャンネルに向けて、細かい時間指定や定期でのリマインドが可能です。

設定したリマインドは/remind listコマンドを打つか、「後で」ボタン（旧ブックマーク）から確認や変更、完了ができます。

注意点として、宛先とリマインド時間の指定は下記のルールに従う必要があります。
特にリマインド時間については、inやatを忘れたり、英語表記をただの数字にすると無効になるので、練習してから使うか、使いながら慣れていく必要があります。

宛先	書き方
自分	`me`
ユーザー	`@ユーザー名`
チャンネル	`#チャンネル名`

リマインド時間	書き方
今から〜後	`in {数字} {単位}` （`in 1 s`（1秒後） `in 5 m`（5分後） `in 12 h`（12時間後）など）
当日〜時に	`at {時間}` （時間： 8:00, 21:00, 5:00pm など）
〜日〜時に	`{mm/dd}` or `{mm/dd hh:mm}` or `on {英語表記日付}` （11/23, 12/4 14:35, on December 5 など）

一部の項目は省略可能

/remindだけ打った場合
自分向けのリマインドになり、表示されるリマインド設定ダイアログで詳細設定ができます。
ただしこの場合は「何分後」などの相対指定ができません。
/remind {メッセージ}だけ打った場合
自分向けのリマインドになり、Slackbotからのプルダウン付きメッセージでリマインド時間の設定をします。
ただしこの場合は規定の数種類からしか時間設定ができないので、指定したい時間がない場合はコマンドなどで設定する必要があります。

`/topic` （トピック設定）

/topic {トピック内容}

チャンネル名の横に表示されるトピックを設定できるコマンドです。
プロジェクトの概要やちょっとした補足情報を記載したり、チケットリンクを貼ったりするのに便利です。

`/who` （ユーザー一覧）

実行したチャンネルの参加ユーザー一覧を確認できるコマンドです。
ただし下記参考画像のように、アイコン無しの@ユーザー名だけの表示なのでちょっと見にくいです。

`/collapse`, `/expand` （画像・動画の折りたたみ、展開）

チャンネル内で表示されているファイルやリンクの画像などをすべて折りたたむ/展開するコマンドです。
/collapseで折りたたみ、/expandで展開されます。
大量に画像投稿されていたり、リンクを頻繁に貼っていてサムネイルが目立つチャンネルなどで使うとチャンネルがスッキリします。
なお、リンクの場合はサムネイルだけ折りたたまれ、タイトルや説明文は折りたたまれません。

`/active`, `/away`, `/status` （ログイン状態、ステータス変更）

ログイン状態やステータスを変更するコマンドです。
/activeでログイン状態をアクティブに変更、
/awayでログイン状態を離席中に変更できます。
/statusで表示されるステータス変更ダイアログからステータスを変更できます。
（/status ステータス名でステータス名の設定も可能です。）

`/shrug` （おまけ：あるアスキーアートの挿入）

/shrug [メッセージ]

メッセージの最後に ¯\_(ツ)_/¯ の絵文字を挿入するコマンドです。

何のために存在するのかは謎ですが、slack と shrug (肩をすくめる) をかけたジョークだと言われています。
「知らんがな」って時に使いましょう。¯\_(ツ)_/¯

Slackと外部サービスの連携

Slackは様々な外部サービスと連携して、メッセージの送受信、通知などができるようになっています。
下記では代表的な幾つかの外部サービスとの連携方法について、簡単な実装手順などと合わせて紹介します。

Incoming Webhook

任意のSlackチャンネルに外部ソースからデータを送信できる機能です。
システムのエラー発生時や、更新時などの通知先にSlackを使用する時に便利です。

ざっくりした実装イメージとしては、Webhook URLの発行 → スクリプトなどでpayloadに通知メッセージを入れてPOST、の流れになります。

旧方式のIncoming Webhook
2019~2020年頃から新方式が推奨になり、既存の方式は非推奨＆廃止予定です。

概要だけ紹介しておきます。
参加しているワークスペースから公式のアプリ画面にアクセスし、Webhookアプリからカスタムインテグレーションというものを設定することでWebhook URLを発行して使用します。

旧方式では通知先のチャンネルを設定してもpayload側の設定でチャンネルを切り替え可能で、Webhook URLとチャンネルの紐付けが曖昧になることが問題とされていたようです。

Webhook URLの取得手順

（※すでに自前のSlack Appを作成している場合は手順4.からになります）

公式の「slack app directory」のページに、参加しているワークスペースでログイン
「ビルド」→「Your apps」でアプリマイページに移動
「Create an App」→「From scratch」→ アプリ名を入力＆ワークスペースを選択して自前のSlack Appを作成
「Add features and functionality」→「Incoming Webhooks」を選択
Incoming WebhookのOn/OffのラジオボタンをOnにする
ページ下部に出てくるWebhook URL作成ページで「Add New Webhook to Workspace」を押す
作成したアプリからワークスペースへのアクセス権限付与の許可を求められるので、通知先のチャンネルを選択して許可する
6.のページにWebhook URLが追加される
同ページ内に動作確認用のcurlコマンドサンプルが用意されているので、Copyしてターミナルなどで実行
通知先に設定したチャンネルに「Hello, World!」の通知が来れば完了

通知メッセージの装飾
通知メッセージはWebhook URLに渡すpayloadのattachmentsという属性を使ってある程度の装飾が可能です。
装飾可能なのは色やレイアウト、画像の挿入などで、結構リッチにできます。

利用方法の説明は本筋からはずれるため、今回は割愛します。
詳細は下記の公式資料を参照してください。

payloadの要素：https://api.slack.com/reference/messaging/payload
装飾指定の方法と例：https://api.slack.com/reference/messaging/attachments

活用例：Lambda失敗時のエラー通知

Incoming Webhookの活用例として、AWS Lambdaでエラーが起きた時にSlackに通知する実装例を紹介します。言語はPythonです。

Incoming Webhookの作成
先ほどの手順でWebhook URLを作成

Lambdaの作成
新規にLambdaを作成し、エラーをcatchしたらエラーメッセージをペイロードに入れてWebhook URLにPOSTする処理を書いてデプロイ

（コードサンプル）

import json
import urllib.request


def post_to_slack(message):
    # Webhook URL
    incoming_webhook = "{Webhook URL}"

    # メッセージをjson形式に変換
    send_data = {
        "text": message,
    }
    send_text = json.dumps(send_data)

    # ヘッダーの設定
    headers = {"Content-Type": "application/json"}

    # リクエスト
    request = urllib.request.Request(
        incoming_webhook,
        data=send_text.encode("utf-8"),
        headers=headers,
        method="POST",
    )
    with urllib.request.urlopen(request) as response:
        _ = response.read().decode('utf-8')


def lambda_handler(event, context):
    try:
        raise Exception("（Lambda）エラー通知テストメッセージ")
    except Exception as e:
        # Slack通知
        post_to_slack(str(e))

動作確認
下記のように自前アプリから指定のチャンネルに通知が来れば完了

GitHub

バージョン管理の定番であるGitHubもSlackと連携可能です。
PR作成時や特定ブランチへのpush時などに通知するようにすれば、チーム間での円滑なレビューなどに役立ちます。
なお、GitHubアカウントがあることを前提とします。

GitHubアプリの追加・連携

公式の「slack app directory」のページに参加しているワークスペースでログイン
GitHubアプリを検索し、「Slackに追加」ボタンを押す
GitHubアプリとワークスペース間でのアクセス許可を求められるので、許可するボタンを押してSlackにアプリを追加する
GitHubアプリのチャンネルに初期登録メッセージが来ているので、「Connect GitHub account」ボタンを押す
GitHubアカウントとSlack間での連携を確認する画面になるので、「Connect GitHub account」ボタンを押す
認証コードが表示されるので、先ほどのSlackメッセージの「Enter Code」ボタンを押して認証コードを入れる
連携されたSlackとGitHubのアカウント名でログイン成功のメッセージが届く
/github subscribe owner/repoコマンド（ownerとrepoには自分のアカウント名とリポジトリ名を入れる）を実行するとGitHub側にSlackのアプリがインストールされていないというメッセージが出るので、「Install GitHub App」のボタンを押す
ブラウザでGitHub App側のSlackアプリインストール画面になるので、Slack連携を有効にしたいインストール先のアカウントやリポジトリを選択してインストール
再度/github subscribe owner/repoコマンド（ownerとrepoには自分のアカウント名とリポジトリ名を入れる）を実行し、入力したアカウント/リポジトリでSubscribedの表示が出たら連携完了

通知設定のカスタマイズ

デフォルトでは以下の場合に通知が飛ぶように設定されています。

issues
pulls
commits
releases
deployments

デフォルトでは下記の場合に通知が飛ばないので、通知を飛ばしたい場合は/github subscribe owner/repo {機能名}コマンドで追加します。

reviews
comments
branches
discussions
workflows
commits:*（全てのコミット）
+label:"your label"（プルリクやコメントに設定したラベル）

下記の機能については、通知対象などをコマンドに足すことで指定可能です。
指定方法の詳細は公式ドキュメントを参照してください。

commits
discussions
workflows
+label:"your label"

逆に特定の機能の通知を無効にしたい場合は、/github unsubscribe owner/repo {機能名}のコマンドで無効にできます。

なお、現在の購読設定は/github subscribe list featuresコマンドで確認することができます。

通知が来た場合は、下記のような形式でGitHubアプリからメッセージが届きます。

ZapierやIFTTTを使った連携

ZapierやIFTTTといったサービスを利用している場合は、Slackと外部サービス間の仲介役として使用することでも連携可能です。
なお、いずれの場合もアカウント登録などは完了していることを前提とします。

Zapier活用例：Gmailとの連携

Zapierとは、ノーコードでワークフローの自動化を実現するWEBアプリケーションサービスです。
5,000以上の様々な外部サービスを連携可能で、自分の業務に合わせた自動化ワークフロー（ZAP）を、プログラミング知識不要で作成できます。

今回はZapierを使ってGmailとSlackを連携させ、指定の文字列を含むメールが来たら通知を送るように設定してみます。

1. ZAP作成（Trigger - Gmailの連携）

Zapierにログインし、「Create Zap」でzap作成に入る
「Trigger」を選択してAppからGmailを検索し、Eventに「New Email Matching Search」を選択
「Sign in」ボタンを押すとZapierとGmail間のアクセスについての許可を求められるので許可する
「Search String」に条件となる文字列を入れる
「Test trigger」ボタンを押すと、実際にその時点で条件に合うメールの検索結果が表示される（テストはskipしても良い）

2. ZAP作成（Action - Slackの連携）

Trigger作成に続けて「Action」を選択してAppからSlackを検索し、Eventに「Send Channel Message」を選択
「Sign in」ボタンを押すとZapierとSlack間のアクセスについての許可を求められるので許可する
Actionの詳細設定画面になるので、下記を設定
- 通知対象のチャンネル
- メッセージの構成（日付、件名、送信者、メールURLなどから自由に組み合わせる）
- その他の項目（botや添付ファイルなどの設定）は任意
「Test step」を押すと、実際にSlackにテスト通知が送られる（テストはskipしても良い）
「Publish」ボタンを押して、ZAP登録を完了する

3. 動作確認
1.の4.で設定した文字列を件名や本文に含むメールを送り、指定のSlackチャンネルに通知が来れば完了

IFTTT活用例：YouTubeとの連携

IFTTTとは、Zapierと同様に様々なサービスをノーコードで自動ワークフロー化することができるWEBアプリケーションサービスです。
Zapierとは連携できるサービスの数や種類が異なるようです。

Twitterと連携した自動化などで有名でしたが、現在ではTwitterと連携するためにはProプランへの移行が必須となっているようです。
連携したいサービスの使用にProプランへの移行が必要かどうかは、事前に確認しておいた方がいいでしょう。

今回はYouTubeで指定の登録チャンネルに新しい動画が投稿されたら、Slackに通知を送るように設定してみます。

1. アプレット作成（If - YouTubeとの連携）

IFTTTにログインし、「create」ボタンからアプレットの作成に入る
「If」の「Add」ボタンからアプリ検索画面でYouTubeを検索し、「New public video from subscriptions」を選択
「Connect」ボタンを押すと、IFTTTとYouTube間のアクセスについての許可を求められるので許可する
アカウントと対象のチャンネルを選択し、「Create trigger」で登録

2. アプレット作成（Then That - Slackとの連携）

「Then That」のAddボタンからアプリ検索画面でSlackを検索し、「Post to channel」を選択
「Connect」ボタンを押すとIFTTTとYouTube間のアクセスについての許可を求められるので許可する
アカウントと対象のチャンネルの選択、およびメッセージフォーマットなどを設定して「Create acion」で登録
「Continue」 → 「Finish」でアプレットの登録を完了する

3. 動作確認
登録したチャンネルに新しい動画が投稿された際に、指定のSlackチャンネルに通知が来れば完了

上記で紹介した通り、ZapierもIFTTTもワークフローエディタがかなりシンプルで直感的にサービス連携が可能です。
連携できるサービス数も豊富で、海外でしかリリースされていないサービスなども多いため、自分だけが使っているツールをSlackと連携させることで、間接的にチームメンバーも使えるようにするなんてこともできるでしょう。

IFTTTはどちらかというとIoT系統に強いサービスと言われており、Zapierはサービス同士の選択肢が豊富で取得する情報を細かく設定可能など、それぞれに特徴があります。
一方でどちらも今年からAIによるサービスをリリースしているので、さらに幅広い役割を持ったワークフローを構築することができそうです。

Slackアプリの自作

ここまで見てきた通り、Slackには様々な機能があり、外部サービスとの連携も容易で、組み合わせ次第で様々な応用が可能です。
そしてSlackアプリは自作することも可能なので、欲しい機能が見つからない場合は自分で作ってしまうのもありです。
以下では、スラッシュコマンドとBotの自作方法について、記事などを参考にしながら簡単に紹介します。

スラッシュコマンドの自作

便利機能のところで紹介した通り、メッセージ投稿フォームにスラッシュ（/）で始まるコマンドを入力することで、Slackの様々な機能を利用することができます。
スラッシュコマンドの自作から処理の流れは、ざっくり下記のようになります。

1. Slackからアクセスされるwebサーバー（何らかの処理をする部分）を用意
2. Slack Appを用意し、スラッシュコマンドとアクセス先のURLを設定
3. 2.のSlack Appをワークスペースにインストール
4. スラッシュコマンドを実行すると、設定したURLに対してメッセージがPOSTされる
5. リクエスト先で受け取ったメッセージに応じて自動処理などを行う
6. レスポンスで応答メッセージなどを投稿する

上記の通り、Slackからのメッセージを受け取れるようにするためには、webサーバーなどを用意する必要があります。
ただし、GoogleのGASやAWSのLambdaなどを使用すれば、サーバー構築不要で比較的簡単に実装できます。サーバレス様様ですね。

自作する場合はセキュリティ対策に注意
webサーバーやBotの機能が不正に使用されないように、セキュリティ対策も必要になります。
Slack側のIPは非公開でIP制限による不正アクセス防止はできないようなので、Slackから提供されているHTTPリクエストを検証する機能などの使用が公式に推奨されています。
この点についてはこちらの記事に分かりやすく詳しく書かれていたので、参考にしてください。

以下では、勤怠記録用のGoogleスプレッドシートに勤怠を記録するスラッシュコマンドの自作方法を活用例として紹介します。

活用例：Googleスプレッドシートに勤怠を記録するスラッシュコマンド

勤怠管理表のスプレッドシートは下記のような形式であらかじめ準備できているとします。
シートは月単位で分かれていて、日付単位の行に勤務時間の入力欄があります。
出勤と退勤の時間が別々に記録できるようになっているので、それぞれ記録すれば勤務時間の合計は関数で自動集計されるようになっています。

下記表の通り、/attendanceのスラッシュコマンドをin（出勤）とout（退勤）のメッセージと合わせて実行することで、出勤と退勤の時間がスプレッドシートに記録されるようにします。

スラッシュコマンド	機能
`/attendance in`	出勤の打刻
`/attendance out`	退勤の打刻

作成手順

Slack Appの作成
スラッシュコマンドの作成にあたり認証トークンが必要なので、まずはSlack Appを作成します。
Slack Appの作成手順については、Webhook URLの取得手順1.~3.を確認してください。
Slack Appが作成できたら、アプリの管理画面に移動し、「Basic Information」 → 「App Credentials」を確認します。
「Verification Token」に表示されているランダムな文字列が認証用のトークンになるので、次の手順で使用するためにメモしておきます。

GASの作成
GASでスクリプトを作成していきます。
今回の要件では、認証に使用するトークンとメッセージ内容が取得できれば十分そうなので、payloadからtokenとtextの値を取得するようにします。
（スラッシュコマンド実行時にPOSTされるpayloadの内容は公式の資料を参照してください。）
なお、先ほど取得したSlack Appの認証トークンはセキュリティ情報なので、GASのスクリプトプロパティに登録して使用することにします。

スクリプト全体の処理内容は下記のようになります。

1. doPost関数でPOSTリクエストを受け取る
2. 現在時間を取得
3. payloadからtokenを取得して認証
4. payloadからtextを取得し、出勤か退勤か判定
5. 時刻情報から記録先のシートと行番号を判定
6. 出勤or退勤の適当な方のセルに時間を入力
7. 打刻完了のメッセージと日時情報をレスポンスで返す

下記が完成したコードです。

// Slackスラッシュコマンドからのデータを処理する関数（POSTリクエストなので必ずdoPostを用意する）
function doPost(e) {
  // 打刻時間を先に取得しておく
  var date = new Date();

  // トークンで認証
  var verificationToken = e.parameter.token;
  var tokenCheckValue = PropertiesService.getScriptProperties().getProperty('VERIFICATION_TOKEN')
  if (verificationToken != tokenCheckValue) { 
    throw new Error('Invalid token');
  }

  const allowValues = ['in', 'out']
  var responseMessage = 'empty message'

  // Slackからのメッセージを取得
  var text = e.parameter.text;// in（出勤） or out（退勤）

  // 出勤か退勤か判定
  if (!allowValues.includes(text)) {
    // in, out以外のメッセージの場合は使用可能な値を教えるメッセージを返す
    responseMessage = '出勤の場合は in 、退勤の場合は out を指定してください。';
  }
  if (text == 'in') {
    // Googleスプレッドシートに出勤記録
    responseMessage = clockInAppendToSpreadsheet(date);
  }
  if (text == 'out') {
    // Googleスプレッドシートに退勤記録
    responseMessage = clockOutAppendToSpreadsheet(date);
  }

  // Slackに打刻完了メッセージをレスポンスで返す
  let response = { text: responseMessage };
  return ContentService.createTextOutput(JSON.stringify(response)).setMimeType(ContentService.MimeType.JSON);
}

// Googleスプレッドシートに出勤の打刻
function clockInAppendToSpreadsheet(date) {
  // Dateオブジェクトから打刻時間などを取得
  var clockInTime = Utilities.formatDate(date, 'JST', 'HH:mm');
  var timestamp = Utilities.formatDate(date, 'JST', 'yyyy/MM/dd HH:mm:ss');
  var dayString = date.getDate() + '日';
  
  // スプレッドシートを取得
  var spreadsheetId = PropertiesService.getScriptProperties().getProperty('SPREAD_SHEET_ID');
  var sheetName = Utilities.formatDate(date, 'JST', 'yyyy_MM');
  var sheet = SpreadsheetApp.openById(spreadsheetId).getSheetByName(sheetName);

  // 打刻する行を特定
  var row = get_row(dayString, 'D', sheet);

  // メッセージの書き込み
  sheet.getRange('F' + row).setValue(clockInTime);

  // レスポンスメッセージを生成
  var message = '出勤の打刻をしました。打刻時間： ' + timestamp

  return message
}

// Googleスプレッドシートに退勤の打刻
function clockOutAppendToSpreadsheet(date) {
  // Dateオブジェクトから打刻時間などを取得
  var clockInTime = Utilities.formatDate(date, 'JST', 'HH:mm');
  var timestamp = Utilities.formatDate(date, 'JST', 'yyyy/MM/dd HH:mm:ss');
  var dayString = date.getDate() + '日';
  
  // スプレッドシートを取得
  var spreadsheetId = PropertiesService.getScriptProperties().getProperty('SPREAD_SHEET_ID');
  var sheetName = Utilities.formatDate(date, 'JST', 'yyyy_MM');
  var sheet = SpreadsheetApp.openById(spreadsheetId).getSheetByName(sheetName);

  // 打刻する行を特定
  var row = get_row(dayString, 'D', sheet);

  // メッセージの書き込み
  sheet.getRange('H' + row).setValue(clockInTime);

  // レスポンスメッセージを生成
  var message = '退勤の打刻をしました。打刻時間： ' + timestamp

  return message
}

// col列で特定の値と一致する行数を返す
function get_row(key, col, sh){
 var array = get_array(sh, col);
 var row = array.indexOf(key) + 1;
 return row;
}

// col列の最終行を取得して1から最終行までの数字を配列で返す
function get_array(sh, col) {
  var last_row = sh.getLastRow();
  var range = sh.getRange(col + "1:" + col + last_row)
  var values = range.getValues();
  var array = [];
  for(var i = 0; i < values.length; i++){
    array.push(values[i][0]);
  }
  return array;
}

スクリプトが完成したら、ウェブアプリとしてデプロイし、発行されたURLをメモしておきます。

Slack Appにスラッシュコマンドを登録
1.で作成したSlack Appの管理画面に戻り、「Basic Information」 → 「Add features and functionality」 → 「Slash Commands」 → 「Create New Command」でスラッシュコマンドの作成画面に移動します。

/で始まるコマンドと、2.で取得したスクリプトのURLを設定します。
Short Descriptionはスラッシュコマンドの説明文として予測候補に表示されるので、設定しておいた方が分かりやすいでしょう。
設定したら「Save」ボタンを押して保存します。
作成したAppのインストール
作成したSlack Appは他のアプリと同様に自分のワークスペースにインストールする必要があります。
アプリの管理画面で「Basic Information」 → 「Install your app」 → 「Install to Workspace」ボタンを押します。
アプリが投稿可能なチャンネルの指定と許可の画面が出るので、チャンネルを指定して許可し、インストールします。
インストールに成功すると、ページ内のヘッダー下部に緑色のバーで「Success!」と表示されます。
動作確認
スラッシュコマンドを実行してみます。
メッセージ投稿フォームで/を入力してみると、作成したスラッシュコマンド（/attendance）が予測候補に出てきました。

in（出勤）とout（退勤）を付けてコマンドを打ってみると、打刻完了のメッセージと時刻が表示され、スプレッドシートにもちゃんと時刻が記録されています。

このように、スラッシュコマンドの仕組み自体はシンプルで、実装も簡単な上に自由度も高いです。工夫次第で業務のちょっとした効率化などに活用できるのではないでしょうか。

Botの自作

今度はSlack Botを自作してみます。
スラッシュコマンドと同様に自由度は高いですが、権限周りの設定が必要な分、実装難易度が少し高くなります。

処理内容によりますが、下記がSlack Botの自作から処理までの流れの一例になります。

1. Slackからアクセスされるwebサーバー（何らかの処理をする部分）を用意
2. Slack Appを用意し、Botの表示名、権限、サブスクリプション、アクセス先のURLなどを設定
3. 2.のSlack Appをワークスペースにインストール
4. Botを実行すると、設定したURLに対してメッセージなどがPOSTされる
5. リクエスト先で受け取ったメッセージに対して自動処理などを行う
6. レスポンスで応答メッセージなどを返す

こうしてみるとスラッシュコマンドの自作方法と流れは同じです。
無論、webサーバーが無くても、先ほどと同様にGASやLambdaなどを使ってサーバレスでも作成できます。
また、Bot用の署名や認証の仕組みもしっかり用意してあるので、セキュアな仕組み作りが可能です。

今回は「ChatGPTと会話するSlack botを最速で実装する」という素敵な記事を見つけたので、これを参考にしてSlack Botの自作にチャレンジしてみます。

活用例：ChatGPTと会話するBot

完成イメージ

参考記事に記載されているのものと同じく、Botに対するメンション付きで質問を投げると、ChatGPTからの返答がメッセージで返ってくるようにします。

作成手順

細かい手順やコード詳細などについては、参考元の記事を確認してください。

OpenAI APIの用意
ChatGPTを使うので、OpenAI APIの使用登録をします。
詳しい登録方法などはここでは割愛しますが、現在初期登録で5ドル分までは無料で使用可能なようです。
後でAPIキーの設定が必要になるので、メモしておきます。
Slack Appの作成
Botを設定するSlack Appを作成します。
Slack Appの作成手順については、Webhook URLの取得手順1.~3.を確認してください。
Slack Appが作成できたら、アプリの管理画面に移動し、「OAuth & Permissions」 → 「Scopes」の「Bot Token Scopes」で下記の権限を追加します。
- app_mentions:read（アプリへのメンションの読み取り）
- channels:history（チャンネル内の会話履歴の読み取り）
- chat:write（チャットの書き込み）
同じページ内の「OAuth Tokens for Your Workspace」の「Bot User OAuth Token」がアプリの認証トークンになるので、こちらも後で使うためにメモしておきます。
また、「Basic Information」 → 「App Credentials」の「Signing Secret」が署名用のキーになり、こちらも使うのでメモしておきます。
Lambdaの実装
実装はLambdaで行います。
こちらも詳しい実装やコードは参考にさせていただいた記事の通りなので割愛しますが、関数のHTTPエンドポイントをBotに設定するので、Lambda作成時に詳細設定からエンドポイントを作成して、忘れずにメモしておきましょう。
また、コード内で使用するため、1.のOpenAI APIのAPIキーと、2.のBot User OAuth TokenとSigning Secretを忘れずにLambdaの環境変数に設定しておきます。
Slack Botのイベントサブスクリプションを設定
Botを実行した時に処理を送るエンドポイントが取得できたので、イベントサブスクリプションを設定します。（Bot実行のトリガーのようなものです）
アプリ管理画面で「Event Subscriptions」 → 「Enable Events」の「Request URL」にLambdaのエンドポイントを入力します。
URLが検証され、問題なければ緑色の文字で「Verified」と表示されます。

次に、ページ下部の「Subscribe to bot events」を開き、購読するイベントを設定します。
「Add Bot User Event」から「app_mention」のイベントを設定したら、「Save Changes」で設定を保存します。
動作確認
作成したBotにメンション付きで質問して動作確認してみます。
質問すると「system 処理中......」と表示され、少し待つとChatGPTからの返答が返ってきます。

Slack Botも仕組み自体はシンプルです。実装に応じた権限設定がやや手間ですが、Botなら普通のユーザーと同じSlack上の操作が可能なので、組み合わせ次第で何でも作れそうですね。

まとめ

SlackにはスラッシュコマンドやSlackアプリなどの様々な便利機能や活用方法があります。
使い方次第で、業務の効率化したり、メンバー間のコミュニケーションの幅を広げたりすることが可能です。

Incoming Webhookや、Zapierなどのワークフロー化アプリなどを活用することで、外部サービスとの連携も簡単にできます。
スラッシュコマンドやSlack Botは自作もできるので、Slackをチームに合わせて自由にカスタマイズできるのも魅力的です。

チャットツールとして世界中の様々な企業や団体で使われているSlackは、来年にはAI関連機能のリリースも予定しています。
今後も高い需要が見込まれるため、技術スタックの一環として色々な活用術を習得しておきましょう。

弊社Nucoでは、他にも様々なお役立ち記事を公開しています。よかったら、Organizationのページも覗いてみてください。
また、Nucoでは一緒に働く仲間も募集しています！興味をお持ちいただける方は、こちらまで。

参考資料

Qiita
slack でのいろんな表記方法
https://qiita.com/sheercat/items/186c71af92c9494ab26f

Slackであまり知られていない便利機能一覧
https://qiita.com/kozyty@github/items/cbe58a72a715b540c60f

slackのIncoming webhookが新しくなっていたのでまとめてみた
https://qiita.com/kshibata101/items/0e13c420080a993c5d16

Slackが楽しくなるbot「Colla」の紹介と、導入のためにやったこと
https://qiita.com/acnaman/items/2eb395282384e6481b96

Slackのスラッシュコマンドを作成する
https://qiita.com/ytamu2/items/f81f9bc0023ef8758377

Slack Botの種類と大まかな作り方
https://qiita.com/namutaka/items/233a83100c94af033575

Slack公式
新しくなった Slack のデザインで、仕事にさらに集中
https://slack.com/intl/ja-jp/blog/productivity/a-redesigned-slack-built-for-focus

Slackの使い方 - メッセージの編集または削除
https://slack.com/intl/ja-jp/help/articles/202395258-%E3%83%A1%E3%83%83%E3%82%BB%E3%83%BC%E3%82%B8%E3%81%AE%E7%B7%A8%E9%9B%86%E3%81%BE%E3%81%9F%E3%81%AF%E5%89%8A%E9%99%A4

Enabling interactivity with Slash Commands
https://api.slack.com/interactivity/slash-commands#app_command_handling

その他
企業のビジネスチャット利用実態調査2021
https://www.bizclip.ntt-west.co.jp/articles/bcl00014-027.html

Slack Statistics to Annoy Your Colleagues With
https://kommandotech.com/statistics/slack-statistics/

Slack says that while its user numbers still lag Microsoft's, what really matters is that users love its app a lot
https://www.businessinsider.com/slack-daily-active-users-microsoft-teams-2019-10

20年のトップ＃2023スラック統計とトレンド
https://www.websiterating.com/ja/research/slack-statistics-trends/

「Slack AI」2023年冬にパイロット版をリリースへ　チャンネルやスレッドの要約に対応
https://enterprisezine.jp/news/detail/18376

Slack隠しコマンド26選｜作業効率が圧倒的に変わる魔法のコマンド集
https://ishikawa-blog.com/slack-hidden-command-selection/

【画像付き】Slackのリマインダー機能の設定方法と4つの便利な使い方
https://www.icraft.jp/useful/slack-reminder/

Zapier連携：Gmailの受信メール (特定ラベル) をSlackに通知
https://notepm.jp/blog/5863

IFTTTでSlackとyoutubeを連携させる
https://note.com/nogaill/n/n7bfc53239242

TrelloとSlackの連携手順を解説！タスク管理を省力化
https://autoro.io/blogs/trello-slack/

You get articles that match your needs
You can efficiently read back useful information
You can use dark theme

What you can do with signing up

【2023年最新版】便利機能からサービス連携までSlack活用術総まとめ

はじめに

そもそもSlackとは？

最新動向

普及率

最近のアップデート

今後のアップデート

基本の便利機能

表記方法

メンション

チャンネルリンク

引用表現

インライン引用表現

ボーダー付き引用段落表現

イタリック

ボールド

ストライク（取り消し線）

絵文字

リアクション追加

リアクション削除

リスト

No.リスト

色見本

ショートカット

cmd + K （ チャンネル、DM、ワークスペースの切り替え ）

cmd + G or cmd + F （ 検索 ）

テキスト入力中 + cmd + ↑ （ メッセージ編集 ）

テキスト入力中 + cmd + Z （ メッセージ送信取り消し ）

shift + cmd + D （ サイドバーの表示/非表示を切り替え ）

shift + cmd + J （ ダウンロードしたファイルの一覧表示 ）

shift + cmd + U （ リンク挿入 ）

shift cmd + C （ インラインコード挿入 ）

shift + cmd + H （ ハドルの開始/終了 ）

shift + cmd + space （ ミュートON/OFF切り替え ）

スラッシュコマンド

/remind （ リマインド ）

/topic （ トピック設定 ）

/who （ ユーザー一覧 ）

/collapse, /expand （ 画像・動画の折りたたみ、展開 ）

/active, /away, /status （ ログイン状態、ステータス変更 ）

/shrug （ おまけ ： あるアスキーアートの挿入 ）

Slackと外部サービスの連携

Incoming Webhook

Webhook URLの取得手順

活用例：Lambda失敗時のエラー通知

GitHub

GitHubアプリの追加・連携

通知設定のカスタマイズ

ZapierやIFTTTを使った連携

Zapier活用例：Gmailとの連携

IFTTT活用例：YouTubeとの連携

おすすめのSlackアプリ

Googleドライブ

Polly

Trello

Colla

Stock

Slackアプリの自作

スラッシュコマンドの自作

活用例：Googleスプレッドシートに勤怠を記録するスラッシュコマンド

作成手順

Botの自作

活用例：ChatGPTと会話するBot

完成イメージ

作成手順

まとめ

参考資料

`cmd + K` （チャンネル、DM、ワークスペースの切り替え）

`cmd + G` or `cmd + F` （検索）

`テキスト入力中 + cmd + ↑` （メッセージ編集）

`テキスト入力中 + cmd + Z` （メッセージ送信取り消し）

`shift + cmd + D` （サイドバーの表示/非表示を切り替え）

`shift + cmd + J` （ダウンロードしたファイルの一覧表示）

`shift + cmd + U` （リンク挿入）

`shift cmd + C` （インラインコード挿入）

`shift + cmd + H` （ハドルの開始/終了）

`shift + cmd + space` （ミュートON/OFF切り替え）

`/remind` （リマインド）

`/topic` （トピック設定）

`/who` （ユーザー一覧）

`/collapse`, `/expand` （画像・動画の折りたたみ、展開）

`/active`, `/away`, `/status` （ログイン状態、ステータス変更）

`/shrug` （おまけ：あるアスキーアートの挿入）