피드로 돌아가기
Dev.toInfrastructure
원문 읽기
Baileys-Next.js 하이브리드 구조로 구현한 무비용 WhatsApp AI 튜터
The Complete Developer’s Guide to the Baileys WhatsApp Bot: Setup, Scaling, and VPS Deployment
AI 요약
Context
데스크톱 포털 진입 장벽으로 인한 낮은 학생 참여도와 공식 WhatsApp Business API의 엄격한 템플릿 제한 및 비용 이슈 발생. 사용자 접근성을 극대화하기 위해 Friction-free 인터페이스인 WhatsApp 기반의 직접적인 학습 제출 환경 구축 필요.
Technical Solution
- WebSocket 기반 @whiskeysockets/baileys 라이브러리를 활용한 Headless WhatsApp 연결로 메시지 전송 유연성 확보 및 비용 제거
- Ubuntu VPS(Gateway)와 Vercel Serverless(Logic Engine)를 분리한 2-Tier 하이브리드 아키텍처 설계로 24/7 연결성과 서버리스의 확장성 동시 달성
- VPS Gateway에서 메시지 수신 및 Media Stream 처리를 수행한 후 x-bot-secret 인증을 통해 Next.js API로 정제된 데이터 전송
- Supabase를 통한 학생 프로필 쿼리와 Gemini-2.5-Flash API를 연동한 Intent 분류 및 AI 평가 로직 구현
- 특정 Homework Plan ID 기반의 Custom Memory Context Routing을 적용하여 LLM의 컨텍스트 윈도우 제한 극복 및 정확도 향상
- PM2를 활용한 프로세스 관리와 Rate-limited Queue 도입으로 VPS 내 Thread-safe 상태 유지 및 서버리스 타임아웃 방지
실천 포인트
- WebSocket 유지가 필요한 서비스는 상시 가동되는 VPS Gateway를 두고 비즈니스 로직은 Serverless로 분리하여 비용 최적화 - 공식 API의 제약이 심한 경우 Open-source 기반의 프로토콜 구현체 검토 및 인증 상태(Multi-file Auth State) 관리 전략 수립 - LLM 도입 시 단순 채팅 이력 전달 대신 도메인 식별자(ID) 기반의 정밀한 컨텍스트 라우팅 설계 적용 - 외부 웹훅 수신 엔드포인트 설계 시 Secret Header 인증을 통한 보안 계층 필수 적용