ブログに戻る
Guide

Slack APIのconversations.listでチャンネル一覧:プライベートが消える理由

conversations.listはパブリックチャンネルをすべて返しますが、プライベートチャンネルはボットが入っているものしか返しません。2026年10月2日にボットトークンとユーザートークンで実行し、それぞれが返したものをそのまま載せます。

Slack Green Team
November 20, 2026
November 22, 2026
5 分で読める
Share:
slack api
開発者
python

Slack APIでチャンネルを一覧するには、types=public_channel,private_channel を付けて conversations.list を呼び、response_metadata.next_cursor が空になるまでたどります(Slackのカーソルの動き)。ボットトークンには、パブリックチャンネル用に channels:read、プライベートチャンネル用に groups:read が必要です。ボットトークンはワークスペースのパブリックチャンネルをすべて返しますが、プライベートチャンネルはボットが追加されたものしか返しません。ユーザートークンは、そのユーザーが入っているプライベートチャンネルを返します。types=im にすると同じメソッドでDMを一覧でき、SlackですべてのDMを見るのテストで使いました。

2026年10月2日に、テスト用のワークスペースで試しました。パブリックチャンネルとプライベートチャンネルを2つずつ作り、テスト用アプリのボットをプライベートチャンネルの1つだけに追加して、同じインストールのボットトークンとユーザートークンで順に呼びました。

ボットトークンとユーザートークンが返したもの

呼び出しです。

curl -s https://slack.com/api/conversations.list \
  -H "Authorization: Bearer $SLACK_BOT_TOKEN" \
  -d types=public_channel,private_channel \
  -d exclude_archived=true \
  -d limit=200

ボットトークンは5つ、ユーザートークンは6つのチャンネルを返しました。

チャンネル種類ボットトークンユーザートークン
all-slackパブリック返った、is_member: false返った、is_member: true
socialパブリック返った、is_member: false返った、is_member: true
w2-pub-a-1002パブリック返った、is_member: false返った、is_member: true
w2-pub-b-1002パブリック返った、is_member: false返った、is_member: true
w2-priv-a-1002プライベート、ボットを追加済み返った、is_member: true返った、is_member: true
w2-priv-b-1002プライベート、ボットは未追加返らなかった返った、is_member: true

パブリックチャンネルは、ボットが入っていなくても見えます。ボットは4つのパブリックチャンネルのどれにも入っていませんが、4つとも返りました。プライベートチャンネルで効くのはメンバーかどうかだけです。ボットは groups:read を持っているのに、誰も追加していない w2-priv-b-1002 は返りませんでした。エラーも、チャンネルが抜けたというヒントも返りませんでした。

ボットに見えたプライベートチャンネルを、ボットトークンが返したままの形で載せます(空の項目は一部省きました)。

{
  "id": "C0C67CY2AV7",
  "name": "w2-priv-a-1002",
  "is_channel": true,
  "is_group": false,
  "is_private": true,
  "is_archived": false,
  "is_general": false,
  "creator": "U0B7L4YK420",
  "created": 1790903728,
  "is_member": true,
  "num_members": 2
}

num_members が2なのは、ボットも数えているからです。Slackのチャンネルの メンバー タブには1と出て、ボットは Agents & apps(エージェントとアプリ)の下に出ていました。

プライベートのテスト用チャンネルのチャンネル詳細。Agents and appsのタブに、チャンネルにいる唯一のアプリとしてテスト用のボットが出ている

プライベートチャンネルをボットに見せるには、ボットをそのチャンネルに追加します。チャンネルで /invite @your-bot と打つか、チャンネル詳細を開いて Add agents and apps を使います。ボットは自分で入れません。ボットが入っていないチャンネルでほかのメソッドを呼ぶと、not_in_channel か channel_not_found が返ります。直し方はnot_in_channelのページにあります。Argo CDの通知(英語)のように、チャンネル名を指定して投稿するデプロイのツールも、同じ招待が必要です。

typesなしではパブリックチャンネルしか返らない

types の初期値は public_channel です。同じボットトークンで types を付けずに呼ぶと、4つのパブリックチャンネルが返り、ボットが入っている w2-priv-a-1002 も抜けました。

all-slack, social, w2-pub-b-1002, w2-pub-a-1002

一覧にプライベートチャンネルがないときは、まずこの引数を確かめます。

返ってきたエラー

トークンにスコープのない種類を求めると、呼び出し全体が失敗します。ボットに channels:read と chat:write しかない2つ目のテスト用アプリで試しました。

