워크스페이스 생성 · 봇 설치
Slack에서 과정용 워크스페이스를 만들고, 이 페이지에서 KDT Setup Bot을 설치합니다. 이후 세팅은 아래 4단계 위저드로 진행합니다.
새 워크스페이스에 봇 설치하기
세팅 실행
컨트롤 페이지에서 바로 세팅 실행
Slack App Home 버튼에 경고 표시가 뜨는 경우에도 이 폼으로 같은 세팅 엔진을 실행할 수 있습니다. 먼저 새 워크스페이스에 봇 설치가 끝나 있어야 목록에 표시됩니다.
진행률
0%
아직 실행 전입니다.
기수 아카이브
이전 기수 설정 재사용
세팅 완료 후 자동 저장됩니다. 이 설정으로 시작하기를 클릭하면 과정 정보 폼이 자동으로 채워집니다.
워크스페이스를 선택하면 이전 기수 설정이 여기에 표시됩니다. 세팅 실행 완료 후 자동 저장되며, 다음 기수 진행 시 빠르게 불러올 수 있습니다.
훈련생 초대
슬랙에서 직접 초대
훈련생을 슬랙 워크스페이스에 초대합니다. 아래 버튼으로 슬랙 초대 화면을 열고 훈련생 이메일을 입력해 초대하세요 (여러 명을 쉼표로 한꺼번에 붙여넣을 수 있습니다). 초대 메일은 슬랙이 직접 발송하므로 별도 설정이 필요 없습니다.
🔗 슬랙 사용자 초대 화면 바로 열기 ↗
워크스페이스를 선택하면 해당 슬랙의 초대 화면 바로가기가 여기에 표시됩니다.
- 위 버튼으로 슬랙 초대 화면 열기 (또는 슬랙에서 워크스페이스명 → 설정 및 관리 → 멤버 초대)
- 훈련생 이메일을 입력하고 초대 — 슬랙이 초대 메일을 보냅니다
- 훈련생이 가입하면, 다음 세팅 실행 때 기본 채널에 자동 초대됩니다
💡 세팅을 실행하면 워크스페이스 전체 멤버가 기본 채널에 자동 초대되므로, 위 방법으로 훈련생을 워크스페이스에 들여보내기만 하면 됩니다.
✉️ 이메일 자동 초대 발송 준비 중
우리 시스템이 초대 이메일을 직접 발송하는 기능은 발송 도메인 인증 대기로 현재 비활성화되어 있습니다. 인증이 완료되면 아래에서 초대 링크 저장 → 메일 문구 편집 → 그룹별 일괄 발송을 쓸 수 있습니다. 그때까지는 위 슬랙에서 직접 초대를 이용하세요.
초대 링크 설정
슬랙에서 초대 링크를 복사해 붙여넣으면, (도메인 인증 후 제공될) 이메일 자동 발송에 사용됩니다. 다른 워크스페이스 링크와 헷갈리지 않도록, 실행할 때마다 슬랙에서 최신 링크를 다시 복사해 붙여넣고 저장해주세요 (혼동 방지를 위해 화면에 이전 값을 자동으로 채워넣지 않습니다).
🔗 슬랙 사용자 초대 화면 바로 열기 ↗
워크스페이스를 선택하면 해당 슬랙의 초대 화면 바로가기가 여기에 표시됩니다.
- 위 버튼으로 슬랙 초대 화면을 열고 초대 버튼 클릭 (또는 슬랙에서 워크스페이스명 → 설정 및 관리 → 멤버 초대)
- 초대 창 왼쪽 아래 🔗 초대 링크 복사 클릭
- 복사한
https://join.slack.com/t/...링크를 아래에 붙여넣고 저장
초대 메일 내용 수정 가능
훈련생·미가입 권한자에게 나가는 초대 메일의 제목·본문입니다. {{과정}}은 과정명으로 자동 치환되고,
초대 버튼·링크는 본문 아래에 자동으로 붙습니다(본문에 링크를 넣지 않아도 됩니다).
이메일 초대 발송
아직 워크스페이스에 가입하지 않은 훈련생에게 초대 링크를 이메일로 발송합니다. 그룹을 나누면 그룹마다 다른 채널을 지정할 수 있습니다 — 채널을 선택하면 가입(이미 멤버라면 다음 세팅 실행) 시 해당 채널에 자동 초대됩니다. 채널을 비워두면 워크스페이스 가입 초대만 발송됩니다.
운영자용 과정 세팅 흐름
새 과정 워크스페이스를 만들고 KDT Setup Bot을 설치한 뒤, Slack 안에서 과정 유형과 기본정보만 입력하면 채널, 공지, pin, bookmark, Canvas 탭 세팅을 자동 처리합니다.
워크스페이스 & 운영자
워크스페이스를 선택하고 권한자(운영자)를 저장합니다. 권한자는 멤버 ID 또는 이메일로 등록하며, 멤버 목록에서 클릭 한 번으로 추가할 수도 있습니다.
과정 정보
과정 대분류·세부 템플릿을 고르고 과정명, 개강·종강일, 훈련일수, 훈련시간, 담당 행정매니저 등 기본 정보를 입력합니다.
채널 · 콘텐츠 · 공지 미리보기
생성할 채널을 체크하고 자료 링크·파일을 넣은 뒤, 공지·캔버스를 서식이 보이는 편집기에서 확인·수정합니다. 미리보기 위 "공지별 게시 채널"에서 각 공지가 올라갈 채널도 지정할 수 있습니다.
최종 확인 · 실행
입력값을 최종 점검하고 세팅을 실행합니다. 결과 로그에서 채널·공지·고정·북마크·Canvas 탭·운영자 자동 초대까지 확인합니다.
과정 유형 안내
과정 유형과 세부 템플릿
과정 성격에 맞는 템플릿을 먼저 고르면, 해당 기준에 맞춰 채널과 기본 공지 세팅이 준비됩니다.
1. 대분류 선택
운영자가 먼저 과정의 큰 성격을 고릅니다.
일반 KDT 과정
장기 KDT 과정 기준. 주요공지, 데일리공지, 과정문의, 과제안내, 출결문의, 만족도조사 중심.
재직자 및 단기심화 과정
ICP, ICB, 로보틱스, AI 심화 등. 실제 과정별로 채널 구조가 달라 세부 템플릿을 함께 선택합니다.
2. 대분류별 세부 템플릿 선택
1번에서 고른 대분류 아래의 세부 템플릿만 선택합니다.
일반 KDT 과정
대분류 선택 후 이 안에서 고릅니다.
일반 KDT 기본형
장기 KDT 과정용 기본 채널 구성입니다. 채널명은 01부터 시작하는 두 자리 번호와 하이픈 기준으로 통일합니다.
재직자 및 단기심화 과정
재직자 과정인지, 단기심화형인지 한 번 더 고릅니다.
재직자형
재직자형
ICP, ICB 등 재직자 과정 공통 채널 구성입니다. 주요 공지, 데일리 공지, 운영/행정, 출석, 출결현황, 자리비움, 학습질문, 자료공유, 자유소통을 포함합니다.
단기심화형
단기심화형
로보틱스, AI 심화 등 단기심화 과정 공통 채널 구성입니다. 공지, 운영/행정, 출석, 정보공유, 학습질문, 만족도조사, 자유소통을 포함합니다.
추후 확장 예정
운영자가 직접 채널 구성, 공지 본문, 북마크, 캔버스를 저장해 재사용하는 사용자 맞춤형 템플릿 기능을 별도로 추가합니다.
실행 전 체크리스트
매 과정 실행 전 확인
과정 유형 선택
일반 KDT 과정인지, 재직자/단기심화 과정인지 먼저 선택합니다.
봇 설치/OAuth
각 워크스페이스에 KDT Setup Bot을 설치하고 App Home이 열리는지 봅니다.
권한자 등록
멤버 ID 또는 이메일로 등록합니다. 이미 멤버면 자동으로 ID로 저장되고, 미가입 이메일은 '예약 권한자'로 대기합니다 — 슬랙으로 직접 초대해 가입시키면 다음 실행 때 자동 승격됩니다(이메일 자동 발송은 도메인 인증 후 제공 예정).
채널/문구/링크 최종 확인
생성할 채널을 체크하고 담당 LX, 출결정정 Form 링크, 출석입력요청대장 파일을 확인합니다. 대장 파일을 비워두면 입력한 과정 정보로 양식이 자동 생성됩니다.
미가입 상태의 권한자는 채널 자동 초대만 잠시 보류될 뿐, 재등록할 필요는 없습니다. 그 사람이 가입한 뒤 다시 세팅을 실행하면 정식 권한자로 자동 승격되고 채널에도 초대됩니다.
재실행 시 기존 채널은 재사용하고, 공지·캔버스·북마크·토픽·첨부파일 중 바뀐 것만 제자리 갱신되어 중복 생성이 없습니다.
링크 배치 안내
각 링크가 배치되는 위치
세팅 실행 시 입력한 각 URL이 Slack 채널의 어느 위치에 배치되는지 확인합니다. 변경할 링크가 있으면 입력값을 수정한 뒤 다시 실행하면 제자리에 갱신됩니다.
링크 배치 위치 목록
| 항목 | 배치 위치 |
|---|---|
| 훈련생 행정 요청 대백과 | 필독 행정공지 Canvas 탭 |
| 훈련장려금 지급 가능 기준 | 필독 행정공지 Canvas 탭 종합시트(수정 금지) Canvas 탭 |
| 출석 인정 사유 및 제출 서류 | 필독 행정공지 Canvas 탭 종합시트(수정 금지) Canvas 탭 |
| 서류발급 요청 구글폼 | 필독 행정공지 Canvas 탭 종합시트(수정 금지) Canvas 탭 |
| KDT 출결정정 요청 구글폼 | 필독 행정공지 Canvas 탭 종합시트(수정 금지) Canvas 탭 출석/QR 채널 Bookmark |
| 출석입력요청대장 작성법 | 필독 행정공지 Canvas 탭 |
| 출석 ZOOM 스크린샷 | 종합시트(수정 금지) Canvas 탭 |
| 출석입력요청대장 양식 파일 | 운영 공지 메시지 스레드 필독 행정공지/종합시트 Canvas 탭 |
채널 북마크(고정 링크) 직접 관리하기
채널 상단에 이름을 붙인 고정 링크(북마크)를 걸 수 있습니다. 3단계(채널 · 콘텐츠) 화면의 "채널 북마크(고정 링크)" 항목에서 관리합니다.
- 추가: [+ 북마크 추가] → 채널 선택 → (선택)이모지 → 표시 이름 → 링크(
https://...) 입력 후 세팅 실행 - 링크·이모지 수정: 표시 이름은 그대로 두고 링크나 이모지만 바꿔 다시 실행하면 그 북마크가 제자리에서 갱신됩니다(중복 안 생김)
- 표시 이름 변경 시 주의 ⚠️: 도구는 북마크를 이름 기준으로 관리합니다. 이름 자체를 바꾸면 새 북마크가 추가되고 옛 이름 북마크는 그대로 남습니다. 이름을 바꾸려면, 값을 고쳐 실행한 뒤 옛 이름 북마크를 슬랙 채널에서 직접 삭제하세요
- 삭제: 화면에서 행을 지우면 다음 실행 대상에서 빠지지만, 이미 슬랙에 걸린 북마크는 그대로 남습니다. 실제로 없애려면 슬랙 채널에서 직접 삭제하세요(도구는 북마크를 임의로 지우지 않습니다)
참고 — 슬랙이 자동으로 보여주는 "링크" 목록과 다릅니다.
채널의 고정 항목 → 링크 탭에
docs.google.com처럼 도메인만 뜨는 것들은,
공지·캔버스 안에 들어있는 URL을 슬랙이 자동으로 모아 보여주는 것이라 그 이름은 슬랙이 대상 페이지에서 가져옵니다
(구글폼처럼 로그인이 필요한 링크는 제목을 못 가져와 도메인만 표시). 이 자동 목록의 이름은 도구로 바꿀 수 없습니다.
대신 위 "채널 북마크"로 이름을 직접 정한 고정 링크를 걸어 쓰시면 됩니다.
자동화 범위
자동 세팅 범위와 역할 분담
실제 채널을 생성하기 전에 아래 범위를 먼저 기준으로 삼습니다. 무료/일반 Slack에서는 워크스페이스 생성과 최초 앱 설치 승인은 사람이 진행하고, 그 이후 반복 세팅은 봇이 처리합니다. Slack 기본/전체 채널은 그대로 두고, 자동화는 별도의 01-주요-공지 채널부터 표준 채널을 생성합니다.
봇이 자동 처리
실행 버튼 이후 반복 업무
- 템플릿 기준 채널 생성 또는 기존 채널 재사용
- #01-주요-공지부터 표준 채널 실제 생성/재사용
- 채널 topic 설정
- 권한자와 실행자 채널 자동 초대
- 기본 채널에 현재 워크스페이스 전체 멤버 자동 초대(무료 플랜 지원)
- 운영/행정 공지 부모 메시지 게시, 상세 스레드 게시, 기존 메시지 업데이트
- 출석/문의/온보딩 공지 게시 또는 업데이트
- 주요 공지 pin
- 출결정정 Form bookmark 등록
- 주요 공지 채널의 종합시트(수정 금지) Canvas 탭 생성
- 운영/행정 채널의 훈련생 필독 행정공지 Canvas 탭 생성
- 출석입력요청대장 파일 미첨부 시 과정 정보로 양식 자동 생성·업로드
- 미가입 권한자가 가입하면 다음 실행 때 정식 권한자로 자동 승격
- 재실행 시 공지·캔버스·북마크·토픽·첨부파일 중 바뀐 것만 제자리 갱신
- 휴가계획서 포함 여부 판단 및 결과 로그 남김
운영자가 확인/입력
과정별 예외와 최종 기준
- 과정 대분류와 세부 템플릿 선택
- 이번 과정에 생성할 채널 체크
- 과정명, 회차, 약자, 개강일, 종강일, 훈련일수, 훈련시간 입력
- 훈련과정 담당 행정매니저 입력(출석입력요청대장 ④대장관리자에 자동 기입)
- 강사/리더명은 선택 입력. 미정이면 비워두고, 확정 후 공지 문구만 보완
- 훈련과정 담당 LX 입력
- 출결정정 Form과 과정별 자료 링크 입력, 출석입력요청대장/휴가신청서는 파일로 첨부(대장은 비워두면 자동 생성)
- 권한자 등록(멤버 목록에서 클릭 추가, 또는 ID·이메일 입력)
- 필요 시 훈련생을 슬랙으로 직접 초대(이메일 자동 발송은 도메인 인증 후 제공 예정)
추후 확장 예정
안정화 이후 단계적 확장
- 사용자 맞춤형 템플릿 저장/재사용
- 채널별 추가 Canvas 탭과 본문 구조화
- Google Sheets 대시보드 자동 체크
- Notion 원문 변경 자동 반영
다음 조율 순서
채널 생성 전 확정할 것
- 템플릿별 채널명과 채널 목적 확정
- 채널별 게시 공지 본문 확정
- pin 대상 메시지 확정
- bookmark 링크 위치 확정
- 테스트 워크스페이스에서 템플릿별 실행 검증
템플릿 채널 초안
템플릿별 생성 채널 초안
아래는 운영자가 검토하기 쉬운 한국어 기준 채널 초안입니다. 표준은 두 자리 번호 + 하이픈 + 한글 목적명이며, API 생성명은 같은 번호 체계의 영문 slug로 관리합니다. Slack 기본/전체 채널은 시스템 채널로 남겨두고, 표준 공지는 별도의 #01-주요-공지 채널에 게시합니다.
| 템플릿 | 한국어 기준 채널 초안 | 자동 게시 초안 |
|---|---|---|
| 일반 KDT 기본형 | # 01-주요-공지 # 02-데일리-공지 # 03-녹화본-업로드-공지 # 04-과정-문의 # 05-과제-안내 # 06-질의응답 # 07-출결문의 # 08-만족도조사 # 09-자유토크 | 주요 공지, 데일리 공지, 녹화본 안내, 과정/과제/Q&A/출결 문의 가이드, 만족도조사 안내 |
| 재직자형 | # 01-주요-공지 # 02-데일리-공지 # 03-운영-행정-문의 # 04-출석체크-QR코드 # 05-출결현황공유 # 06-자리비움 # 07-학습질문 # 08-인사이트-자료공유 # 09-자유소통 | 주요 공지, 데일리 공지, 운영/행정 문의 가이드, 출석체크 안내, 학습질문 이용 안내, 자유소통 안내 |
| 단기심화형 | # 01-주요-공지 # 02-데일리-공지 # 03-운영-행정-문의 # 04-출석체크-QR코드 # 05-정보공유 # 06-학습질문 # 07-만족도조사 # 08-자유소통 | 주요 공지, 데일리 공지, 운영/행정 문의 가이드, 출석체크 안내, 학습질문 이용 안내, 자유소통 안내 |
현재 채널명과 문구는 초안입니다. 운영자가 실행 모달에서 생성할 채널, 담당 LX, 출결정정 Form 링크, 첨부 파일을 최종 확인한 뒤 실행합니다.
커스터마이징 항목
현재 조작자가 바꿀 수 있는 항목
| 항목 | 조작자 입력 | 자동 반영 위치 |
|---|---|---|
| 공지 템플릿 | 일반 KDT 기본형 / 재직자형 / 단기심화형 | 채널 세트, 게시 위치, 기본 공지 문구, pin/bookmark/Canvas 기준 |
| 사용자 맞춤형 템플릿 | 추후 기능. 운영자가 직접 채널 구성과 공지 본문을 저장해 재사용 | 템플릿 표준 확정 이후 별도 관리 화면에서 반영 예정 |
| 과정 기본정보 | 과정명, 회차, 약자, 개강일, 종강일, 훈련일수, 훈련시간 | 채널명, 공지 제목, 휴가계획서 포함 여부, 자동 생성 출석입력요청대장의 훈련기간·훈련시간 |
| 훈련과정 담당 행정매니저 | 담당 행정M 이름 | 자동 생성 출석입력요청대장 양식의 ④대장관리자 항목에 기입 |
| 강사/리더 | 선택 입력. 미정이면 비워둠 | 현재 표준에서는 학습질문 채널을 통합 생성. 강사/리더명은 채널 생성 기준이 아니라 공지 문구 검토용으로만 사용 |
| 훈련과정 담당 LX | 담당 LX 이름. 미정이면 비워둠 | 운영 공지, 필독 행정공지의 승인/문의 안내 문구에 자동 반영 |
| 공지/자료 링크 | 출결정정 Form, 출석 ZOOM 스크린샷, 공지사항 종합시트 링크. 공통 행정 링크는 자동값 사용 | 공지 부모 메시지, 스레드 본문, 북마크, Canvas 탭 |
| 첨부 파일 | 출석입력요청대장 파일(비워두면 자동 생성), 휴가 발생 과정의 휴가신청서 파일 | 운영 공지 스레드에 실제 파일로 업로드 |
| 운영자 권한 | 멤버 목록에서 클릭 추가, 또는 멤버 ID·이메일 입력 | 실행 권한, 생성 채널 자동 초대. 미가입 이메일은 '예약 권한자'로 저장 → 슬랙 직접 초대로 가입 시 자동 승격 |
| 훈련생 초대 | 슬랙 초대 화면에서 이메일 입력해 초대 | 슬랙이 직접 초대 메일 발송, 가입 시 다음 실행 때 기본 채널 자동 초대 (우리 시스템의 이메일 자동 발송은 도메인 인증 후 제공 예정) |
| 채널 옵션 | 실행 모달에서 템플릿 채널별 생성 여부를 체크박스로 선택 | 이번 과정에 필요한 채널만 생성하고, 선택된 채널에만 공지/pin/bookmark/Canvas 반영 |
운영자 링크
운영자가 자주 쓰는 링크
1. 새 워크스페이스 만들기
Slack에서 과정용 워크스페이스를 먼저 생성합니다. 생성 후 Slack 왼쪽 아이콘 목록에 보이면 다음 단계로 갑니다.
워크스페이스 생성
2. KDT Setup Bot 설치
위의 설치 대상 워크스페이스 확인에 방금 만든 워크스페이스 URL 또는 이름을 먼저 입력한 뒤 설치합니다.
Slack 승인 화면의 Workspace가 다르면 허용하지 않습니다.
봇 설치 시작
3. 세팅 실행
이 페이지의 실행 폼에서 방금 설치한 워크스페이스를 선택하고 과정 유형, 생성할 채널, 과정명, 회차, 링크를 확인하고 실행합니다.
봇 서버 상태 확인
시스템 관리자용 연결 정보
아래 주소는 일반 운영자가 매번 볼 필요가 없습니다. Slack 앱을 처음 만들거나 봇 서버 주소가 바뀌었을 때만 시스템 관리자가 확인합니다.
OAuth Redirect URL
Slack 설치 승인 후 돌아오는 주소입니다.
Request URL
Slack 버튼, 명령어, App Home 이벤트가 도착하는 주소입니다.
운영 링크 설정
공통 행정 링크 관리
자주 바뀌는 URL을 여기서 저장하면 이후 세팅 실행 시 자동으로 반영됩니다. 비워두면 기존 기본값이 그대로 사용됩니다.
현재 연결 설정
- 봇 백엔드
- Slack App ID
- 설치 URL
- 관리 링크
- Slack 앱 관리 화면 열기
- 운영 원칙
- 이 페이지에는 토큰을 저장하지 않습니다. Slack 권한 작업은 봇 백엔드와 Slack OAuth 승인 이후에만 실행됩니다.