🔔 슬랙 연동 설정 (워크스페이스·채널)
파트너포털의 슬랙 연동은 프로젝트에서 일어나는 활동(파일 업로드·댓글·승인·회의·멘션 등)을 지정한 슬랙 채널로 실시간 전송하는 알림 다리입니다. 프로젝트마다 알림을 받을 채널을 한 번 매핑해 두면, 담당자가 포털을 열어 두지 않아도 슬랙에서 진행 상황을 바로 파악할 수 있습니다.
이 문서는 연동의 첫 단계인 "워크스페이스·채널 연결 설정" 을 다룹니다. 슬랙에서 곧바로 업무를 입력하거나 대화를 요약해 포털로 보내는 기능, 자동 매핑에 실패한 업무를 처리하는 수신함은 별도 문서에서 안내합니다.
💡 진입 경로: 프로젝트 상세 화면 우측 상단 [설정] > 슬랙 알림 설정.
이 문서에서 다루는 내용
- 슬랙 연동 전체 그림
- 사전 준비 - 채널과 봇 초대
- 프로젝트에 슬랙 채널 연결하기 (4단계)
- 채널 ID 찾는 법
- 연결 테스트와 현재 설정 확인
- 슬랙으로 전송되는 알림 종류 (요약)
- 설정 권한과 환경별 동작
- 문제 해결 & 자주 묻는 질문
1. 슬랙 연동 전체 그림
슬랙 알림 연동은 프로젝트별로 채널을 매핑하는 방식입니다. 채널이 매핑된 프로젝트에서 활동이 일어나면, 그 활동 알림이 매핑된 채널로 자동 전송됩니다.
프로젝트에서 일어난 활동(파일 업로드 · 댓글 · 승인/반려 · 회의 · 멘션)이 매핑된 슬랙 채널로 전달됩니다.
⚠️ 채널 매핑이 없는 프로젝트는 알림이 나가지 않습니다. 프로젝트마다 따로 설정해야 합니다.
| 구성 요소 | 역할 |
|---|---|
| 슬랙 채널 | 프로젝트 알림을 받을 대상 채널 |
| 프로젝트 관리 봇 | 채널에 메시지를 보내는 주체(채널에 초대되어 있어야 함) |
| 채널 매핑 | 프로젝트 ↔ 채널 ID 연결(프로젝트 설정에서 저장) |
💡 봇의 표시 이름은 슬랙 워크스페이스에 봇을 설치할 때 정해지므로 워크스페이스마다 다를 수 있습니다. 제품 안의 설정 가이드에서는 이를 "프로젝트 관리 봇" 으로 안내합니다.
💡 연결은 프로젝트당 채널 1개 기준입니다. 채널을 지정하지 않은 프로젝트의 활동은 슬랙으로 전송되지 않습니다(누락이 아니라 의도된 동작).
2. 사전 준비: 채널과 봇 초대
연결을 시작하기 전에 슬랙 워크스페이스에서 두 가지를 준비합니다.
| 준비물 | 내용 | 비고 |
|---|---|---|
| 전용 채널 | 프로젝트 알림을 받을 채널(신규 또는 기존) | 채널 1개 = 프로젝트 1개 매핑 권장 |
| 봇 초대 | 해당 채널에 프로젝트 관리 봇을 초대 | 초대하지 않으면 알림이 전송되지 않습니다 |
2.1 봇 초대 방법
대상 채널의 메시지 입력창에 아래를 입력합니다.
/invite @(프로젝트 관리 봇 이름)⚠️ 봇이 채널에 없으면 채널 저장 자체가 거부됩니다. 저장 시 시스템이 해당 채널로 연결 확인 메시지를 실제로 한 번 전송해 보기 때문에, 봇이 채널에 없으면 전송이 실패하고 설정이 저장되지 않습니다. 봇 초대를 가장 먼저 끝내 두세요.
3. 프로젝트에 슬랙 채널 연결하기 (4단계)
프로젝트 활동 알림은 프로젝트마다 따로 채널을 지정합니다.
3.1 설정 모달 열기
프로젝트 상세 화면 우측 상단의 [⚙ 설정 ▾] 메뉴에서 슬랙 알림 설정을 고릅니다. 같은 메뉴에 담당자 변경도 함께 있습니다.
- 프로젝트 상세 화면 우측 상단 [설정] 버튼을 클릭합니다.
- 드롭다운에서 [슬랙 알림 설정] 을 선택합니다.
- 슬랙 알림 설정 창이 열립니다.
3.2 채널 ID 입력 & 저장
| 입력 항목 | 내용 |
|---|---|
| 슬랙 채널 ID | 알림을 받을 채널의 ID |
| 저장 | 설정을 적용합니다 |
설정을 마치면 그 프로젝트의 활동이 해당 채널로 전달됩니다.
| 단계 | 동작 | 결과 |
|---|---|---|
| 1 | 슬랙에서 채널 생성·선정 | 알림을 모을 채널 확보 |
| 2 | 해당 채널에 봇 초대 | 전송 권한 확보 |
| 3 | 채널 ID 복사 (C로 시작) | 4장 참고 |
| 4 | 입력창에 붙여넣고 [저장] | 연동 완료 |
💡 입력 형식 검사가 동작합니다. 채널 ID는 알파벳 C로 시작하고 10자 이상이어야 합니다(예: `C1234567890`). 형식이 맞지 않으면 저장되지 않습니다.
⚠️ 저장 버튼을 누르면 시스템이 해당 채널로 연결 확인 메시지를 한 번 실제 전송해 전송 가능 여부를 검증합니다. 전송에 성공해야 채널이 저장됩니다. 봇이 채널에 없거나 채널 ID가 잘못되면 저장이 거부됩니다.
4. 채널 ID 찾는 법
채널 ID는 채널 이름(#)이 아니라 `C`로 시작하는 고유 식별자입니다.
슬랙 채널 ID는 채널명을 클릭하거나 ⋯ → 채널 세부정보를 열면 하단에 표시됩니다. 이 값을 복사해 포털의 슬랙 알림 설정에 붙여 넣습니다.
| 단계 | 동작 |
|---|---|
| 1 | 슬랙 채널 상단의 채널 이름 또는 [⋯ 더보기] 클릭 |
| 2 | [채널 세부정보 열기] 선택 |
| 3 | 세부정보 맨 아래의 채널 ID (C로 시작) 복사 |
💡 채널 이름은 언제든 바뀔 수 있지만 채널 ID는 고정입니다. 그래서 연동은 이름이 아니라 ID 기준으로 동작합니다.
5. 연결 테스트와 현재 설정 확인
5.1 테스트 메시지 보내기
채널이 한 번 저장되면 설정 창 하단에 [테스트] 버튼이 나타납니다. 누르면 해당 채널로 테스트 메시지가 즉시 발송됩니다. [테스트] 버튼은 설정 메뉴가 보이는 사용자(아래 7.1 참고)가 이미 채널이 매핑된 프로젝트의 설정 창을 열었을 때만 나타납니다.
🧪 테스트 메시지
프로젝트: 예시기업 리브랜딩 프로젝트
시간: 2026-06-06 14:20:11
슬랙 알림 연동이 정상적으로 작동하고 있습니다!
| 결과 | 의미 | 조치 |
|---|---|---|
| 채널에 메시지 도착 | 연동 정상 | 추가 작업 없음 |
| "전송 실패" 안내 | 봇 미초대 또는 잘못된 채널 ID | 봇 초대 확인 → 채널 ID 재확인 |
5.2 현재 설정된 채널 확인
채널이 매핑된 프로젝트는 설정 창에 "✅ 현재 설정된 채널: C…" 가 표시됩니다. 다른 채널로 옮기려면 새 채널 ID를 입력하고 다시 저장하면 됩니다. 새 ID로 저장하면 이전 채널을 대체합니다(프로젝트당 알림 채널은 하나).
6. 슬랙으로 전송되는 알림 종류 (요약)
채널이 매핑된 프로젝트에서 아래 활동이 일어나면 자동으로 슬랙 메시지가 전송됩니다. 모든 알림에는 해당 프로젝트로 바로 가는 링크가 포함됩니다.
| 알림 | 트리거 | 메시지에 담기는 정보 |
|---|---|---|
| 📎 파일 업로드 | 새 파일 업로드 | 프로젝트 · 파일명 · 업로드자 |
| 💬 새 댓글 | 댓글 작성 | 프로젝트 · 작성자 · 내용 |
| 📅 회의 | 회의 요청·수정·삭제 | 프로젝트 · 회의명 · 요청자(새 회의) 또는 작업자(수정·삭제) |
| 🔍 승인 요청 | 파일 승인 요청 | 프로젝트 · 파일명 · 요청자 |
| ✅ 승인 완료 | 파일 승인 | 프로젝트 · 파일명 · 승인자 |
| ❌ 반려 | 파일 반려 | 프로젝트 · 파일명 · 반려자 |
| 🗑️ 파일 삭제 | 파일 삭제 | 프로젝트 · 파일명 · 삭제자 |
| 📢 멘션 | 파일 댓글에서 @멘션 | 프로젝트 · 파일 · 멘션 대상 · 작성자 · 내용 |
📎 파일 업로드 알림
프로젝트: 예시기업 리브랜딩 프로젝트
파일: 1차_시안_v2.pdf
업로드자: 라온 디자이너
👉 프로젝트 확인하기 링크가 함께 붙습니다.
💡 프로젝트 채널은 그 프로젝트 전용입니다. 영업·리드 관련 알림(CRM)은 별도 채널로 분리되어 있어, 프로젝트 채널에 영업 알림이 섞이지 않습니다.
7. 설정 권한과 환경별 동작
7.1 누가 채널을 설정할 수 있나
권한은 두 층으로 나뉩니다. ① 설정 메뉴(드롭다운의 [슬랙 알림 설정])가 화면에 보이는지(UI 노출), ② 저장·테스트 요청이 실제로 처리되는지(API 권한). 이 둘이 항상 일치하지는 않으므로 표로 구분합니다.
| 동작 | 적용 조건 |
|---|---|
| [설정] > [슬랙 알림 설정] 메뉴 노출 | 팀장 · 슈퍼관리자 · 기획 그룹 팀원 |
| 채널 ID 저장(연결/변경) - 요청 처리 | 관리자 · 슈퍼관리자 |
| 테스트 메시지 전송 - 요청 처리 | 슈퍼관리자 · 관리자 · 팀장 · 팀원 |
⚠️ 메뉴 노출 조건과 저장 권한이 어긋나는 경우가 있습니다.
- 팀장은 설정 메뉴는 보이지만 채널 ID 저장은 거부됩니다(저장은 관리자·슈퍼관리자만). 팀장은 이미 매핑된 채널에서 [테스트]까지만 가능합니다.
- 관리자 역할은 저장 권한은 있지만 위 노출 조건에 들지 않아 설정 메뉴 자체가 보이지 않을 수 있습니다. 이때는 메뉴가 보이는 슈퍼관리자가 저장을 진행하면 됩니다.
- 일반 팀원(기획 그룹 외)은 설정 메뉴가 보이지 않아 테스트 버튼에 도달할 수 없습니다.
7.2 환경별 전송
슬랙 발송에는 두 가지 조건이 모두 필요합니다.
| 조건 | 동작 |
|---|---|
| 환경 게이트 | 운영 환경(`APP_ENV=prod`)은 기본 전송. 데모·로컬은 `INTEG_SLACK=true`로 켜야만 전송(기본 비전송) |
| 봇 토큰 | `SLACK_API_TOKEN` 또는 `SLACK_BOT_TOKEN`이 설정되어 있어야 함. 미설정 시 모든 알림이 조용히 무시됨 |
💡 데모 환경에서 테스트 메시지가 가지 않는 것은 정상입니다(게이트가 꺼져 있음). 실제 알림은 운영 환경에서 동작합니다.
⚠️ 봇 토큰이 아예 설정되지 않은 환경에서는 저장 시 보내는 연결 확인 메시지도 전송되지 않아 채널 저장 자체가 거부됩니다. 저장이 계속 실패하면 운영 환경(또는 토큰이 설정된 환경)인지 먼저 확인하세요.
8. 문제 해결 & 자주 묻는 질문
자주 묻는 증상
| 증상 | 원인 | 해결 |
|---|---|---|
| 저장이 안 됨 / 형식 오류 | 채널 ID 형식 불일치 | `C`로 시작하는 10자 이상 ID인지 확인 |
| 저장 시 "전송 불가" | 봇이 채널에 없음 | 채널에서 봇 초대 후 재저장 |
| 알림이 아예 안 옴 | 채널 미매핑 또는 봇 토큰 미설정 환경 | 프로젝트 설정에서 채널 지정 / 운영 환경 여부 확인 |
| 설정 메뉴가 안 보임 | 메뉴 노출 대상 아님(팀장·슈퍼관리자·기획 그룹 팀원만 노출) | 7.1 참고 - 슈퍼관리자에게 설정 요청 |
| 메뉴는 보이는데 저장이 거부됨 | 팀장 역할(저장은 관리자·슈퍼관리자만) | 관리자·슈퍼관리자에게 저장 요청 |
자주 묻는 질문
Q. 채널 이름을 입력하면 안 되나요?
채널 이름(#)이 아니라 `C`로 시작하는 채널 ID를 입력해야 합니다. 이름은 바뀔 수 있어 ID로 연동합니다.
Q. 한 프로젝트에 여러 채널을 연결할 수 있나요?
프로젝트당 알림 채널은 하나입니다. 새 채널 ID로 저장하면 이전 채널을 대체합니다.
Q. 채널 ID를 저장했는데 메시지가 안 와요.
대부분 봇 미초대 때문입니다. 대상 채널에서 봇을 초대한 뒤 설정 창의 [테스트] 버튼으로 확인하세요.
Q. 저장할 때 채널에 "연결 테스트" 메시지가 떴어요.
정상입니다. 저장 시 시스템이 실제 전송 가능 여부를 확인하기 위해 채널로 확인 메시지를 한 번 보냅니다. 이 메시지가 도착하면 연동이 성공한 것입니다.
Q. 슬랙에서 업무를 입력하거나 대화를 요약하는 기능은 어디서 설정하나요?
그 기능은 채널 연결과 별개로 동작합니다. 슬랙 명령어로 업무를 입력·요약하고, 자동 매핑에 실패한 업무를 처리하는 방법은 슬랙 명령어·수신함 문서를 참고하세요.