TL;DR

OpenWA는 NestJS와 TypeScript 기반의 독립형 self-hosted WhatsApp API Gateway로, Docker Compose 또는 로컬 Node.js 환경에서 REST API와 React Dashboard를 함께 실행합니다. whatsapp-web.js와 baileys를 엔진으로 선택해 여러 세션, 메시지와 미디어, 그룹, Webhook, API 키, PostgreSQL·Redis·S3 연동을 제공하며 n8n community nodes와 MCP Server도 연결할 수 있습니다. 다만 Meta 공식 Cloud API가 아닌 reverse-engineered client를 사용하므로 계정 제한 위험이 있고, README는 전용 번호와 수신 동의 기반 발송을 요구합니다. 개인 프로젝트, 내부 자동화, 학습용에는 적합하지만 규제 환경이나 인증·매출 핵심 알림에는 공식 Cloud API와 fallback 경로가 필요합니다.

핵심 포인트

• 이 레포지토리는 TypeScript와 NestJS로 만든 독립형 self-hosted WhatsApp API Gateway입니다. REST API와 React Dashboard로 세션, 메시지, Webhook, API 키를 관리합니다. WhatsApp 공식 Cloud API가 아니라 whatsapp-web.js 또는 baileys에 연결하므로 계정 제한과 차단 위험을 감수해야 합니다.
• Docker Compose로 SQLite와 Local storage를 사용하는 구성을 즉시 실행할 수 있습니다. 운영 환경에서는 PostgreSQL, Redis, MinIO 또는 S3를 설정으로 선택하며 데이터베이스와 저장소를 애플리케이션 코드 변경 없이 교체합니다. API와 Dashboard는 기본적으로 같은 2785 포트에서 제공됩니다.
• 여러 WhatsApp 계정을 한 인스턴스에서 동시에 운영하고 메시지, 미디어, 그룹, 채널, 라벨, 통화 이벤트를 HTTP API와 Webhook으로 처리합니다. Webhook에는 HMAC 서명과 조건 기반 smart filter가 포함됩니다. 대량 발송에는 세션별 rate limit과 수신자 동의가 필요합니다.
• MCP_ENABLED=true를 설정하면 별도 프로세스 없이 POST /mcp에 AI 에이전트용 도구를 연결할 수 있습니다. 기본값은 읽기 전용 25개 도구이며 MCP_READONLY=false로 메시지 발송과 그룹 작업을 포함한 51개 도구를 활성화합니다. MCP에도 기존 API 키, 역할, 세션 범위 인증이 적용되지만 공용 인터넷에 직접 노출하면 안 됩니다.