【Slack】Bot投稿の表示名が一部メンバーだけ使えない時の監査ログで原因を追う方法

SlackでBotを導入していると、Botからのメッセージの表示名(Botの名前)が一部のメンバーにのみ正しく表示されず、デフォルトの「bot」と表示されたり、ユーザー名がそのまま表示されるケースがあります。この問題は、Botのスコープ設定やインストール状態、権限の変更が原因であることが多く、ワークスペース全体でなく一部のメンバーに限定されるため、原因の特定が難しい場合があります。特に大規模なワークスペースでは、管理者が監査ログを活用することで、いつ、誰が、どのような変更を行ったのかを正確に追跡できます。本記事では、Slackの監査ログを使ってBot表示名の問題の原因を特定し、適切な対応を取る方法を解説します。具体的なログの見方や、よくある失敗パターンも紹介します。

Bot表示名が一部メンバーだけ使えない原因の概要

Slackでは、Botの表示名は「Appの基本情報」で設定された名前がデフォルトで使われます。しかし、以下のような状況で一部のメンバーにだけ異なる表示になることがあります。

• アプリのインストール状態の差異: 一部のメンバーが個人でBotアプリをインストール(またはアンインストール)している場合、そのメンバーだけ表示名が変わることがあります。特に「ユーザートークンを使った認証」を行っているBotでは、個別インストールの有無が影響します。
• 権限スコープの未承認: Botが特定のスコープ(例:chat:write.customize)を要求している場合、各メンバーがそのスコープを承認していないと、Botの表示名やアイコンをカスタマイズする権限が不足します。このスコープが未承認のメンバーには、デフォルトの表示名だけが使われます。
• チャンネルへの参加状態: Botがメッセージを投稿するチャンネルに、メンバーが参加していない場合、表示名の変更が反映されないことがあります。ただし、これは表示名の問題というより、Botからのメッセージがそもそも見えない状態です。
• カスタム統合の設定: レガシーなカスタム統合(Incoming Webhookなど)を使っている場合、Webhook URLごとに表示名が設定でき、一部のメンバーだけが異なる表示名を見ることがあります。

監査ログで確認すべきポイント

Slackの監査ログでは、ワークスペース内のさまざまなイベントが記録されています。Bot表示名の問題に関連して、以下のイベントを重点的に確認します。

イベント名	意味	問題との関連
app_installed	ワークスペースまたはユーザーがアプリをインストールした	インストール後にスコープが変わった可能性
app_uninstalled	アプリがアンインストールされた	アンインストールされたユーザーで表示名が使えなくなる
app_scope_denied	ユーザーがアプリのスコープ要求を拒否した	拒否したユーザーではカスタマイズ権限が不足
user_scope_added	ユーザーがスコープを承認した	承認後に正常表示に戻るか確認
member_joined_channel	メンバーがチャンネルに参加した	参加直後に表示名が変わる場合あり

これらのイベントに加えて、タイムスタンプと実行したユーザーの情報(IPアドレス、メールアドレス)も記録されます。問題が報告された日時から逆算して、該当メンバーのログを絞り込みます。

監査ログの取得手順

監査ログを確認するには、ワークスペースのオーナーまたは管理者権限が必要です。以下の手順でログをエクスポートまたはブラウザで確認できます。

