Slack

Slack 워크스페이스에 Teeem AI 연결

Teeem AI의 Slack 채널은 Socket Mode 기반으로 동작합니다. 외부 인바운드 포트가 필요 없어 보안 검토를 통과하기 쉽습니다.

​

설치 절차

1. Slack App 생성

   api.slack.com/apps → Create New App → From scratch. 앱 이름과 설치할 워크스페이스를 선택합니다.

2. 권한(Scope) 추가

   OAuth & Permissions → Bot Token Scopes에 다음을 추가합니다.

   Scope	용도
   chat:write	메시지 전송
   app_mentions:read	봇 멘션 수신
   im:history	DM 수신
   channels:history	공개 채널 메시지 수신
   groups:history	비공개 채널 메시지 수신 (초대된 경우만)
   users:read	사용자 프로필 조회
   files:read	첨부 파일 처리
   usergroups:read	사용자 그룹 동기화 (Phase C 기능)

3. Socket Mode 활성화

   Socket Mode → Enable Socket Mode 토글 → App-Level Tokens 생성 (connections:write 스코프). 생성된 xapp-... 토큰을 복사합니다.

4. 워크스페이스 설치

   Install App → 워크스페이스에 설치 → Bot User OAuth Token (xoxb-...) 복사.

5. Teeem AI 관리자 콘솔에 입력

   관리자 콘솔 → 설정 → 채널 → Slack → 두 토큰 입력 → 저장. 1분 내 연결 상태가 Active로 바뀝니다.

​

채널 정책

봇이 어떤 메시지에 응답할지 결정합니다.

mention

봇을 직접 멘션한 메시지에만 응답. 가장 안전한 기본값.

open

봇이 초대된 모든 채널의 모든 메시지에 응답. 전담 채널용.

allowlist

지정한 채널 ID 목록에서만 응답.

기본은 mention입니다. 관리자 콘솔에서 채널별로 /upload-on 명령어로 파일 업로드를 켜고 끌 수 있습니다.

​

스레드 컨텍스트

Teeem AI는 Slack의 스레드 단위로 대화 컨텍스트를 격리합니다. 채널의 새 메시지는 새 대화로 시작하고, 기존 스레드의 답글은 해당 스레드의 이력만 본다는 뜻입니다.

​

파일 공유

Slack 채널에 파일을 업로드하면 자동으로 지식 베이스 처리 큐에 들어갑니다.

• 처리 시작 시: 메시지에 처리 중 표시(reaction)가 붙습니다
• 완료 시: 인덱스 등록 완료 reaction으로 변경
• 큰 파일은 비동기 처리되며 완료 시 스레드에 알림이 옵니다

지원 형식 전체 목록은 파일 처리 참고.

​

Slack Lists 통합

Slack의 네이티브 Lists 기능을 Teeem AI 도구로 사용할 수 있습니다. 에이전트가 작업 리스트를 조회·수정할 수 있고, 새 항목 생성을 자연어로 지시할 수 있습니다.

@Teeem 이번 주 PRD 리뷰 작업을 #프로젝트관리 리스트에 추가해줘

​

DM (Direct Message)

봇 DM에서는 정책과 무관하게 모든 메시지에 응답합니다. 개인용 비서 모드처럼 사용할 수 있고, 같은 사용자의 OAuth 연결(Google, MS365 등)이 적용됩니다.

​

인용 (Citations)

지식 베이스에서 답변을 가져온 경우, 출처는 인라인이 아닌 영속 메시지로 별도 표시됩니다 (감사 추적이 용이하도록 설계). Slack에서는 답변 메시지 아래 작은 컨텍스트 블록으로, 웹챗에서는 인용 카드로 렌더링됩니다.