블로그로 돌아가기
Guide

Slack API conversations.list로 채널 목록 받기: 비공개 채널이 빠지는 이유

conversations.list는 공개 채널을 모두 돌려주지만 비공개 채널은 봇이 들어 있는 것만 돌려줍니다. 2026년 10월 2일 봇 토큰과 사용자 토큰으로 실행해 각각 돌려준 내용을 그대로 실었습니다.

Slack Green Team
November 20, 2026
November 22, 2026
4 분 읽기
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일 테스트 워크스페이스에서 시험했습니다. 공개 채널과 비공개 채널을 두 개씩 만들고, 테스트 앱의 봇을 비공개 채널 하나에만 추가한 뒤, 같은 설치의 봇 토큰과 사용자 토큰으로 차례로 불렀습니다.

봇 토큰과 사용자 토큰이 돌려준 것

호출입니다.

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

공개 채널은 봇이 들어 있지 않아도 보입니다. 봇은 공개 채널 네 개 중 어디에도 없었지만 네 개 모두 나왔습니다. 비공개 채널은 멤버인지만 따집니다. 봇에게 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만 있는 두 번째 테스트 앱으로 시험했습니다.

{
  "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에서 다시는 '자리 비움'으로 표시되지 마세요

클라우드 기반. 다운로드 불필요. 노트북이 꺼져 있어도 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이 돌아옵니다. 없는 채널과 같은 답입니다. 결과는 캐시하세요. 큰 워크스페이스에서는 한 번 찾을 때마다 채널 페이지 수만큼 호출이 들고, Slack은 conversations.list를 Tier 2, 분당 약 20회로 정합니다(Slack API 속도 제한 참고). channel_id()를 단위 테스트하려면, 기록한 응답을 돌려주는 로컬 모의 Web API로 conversations.list에 답하세요. Bolt 테스트 가이드의 방법입니다. 손으로 ID 하나만 필요하다면 대신 채널 세부 정보에서 찾으세요.

자주 묻는 질문

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으로 시험했고, 오류 없이 실패하는 두 경우도 확인했습니다.

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에는 메시지에도 캔버스에도 글자 색 옵션이 없고, API도 색 스타일을 받지 않습니다. 2026년 9월 29일 모든 방법을 시험했습니다. 색상 코드에는 색 견본이 붙고, 인라인 코드는 빨간색이며, 앱 메시지에는 색 막대를 붙일 수 있습니다.

Slack Green Team