Slack 検索の返信がメインの行に出る問題を解決した話(GAS)

Slack 検索の返信がメインの行に出る問題を解決した話(GAS)

GASでSlackのメッセージ検索結果を出力する際に、スレッド内の返信をメインの投稿として出力してしまう問題が発生しました。その原因と、permalink を活用した解決策について紹介します。
2026.11.20

はじめに

こんにちは、クラスメソッドオペレーションズの小原です。
今回は GAS(Google Apps Script)で Slack のパブリックチャンネルから、指定した検索ワードを含む会話を取得し、スプレッドシートへ出力する課題に取り組みました。
その中で出力結果が仕様とは異なる実装となってしまったため、その原因と解決策についてまとめます。

当初の設計

今回想定していた設計は以下の通りです。

概要
Slack のパブリックチャンネルから、指定した検索ワードを含む会話を取得し、スプレッドシートへ出力する。

検索条件
検索処理は使用者が任意のタイミングでスプレッドシートのメニューバーから実行可能とする。
検索条件として下記を必須項目として設定する。各項目の値は使用者が任意に設定可能とする。

  • 検索対象 Slack チャンネル名(1 つ)
  • 検索対象ワード(カンマ区切りで複数指定可。各ワードは OR 条件とする)
  • 検索対象期間(過去何時間以内)

検索対象期間は、実行時刻から指定した時間前までの投稿に絞り込みます。
検索クエリには日付の条件(after:)を使い、取得後に投稿の ts(Unix 時間)と比較して時間単位で絞り込みます。

検索対象の範囲
検索対象はメインスレッドのみとする。
返信スレッド内にのみ検索対象ワードが存在する場合は検索結果として含めない。

出力
検索結果は処理実行ごとにスプレッドシート内に新しいシートを追加して出力する。
ただし、検索結果が無い場合はシートを追加しない。
出力内容として返信スレッドを含めること。

発生した問題

今回の仕様では、検索対象はメインの投稿(親投稿)のみとし、返信スレッド内にのみ検索ワードがある場合は検索結果に含めない仕様です。
しかし実際に実装すると、スレッドにだけ検索ワードを入れた投稿を作成して検索した際に、返信(スレッド内の投稿)がメインの行として表示されてしまいました。
実際の画面は以下の通りです。

実際のメッセージ

検索画面

出力結果

実装したコードは以下の通りです。

原因

Slack の検索 API(search.messages)は、クエリに一致するメッセージを返します[1]
。
今回の検証では、検索結果に返信も含まれていました。
このメソッドを使うには、user token と search:read スコープが必要です[1]
。
なお、search.messages は legacy メソッドとされており、公式ドキュメントではassistant.search.context の利用が推奨されています[1]
。
検索結果とスレッドの取得結果が、コードのどの段階でどう変わるかを確かめるため、一時的に以下のログを追加しました。(確認後に削除しています。)

検索結果の中身の確認コード

テスト用 Slack メッセージ

検索条件

出力されたログ(修正前)

実際のスプレッドシートへの出力(修正前)

原因: 検索結果の thread_ts が空で、返信かどうかを判別できなかった
今回のログで確認すべき点は、それぞれの [search] の 1 行目の thread_ts= の部分です。
thread_ts= は「この投稿はどのスレッドに属するか」を書く欄で、- はこの欄が空であることを表しています。
今回の実装では、メインの投稿の thread_ts= も空でした。
つまり、ログ上の thread_ts= だけでは、スレッドかメインかを見分けられません。

ここで、Slack の公式ドキュメントを確認しました。
検索結果の各メッセージには permalink が含まれることが分かりました[1]
。
一方、ドキュメントの返却例には thread_ts の項目がありませんでした[1]
。
返信の permalink に親投稿の ts が含まれることは、今回のログで確認しました。

当初は、検索結果の項目だけで返信を判別できると考えていました。
しかし、文献の返却例には返信を判別するための項目がなく、今回の検証でも thread_ts は空でした。
そのため、検索結果の項目だけで判定するのではなく、投稿に含まれる情報(permalink)から判定すべきでした。

