Slack APIのconversations.listでチャンネル一覧:プライベートが消える理由
conversations.listはパブリックチャンネルをすべて返しますが、プライベートチャンネルはボットが入っているものしか返しません。2026年10月2日にボットトークンとユーザートークンで実行し、それぞれが返したものをそのまま載せます。
On this page
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(エージェントとアプリ)の下に出ていました。
プライベートチャンネルをボットに見せるには、ボットをそのチャンネルに追加します。チャンネルで /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"} が返りました。ボットにとって、一度も追加されていないプライベートチャンネルは存在しないのと同じです。
アーカイブしたチャンネル
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のテストをご覧ください。
関連記事
Slackのfiles.uploadの廃止:代わりの3ステップのアップロード
files.uploadは今はmethod_deprecatedを返します。files.getUploadURLExternalでURLを受け取り、バイトをPOSTし、files.completeUploadExternalで共有します。SDKならfiles_upload_v2です。curlとPythonで試し、エラーなしで失敗する2つのケースも確かめました。
Slackのボットトークン:xoxb-トークンの場所と、xoxbとxoxpの違いを検証
Slackのボットトークンは、アプリのOAuth & PermissionsページにあるBot User OAuth Tokenで、xoxb-で始まります。アプリをインストールすると表示されます。取得の手順、SLACK_BOT_TOKENでの読み込み、xoxpのユーザートークン、xappのアプリレベルトークン、xoxeのローテーション、xoxcのセッショントークンとの違いをまとめました。
Slackの文字色:文字に色は付けられないが、色が出るものは3つ
Slackには、メッセージにもcanvasにも文字色の設定がなく、APIも色のスタイルを受け付けません。2026年9月29日にすべての方法を試しました。カラーコードには色見本が付き、インラインコードは赤になり、アプリのメッセージには色付きの線を付けられます。