🔍 概要

SlackのメッセージログなどをRailsアプリで受け取るには、Slack APIのEvent Subscriptions（イベントサブスクリプション）を利用します。

この記事では、Slackイベントを ChatsController#create に送る設定と、実装時にハマりがちなポイントをまとめます。

⚙️ 前提：Slackのイベント通知の仕組み

Slackからイベントを受け取るには、Slack Appの管理画面でEvent Subscriptionsを有効にし、
その送信先としてRails側のエンドポイントURL（例: /chats）を設定する必要があります。

Slackは設定時に“challenge” トークンをPOSTで送信してきます。
このトークンをそのままレスポンスすることで、SlackがURLの正当性を確認します。

🚧 ローカル開発では動作しない？

Slackからのリクエストは外部からアクセス可能なサーバーにしか送られません。
そのため、ローカル開発では動作確認ができません。
ステージング環境などを使って確認してください。
ただし、URLを変えるごとに“challenge”リクエストをする必要があるので、本番環境にURLを変える時は再度“challenge”リクエストをしてください。

✅ Rails側の実装

Slackからの"challenge"検証に対応するコードは以下のようになります。

class ChatsController < ApplicationController
  # Slackの検証のため、認証をスキップする（後述）
  skip_before_action :authenticate_verify, only: [:create]

  def create
    # SlackからのURL検証
    if params["challenge"]
      render json: { challenge: params["challenge"] }, status: :ok
      return
    end

    # ここにSlackイベント受信後の処理を書く
  end
end

⚠️ 注意点：独自認証との干渉に注意

Railsアプリ側で before_action による認証を使っている場合（例：authenticate_verify など）、Slackのchallengeリクエストが弾かれてしまいます。

これを回避するために、該当アクションではスキップする必要があります。

# challenge検証中は認証をスキップ
skip_before_action :authenticate_verify, only: [:create]

📝 challengeの検証が終わったら？

Slack側でURL検証（challenge）が成功すると、以降はイベント通知が送られるようになります。
その後は、params["challenge"]の処理は不要なので、コメントアウトまたは削除しておいても構いません。

# skip_before_action :authenticate_verify, only: [:create]
# if params["challenge"]
#   render json: { challenge: params["challenge"] }, status: :ok
#   return
# end

💡 まとめ

Slackのイベント通知を受け取るには、Event Subscriptionsと外部アクセス可能なエンドポイントが必要
Railsでは params["challenge"] をそのまま返す実装が必要
before_action で独自認証をしている場合は、Slackリクエストに対してスキップ指定が必要
challenge検証後は該当コードをコメントアウト or 削除してOK

📌 余談：ボットユーザーがいないというエラーについて

Slack App のインストール時に、「インストールするボットユーザーがありません」というエラーに直面することがあります。

私もこの問題に遭遇しましたが、以下の記事が非常に参考になりました。

お困りの方は、ぜひ一読をおすすめします。