구글 폼으로 들어온 컨설팅 문의를 텔레그램 명령어로 관리할 수 있게 만들었습니다. 이제 이동 중에도 /list, /assign 같은 명령어로 리드 상태를 확인하고 업데이트할 수 있어요.
---
이런 분들께 도움돼요
- 구글 시트로 리드/고객 관리하는데 매번 시트 열기 귀찮으신 분
- n8n 워크플로우 JSON 만들 때 에러 때문에 고생하시는 분
- 자동화 프로젝트를 체계적으로 문서화하며 진행하고 싶은 분
- 급한 일에 밀려 개인 프로젝트가 자꾸 사라지는 분
---
소개: 시도하고자 했던 것과 그 이유
문제 상황
컨설팅 문의가 구글 폼으로 들어오면, 이런 과정을 거쳐야 했어요:
1. 구글 시트 열기
2. 새 응답 확인
3. 리드관리 시트에 복사
4. 담당자한테 알림 보내기
5. 상태 업데이트할 때마다 다시 시트 열기
문제는요...
- 바쁘면 새 문의 확인을 놓치는 경우가 생김
- 수기로 하다 보니 누락이 잦았음
- 급한 일 위주로 처리하다 보니 이 프로젝트처럼 개인적으로 하고 싶은 것들이 자꾸 늦어지거나 사라짐
목표
"텔레그램에서 명령어 하나로 리드 관리하자"
- 새 문의 → 자동으로 텔레그램 알림
- /assign T-xxx 김혜미 강의 → 담당자 지정 완료
- /list 진행중 → 현재 진행 중인 리드 목록 확인
---
진행 방법: 어떤 도구를 사용했고, 어떻게 활용했나요?
사용한 도구
| 도구 | 역할 |
|------|------|
| Claude Code | 워크플로우 설계, JSON 생성, 디버깅 |
| n8n | 워크플로우 자동화 실행 엔진 |
| Google Sheets | 리드 데이터 저장소 (SSOT) |
| Telegram Bot | 알림 수신 + 명령어 입력 UI |
| bkit PDCA | 체계적인 문서화 방법론 |
Claude Code와 협업한 과정
1단계: bkit PDCA로 문서부터 만들기
급하게 코드부터 짜지 않고, 문서화부터 시작했어요:
```
docs/
├── 01-plan/ ← 목표, 범위, 성공 기준
├── 02-design/ ← 아키텍처, 데이터 모델, API 스펙
├── 03-analysis/ ← Gap 분석 (설계 vs 구현)
└── 04-report/ ← PDCA 사이클 리포트
```
이렇게 하 니까 좋았던 점:
- "왜 이렇게 만들었지?" 나중에 안 까먹음
- Claude Code한테 맥락 설명하기 쉬움
- 다음에 뭘 만들어야 하는지 명확함
2단계: 워크플로우 JSON 생성
Claude Code에게 설계 문서를 보여주고 n8n JSON을 만들어달라고 했어요.
WF-01: 신규 리드 등록 및 알림
```
구글 폼 응답 → 리드관리 시트에 추가 → 텔레그램 알림
```
WF-02: 텔레그램 명령어 처리
```
텔레그램 메시지 → 명령어 파싱 → Switch로 분기 → 시트 업데이트 → 결과 응답
```
지원하는 명령어
| 명령어 | 기능 | 예시 |
|--------|------|------|
| /add | 리드 추가 | /add ABC컴퍼니 김철수 010-1234-5678 AI강의요청 |
| /assign | 담당자 지정 | /assign L-a1b2c3d4 김혜미 강의 |
| /stage | 단계 변경 | /stage L-a1b2c3d4 견적중 |
| /next | 다음 액션 설정 | /next L-a1b2c3d4 견적서발송 01-25 |
| /hold | 보류 처리 | /hold L-a1b2c3d4 |
| /done | 완료 처리 | /done L-a1b2c3d4 |
| /list | 목록 조회 | /list 진행중 |
| /view | 상세 조회 | /view L-a1b2c3d4 |
| /help | 도움말 | /help |
---
## 결과와 배운 점
### 결과물
Before:
- 구글 시트 열어서 확인 → 복사 → 알림 보내기 → 상태 업데이트
- PC 앞에 있어야만 처리 가능
After:
- 새 문의 들어오면 텔레그램으로 자동 알림
- /assign, /list 같은 명령어로 이동 중에도 처리
- 구글 시트 열 필요 없음
배운 점
1. 문서화 먼저, 코드는 나중에
- bkit PDCA 덕분에 방향 잃지 않고 진행
- "급한 일"에 밀려도 문서가 있으니 다시 시작하기 쉬움
2. n8n JSON은 버전별로 형식이 다름
- Switch 노드 v3는 rules.values + options 필수
- 에러 메시지만 보고 Claude Code와 함께 디버깅
3. 처음부터 완벽하게 만들려 하지 말 것
- 일단 동작하게 → 테스트 → 피드백 → 개선
- 복잡한 로직(중복 체크)보다 단순한 구조가 유지보수에 유리
---
재사용 가능한 프롬프트
프롬프트 : PDCA 문서 생성
bkit 플러그인을 이용해서 이 프로젝트를 분석하고,
bkit의 PDCA를 적용해서 작업해줘.
- Plan: 목표, 범위, 성공 기준
- Design: 아키텍처, 데이터 모델
- Do: 구현
- Check: Gap 분석
- Act: 다음 액션
## 향후 계획
- WF-03: 일간/주간 브리핑 - 매일 아침 우선순위 리드 자동 발송
- WF-04: SLA 관리 - 고객 미응답 3일 경과 시 자동 리마인드
- WF-05: 문서 자동 생성 - 리드 → 견적서 → 계약서까지 파이프라인 완성
---
도움 받은 글
- [bkit.ai](https://bkit.ai) - bkit의 PDCA 방법론 및 Claude Code 플러그인
- 김경호님 라이브 강의
여진님의 ai-case skill