解決策

そこで、検索結果の項目だけに頼らず、permalink を使って返信かどうかを判定する方針にしました。
今回は、検索結果の permalink から親のタイムスタンプ(ts)を取り出し、返信かどうかを判定します。
今回の検証では、検索結果の thread_ts 項目は空でした。
一方、permalink には親の ts が書かれていました。
そのため、permalink から ts を読み取ることで返信を見分けられます。

判定のルール

状態 permalink の thread_ts 判定
親投稿 なし、または自分の ts と同じ 残す
返信 自分の ts と違う(親投稿の ts) 除外する
判定不能 取り出せない(null) 残す(親投稿として扱う)

※判定不能(null)の場合は除外せず残します。
null と ts を比較すると「違う」と判定され、親投稿まで除外されるため、比較の前に null を確認します。

上記のように、親投稿の ts は自分自身の ts と一致し、返信の thread_ts は親投稿の ts になります。
そのため、メインの投稿かスレッドかを判断できます。

変更箇所 1: タイムスタンプ(ts)を取り出す関数を追加する
permalink から親投稿の ts を取り出す関数 extractThreadTs を追加します。

この関数は、次の順に処理します。

  1. permalink が空なら、null を返して終わる。
  2. thread_ts= の後ろにある数字とドットの並び(例: 1700000000.123456)を探して取り出す。
  3. 見つかったら ts を返し、見つからなければ null を返す。

この関数は runSearch と searchSlackMessage の間に配置しています。

変更箇所 2: スレッドかどうかの判定を書き換える
変更前は、検索結果の thread_ts の項目だけで判定していました。
しかし、今回の検索結果ではこの項目が空だったため、スレッドの返信もメインの投稿として扱われていました。
そのため、スレッドかどうかの判定を以下のように書き換えます。

変更後は、以下の 2 つの判定のどちらかに当てはまれば、スレッドとして除外します。

  1. 検索結果の thread_ts が空でなく、かつ自分の ts と違う(今までの判定)
  2. permalink から取り出した親投稿の ts が、自分の ts と違う(今回追加した判定)

2 つ目の判定により、thread_ts の項目が空でもスレッドを見分けられます。
なお、文献には、近い位置にある複数の一致は1件だけ返される場合があると記載されています[1]
。
今回の検証では、この影響は確認していません。

実際の出力は以下の通りです。

出力されたログ(修正後)

実際のスプレッドシートへの出力(修正後)

まとめ

今回の問題は、検索結果の thread_ts が空だったため、スレッドかどうかを判別できず、返信にだけ検索ワードがある投稿がメインの投稿として出力されてしまったことでした。
そこで、投稿へのリンク(permalink)に含まれる親投稿の ts を取り出し、投稿自身の ts と比較する方法に変更しました。
その結果、返信にだけ検索ワードがある投稿は結果に含めず、親投稿に検索ワードがある場合のみ、返信を含めたスレッド全体を出力できるようになりました。
今回の経験から、仮説を立てるだけでなく、ログや出力で実際に確かめることの重要性を学びました。
今後もログや出力でひとつずつ確認しながら様々な実装に挑戦していきたいです。

※「チャンネルにも送信」した返信も、permalink から親の ts を取り出して判定するため、返信として扱われます。
そのため、この返信にだけ検索ワードがあっても、メインの行には出力されません。

参考文献

クラスメソッドオペレーションズ株式会社について

クラスメソッドグループのオペレーション企業です。
運用・保守開発・サポート・情シス・バックオフィスの専門チームが、IT・AIをフル活用した「しくみ」を通じて、お客様の業務代行から課題解決や高付加価値サービスまでを提供するエキスパート集団です。
当社は様々な職種でメンバーを募集しています。
「オペレーション・エクセレンス」と「らしく働く、らしく生きる」を共に実現するカルチャー・しくみ・働き方にご興味がある方は、クラスメソッドオペレーションズ株式会社 コーポレートサイトをぜひご覧ください。
※2026年1月 アノテーション㈱から社名変更しました。

この記事をシェアする

関連記事