1. Slack管理画面(https://[ワークスペース名].slack.com/admin)にアクセスし、「設定」→「監査ログ」をクリックします。
2. 監査ログページで、日付範囲を指定します。問題が発生したと思われる期間を前後数日含めて広めに設定します。
3. 「フィルター」ボタンをクリックし、イベントタイプを「アプリ」に絞ります。さらに、必要に応じてユーザー(問題のメンバー)を指定します。
4. 表示されたログのリストから、上記のイベント名(app_installed, app_uninstalled, app_scope_deniedなど)を探します。
5. 該当イベントをクリックすると詳細が表示されるので、その中で「scope」フィールドを確認します。chat:write.customize の有無をチェックします。
6. 必要に応じて「エクスポート」ボタンからCSVファイルをダウンロードし、Excelなどで詳細分析します。

失敗パターンと注意点

監査ログを使った原因追跡では、以下のような失敗パターンに陥りやすいため注意が必要です。

• ログの保存期間を超えている: 無料版のSlackでは監査ログは利用できません。有料プランでもStandardプランでは30日間、Business+プランでは90日間、Enterprise Gridでは1年間保存されます。問題が発生した日から時間が経過しているとログが消えている可能性があります。
• イベント名を見落とす: 関連イベントは複数種類あり、「app_scope_denied」や「user_scope_added」は特に見落としがちです。必ず全文検索やフィルタリングを活用しましょう。
• ユーザー単位のログとワークスペース単位のログを混同する: ワークスペース全体に影響するイベント(app_installed)と、個別ユーザーにのみ影響するイベント(app_scope_denied)を区別しないと、原因を誤認します。問題が一部メンバーだけなら、ユーザー単位のイベントを優先的に確認します。
• タイムゾーンの誤り: 監査ログのタイムスタンプはUTCで記録されます。日本時間(JST)で考えていると、イベントの発生時刻を誤解する可能性があるので注意してください。

実際の原因特定例(ケーススタディ)

例えば、営業部のメンバーAさんだけBotの表示名が「bot」と表示され、他のメンバーは正しい名前「通知Bot」と表示されるケースを考えます。監査ログを確認すると、Aさんのユーザーに対して「app_scope_denied」イベントが記録されていました。詳細を見ると、拒否されたスコープは「chat:write.customize」でした。これは、以前Botが表示名のカスタマイズを求めるダイアログを表示した際に、Aさんが「許可しない」を選択したことを示しています。この場合、Aさんに再度スコープの承認を促すか、Bot側でスコープを必須にしない設定に変更する必要があります。

他の可能性との比較

状況	監査ログで確認すべきイベント	対応方法
特定ユーザーだけ表示名が異なる	app_scope_denied または app_uninstalled(ユーザートークン関連)	該当ユーザーにスコープ再承認を依頼、またはBotの再インストールを促す
すべてのメンバーで表示名が変わった	app_installed(ワークスペース全体)や app_updated	Botの設定変更を確認し、表示名を再設定する
特定チャンネルだけ表示名が異なる	なし(チャンネル固有の設定は監査ログに記録されない)	チャンネルのアプリ設定や統合を確認する

管理者へ確認すべき情報

問題を管理者に報告する際には、以下の情報をまとめておくとスムーズです。

• 問題が発生しているBotのApp ID(Slack API管理画面で確認)
• 問題が発生しているメンバーのユーザー名とメールアドレス
• 問題発生日時(日本時間とUTC両方)
• 正常に表示されているメンバーの例
• 監査ログのスクリーンショット(特にapp_scope_deniedの詳細)

これらの情報を元に、管理者はBotの設定変更やユーザーへの個別対応を判断できます。

よくある質問

Q1: 監査ログに「app_scope_denied」がないのに問題が発生するのはなぜですか?

A: ユーザーがスコープを承認しなかったイベントが記録されない場合もあります。特に、Botが「ユーザートークン」を使わず「ボットトークン」のみを使っている場合、個別のスコープ承認は発生しません。その場合は、アプリのインストール状態やチャンネル参加状態を確認してください。

Q2: 表示名の問題は監査ログだけでは解決できない場合、どうすればいいですか?

A: 監査ログで原因が特定できない場合は、SlackのAPI管理画面でアプリの権限スコープを確認し、必要に応じて再インストールを試みてください。それでも解決しない場合、Slackサポートに問い合わせることをおすすめします。

Q3: 一般メンバーでも監査ログを確認できますか?

A: いいえ、監査ログはワークスペースのオーナーまたは管理者のみ閲覧できます。一般メンバーは「設定」メニューに監査ログの項目が表示されません。問題を管理者に報告してください。

まとめ

Bot投稿の表示名が一部メンバーだけ使えない問題は、多くの場合、権限スコープの未承認やアプリの個別インストール状態が原因です。監査ログを活用することで、いつ、どのユーザーが、どのスコープを拒否したのかを正確に特定できます。問題が発生したら、まず該当メンバーの「app_scope_denied」イベントを確認し、続いて「app_installed」「app_uninstalled」をチェックしてください。ログが残っていない場合や原因が不明な場合は、管理者にアプリの権限設定の見直しを依頼しましょう。監査ログはトラブルシューティングの強力なツールですが、保存期間やアクセス権限に注意する必要があります。