{
  "ok": false,
  "error": "missing_scope",
  "needed": "groups:read",
  "provided": "channels:read,chat:write"
}

メインのテスト用ボットは groups:read を持っていましたが im:read はなく、types=im,mpim は同じように失敗しました。

{
  "ok": false,
  "error": "missing_scope",
  "needed": "im:read",
  "provided": "channels:read,groups:read,channels:history,groups:history,users:read,chat:write,channels:join,app_mentions:read,incoming-webhook"
}

直すには、needed に出たスコープを足してアプリを再インストールします。手順はmissing_scopeにあります。ボットが入っていないプライベートチャンネルについてconversations.infoに聞くと、{"ok": false, "error": "channel_not_found"} が返りました。ボットにとって、一度も追加されていないプライベートチャンネルは存在しないのと同じです。

Slackで「離席中」と表示されなくなります

クラウドベース。ダウンロード不要。ノートPCがオフでも24時間稼働。

アーカイブしたチャンネル

w2-pub-b-1002 をアーカイブして、もう一度一覧しました。初期値の exclude_archived=false では "is_archived": true 付きで返り、exclude_archived=true では消えました。両方の一覧が必要なら、自分のコードでこのフラグを見て分けます。

Pythonでチャンネル名からIDを得る

チャンネル名を受け取ってIDを返すメソッドはないので、一覧して照らし合わせます。ここでは slack_sdk を使います。レスポンスのオブジェクトをループで回すと、next_cursor のページ送りを代わりにやってくれます。

import os, sys
from slack_sdk import WebClient

client = WebClient(token=os.environ["SLACK_BOT_TOKEN"])

def channel_id(name):
    for page in client.conversations_list(types="public_channel,private_channel", limit=200):
        for ch in page["channels"]:
            if ch["name"] == name.lstrip("#"):
                return ch["id"], ch["is_private"], ch["is_member"]
    return None

for name in sys.argv[1:]:
    print(name, "->", channel_id(name))

ボットトークンでの出力です。

w2-pub-b-1002 -> ('C0C65A6CJSE', False, False)
#w2-priv-a-1002 -> ('C0C67CY2AV7', True, True)
w2-priv-b-1002 -> None
general -> None

w2-priv-b-1002 はありますが、ボットが入っていないので、ボットには None が返ります。存在しないチャンネルと同じ答えです。結果はキャッシュします。大きなワークスペースでは、1回調べるたびにチャンネルのページの数だけ呼び出しがかかり、Slackは conversations.list をTier 2、1分に約20回としています(SlackのAPIのレート制限を参照)。channel_id() の単体テストでは、記録したレスポンスを返すローカルのモックWeb APIで conversations.list に答えます。Boltのテストのガイドのやり方です。IDが1つ手で欲しいだけなら、代わりにチャンネル詳細で探します。

よくある質問

conversations.listはDMを返しますか? 初期設定では返しません。types=im か types=mpim を指定し、トークンに im:read か mpim:read が必要です。スコープがないと、上のとおり呼び出し全体が missing_scope で失敗します。グループDMは、できてから初めて一覧に出ます。ボットは conversations.open でグループDMを開きます。mpimのテストをご覧ください。

Always Active

マウスを動かす必要はもうありません。

何百人ものリモートワーカーがSlackのステータスを気にしなくなりました。一度設定すれば、永遠にグリーン。

関連記事

Guide

Slackのfiles.uploadの廃止:代わりの3ステップのアップロード

files.uploadは今はmethod_deprecatedを返します。files.getUploadURLExternalでURLを受け取り、バイトをPOSTし、files.completeUploadExternalで共有します。SDKならfiles_upload_v2です。curlとPythonで試し、エラーなしで失敗する2つのケースも確かめました。

Slack Green Team
Guide

Slackのボットトークン:xoxb-トークンの場所と、xoxbとxoxpの違いを検証

Slackのボットトークンは、アプリのOAuth & PermissionsページにあるBot User OAuth Tokenで、xoxb-で始まります。アプリをインストールすると表示されます。取得の手順、SLACK_BOT_TOKENでの読み込み、xoxpのユーザートークン、xappのアプリレベルトークン、xoxeのローテーション、xoxcのセッショントークンとの違いをまとめました。

Slack Green Team
Guide

Slackの文字色:文字に色は付けられないが、色が出るものは3つ

Slackには、メッセージにもcanvasにも文字色の設定がなく、APIも色のスタイルを受け付けません。2026年9月29日にすべての方法を試しました。カラーコードには色見本が付き、インラインコードは赤になり、アプリのメッセージには色付きの線を付けられます。

Slack Green Team