🤯 슬랙 봇 개발, 왜 항상 삽질이었을까?
슬랙 앱 하나 만들려고 OAuth 플로우부터 웹훅 엔드포인트, 이벤트 구독, Signing Secret 검증까지… 한 번 삽질해본 분들은 공감하실 거예요. 설정 페이지 여기저기 왔다 갔다 하다 보면 어느새 시간이 훌쩍 지나 있죠.
Vercel이 이 고통을 해결하기 위해 Slack Agent Skill을 공개했습니다. 이건 단순한 라이브러리가 아니라, 코딩 어시스턴트(Claude Code 등)와 협업하여 슬랙 앱을 처음부터 끝까지 자동 생성해주는 워크플로우입니다.
핵심 아이디어: "인프라 설정은 내가 할게, 너는 에이전트 로직에 집중해."
이 스킬을 사용하면 개발자는 단 한 줄의 OAuth 코드도 직접 작성하지 않아도 됩니다. 코딩 어시스턴트가 App Manifest 생성, 환경 변수 설정, ngrok을 통한 로컬 테스트, Vercel 배포까지 전부 처리해줍니다.
근거자료에서 실제 변경 로그를 확인할 수 있습니다.
🛠️ 실전: 5단계 워크플로우 따라 하기
설치는 정말 간단합니다. 터미널에서 아래 명령어를 실행하세요.
# Slack Agent Skill 설치
npx skills add vercel-labs/slack-agent-skill
# Claude Code에서 워크플로우 실행
# (터미널에서 직접 실행)
/slack-agent new
그러면 코딩 어시스턴트가 대화형 마법사(Wizard)를 시작합니다. 총 5단계로 구성되어 있어요.
1단계: 프로젝트 설정
- LLM 제공자를 선택합니다. (OpenAI, Anthropic 등)
- Slack Agent Template을 기반으로 프로젝트가 초기화됩니다.
2단계: Slack 앱 생성
- 코딩 어시스턴트가 App Manifest를 자동 생성합니다.
- 필요한 OAuth Scope, 이벤트, 봇 토큰 권한이 모두 포함됩니다.
- Slack API 콘솔에서 앱을 생성하는 과정도 안내해줍니다.
3단계: 환경 변수 설정
# 아래 값들이 자동으로 .env.local에 기록됩니다
SLACK_SIGNING_SECRET=
SLACK_BOT_TOKEN=
SLACK_APP_TOKEN=
OPENAI_API_KEY=
- 각 토큰의 유효성 검증도 자동으로 수행됩니다.
4단계: 로컬 테스트
# ngrok을 사용한 로컬 터널링
npx ngrok http 3000
- ngrok URL을 슬랙 앱의 Request URL에 등록하는 과정까지 자동화됩니다.
- 실제 슬랙 채널에서 봇을 테스트해볼 수 있습니다.
5단계: 프로덕션 배포
# Vercel에 배포
vercel --prod
- 환경 변수가 자동으로 Vercel 프로젝트에 설정됩니다.
- 배포 완료 후 슬랙 앱의 Request URL을 프로덕션 URL로 업데이트합니다.
💡 팁: Vercel의 Slack Agent Template을 사용하면 마법사 없이 바로 배포하고 커스터마이징할 수 있습니다. 빠른 프로토타이핑이 필요하다면 이 방법을 추천합니다.
⚠️ 주의사항 & 국내 환경 적용 팁
이 기술은 해외에서 먼저 주목받고 있지만, 한국 개발자분들께도 유용한 포인트가 있습니다.
주의할 점
- Slack API의 지역 제한: Slack API 자체는 글로벌 서비스이므로 한국에서도 동일하게 사용 가능합니다. 다만, 일부 Slack Enterprise Grid 환경에서는 OAuth 설정이 다를 수 있습니다.
- LLM API 키 관리: OpenAI/Anthropic 키를 환경 변수에 저장할 때 절대 코드에 하드코딩하지 마세요. Vercel의 Environment Variables 기능을 활용하는 것이 안전합니다.
- 비용: Slack API 자체는 무료지만, LLM API 사용량에 따라 비용이 발생합니다. 프로토타입 단계에서는 무료 크레딧을 활용하세요.
국내 SI/스타트업 환경에서의 적용 맥락
- 한국 스타트업에서 슬랙은 이미 주요 협업 도구로 자리 잡았습니다. 고객 지원 봇, DevOps 알림 봇, 내부 승인 워크플로우 등에 바로 활용할 수 있어요.
- 예시: "영업팀이 슬랙으로 문의를 남기면 AI가 자동으로 답변하고, 해결되지 않은 건은 지라 티켓으로 자동 생성" 같은 시나리오를 단시간에 구현할 수 있습니다.
- 다만, 한국어 처리 시 LLM의 성능이 영어보다 다소 떨어질 수 있으므로, Few-shot 프롬프트에 한국어 예시를 충분히 포함하는 것이 좋습니다.
다음 단계 학습 방향
- 브라질 AI를 위한 핵심 데이터셋, Nemotron-Personas-Brazil 출시 – AI 모델의 지역화 데이터 전략을 이해하는 데 도움됩니다.
- Slack Agent Template을 포크해서 직접 커스터마이징해보세요.
- Function Calling을 활용해 슬랙 봇이 외부 API(예: 내부 CRM)와 연동되도록 확장해보는 것을 추천합니다.
✅ 결론: 이제는 '설정'이 아닌 '로직'에 집중할 때
Vercel의 Slack Agent Skill은 단순한 편의 기능을 넘어, 개발자의 생산성을 극적으로 향상시키는 도구입니다.
- 복잡한 OAuth/웹훅 설정 → 자동화
- 배포 환경 설정 → Vercel이 처리
- 개발자는 '무엇을 할지'만 정의하면 됨
이제 더 이상 슬랙 앱 개발의 진입 장벽에 좌절하지 마세요. Slack Agent Skill과 함께라면, 점심 먹기 전에 하나 완성할 수도 있습니다. 😄
함께 보면 좋은 글: