Slack

Slack 쪽 준비링크 복사

1. api.slack.com/apps에서 Create New App → From a manifest를 고릅니다. 매니페스트 JSON은 콘솔 연결 설정 화면에서 복사합니다.
2. 앱을 워크스페이스에 설치합니다(OAuth & Permissions → Install to Workspace).
3. Bot User OAuth Token(xoxb-로 시작)을 복사합니다.

매니페스트는 채널 목록, 대화 기록, 사용자 이름, 첨부 파일 정보 읽기와 공개 채널 참여 권한만 요청합니다. 메시지 전송 권한은 없습니다. 첨부 파일 정보 권한(files:read)은 AI에게 첨부 파일 주소를 알려 줄 때만 씁니다. 같은 권한을 가진 기존 앱의 봇 토큰을 써도 됩니다. 권한을 바꾸면 앱을 다시 설치(Reinstall)해야 새 토큰에 반영됩니다.

연결 설정링크 복사

토큰을 확인하면 워크스페이스, 앱 이름, 채널 목록이 나타납니다. 조회할 채널을 최대 200개까지 고릅니다. 고르지 않으면 앱이 볼 수 있는 모든 채널이 대상입니다.

• 공개 채널: 앱이 참여하지 않은 채널도 고를 수 있습니다. 저장할 때 Gate가 앱을 그 채널에 참여시키고, 채널에 참여 메시지가 한 번 남습니다.
• 비공개 채널: Slack에서 /invite @앱이름으로 앱을 먼저 초대해야 목록에 나타납니다.
• DM: 읽지 않습니다.
• 시간대: 기본값은 Asia/Seoul입니다. 메시지 시각과 날짜 조건을 이 시간대로 해석합니다.

조회 범위링크 복사

• 채널과 기간을 지정해 최신순으로 읽습니다. 스레드를 지정하면 원글부터 답글을 순서대로 읽습니다.
• 키워드 검색은 없습니다. Slack 검색 API는 사람 계정 토큰에만 열려 있고, Gate는 앱 토큰만 씁니다. AI가 채널과 기간으로 범위를 좁혀 읽은 뒤 내용을 찾습니다.
• 메시지 전송, 수정, 삭제는 하지 않습니다.

첨부 파일링크 복사

대화를 읽으면 메시지마다 첨부 파일의 ID, 이름, 형식, 크기가 함께 옵니다. AI가 파일 내용이 필요하면 Gate에 그 파일의 원본 주소를 요청합니다.

• Gate는 파일을 내려받거나 중계하지 않습니다. Slack 원본 주소만 알려 줍니다.
• 주소는 Slack 토큰이 있어야 열립니다. AI 쪽에서 files:read 권한과 해당 채널 참여 권한이 있는 자기 Slack 앱 토큰으로 직접 받아야 합니다. 그런 토큰이 없는 AI 도구는 파일 내용을 받을 수 없습니다.
• 감사 기록에는 주소를 알려 준 사실만 남습니다. 실제로 내려받았는지는 남지 않습니다.
• 외부 링크 파일과 Slack 요금제의 보관 기간이 지난 파일은 주소를 알려 주지 않습니다.