무료 오픈소스 WhatsApp CRM 완전 셋업 가이드

01

핵심 개요 — 왜 무료 오픈소스인가?

항목	내용
프로젝트명	WACM (WhatsApp CRM)
비용	완전 무료 (호스팅 별도)
API	Meta 공식 WhatsApp Business API — 밴 위험 없음
주요 스택	Next.js + Supabase + ngrok
핵심 차이점	제3자 API 없이 공식 Meta API 직접 사용

상용 솔루션은 월 수십~수백만 원이지만, WACM은 Meta 공식 API를 직접 활용해 완전 무료로 동일 기능을 구현한다.

02

시스템 아키텍처

[사용자 WhatsApp 앱]
↓ 메시지 전송
[Meta WhatsApp Business API]
↓ Webhook 이벤트
[ngrok 터널 / Hostinger 서버] → [WACM Next.js 앱]
↓
[Supabase DB + Auth]
(연락처·메시지·자동화 규칙 저장)

03

단계별 설치 절차

1

GitHub 레포 클론 및 의존성 설치

git clone → cd wacm → npm install → cp .env.example .env.local

2

Supabase 프로젝트 생성 및 SQL 마이그레이션

supabase.com에서 프로젝트 생성 → URL/키 복사 → SQL Editor에서 12개 파일 순서대로 실행

3

Meta 개발자 앱 생성 및 WhatsApp API 설정

developers.facebook.com → 앱 생성 → 시스템 사용자로 영구 액세스 토큰 발급

4

WACM 대시보드에 자격증명 입력

Settings → WhatsApp Configure: 토큰·Phone Number ID·Business Account ID·Verify Token 입력

5

ngrok Webhook 연결 (로컬 개발)

ngrok http 3003 → 생성된 https URL을 Meta 개발자 포털 Webhook callback에 등록

6

Hostinger 클라우드 배포 (24/7 상시 운영)

GitHub 레포 → Hostinger Node.js 웹앱 → 환경 변수 복사 → 배포 완료

04

자동화 기능 및 활용 시나리오

트리거	액션
키워드 포함	자동 응답 메시지
새 메시지	태그 추가/제거
키워드 매칭	담당자 배정
키워드 매칭	템플릿 발송

소상공인 응대 자동화

영업 시간 외 자동 응답 + FAQ 키워드 매핑으로 응대 부담 제거

리드 관리

문의 고객 자동 CRM 등록 + 태그로 단계 분류 (신규/상담중/완료)

팀 협업 인박스

여러 담당자 공동 관리, 대화 배정 기능으로 역할 분리

05

핵심 타임스탬프

0:00소개 및 비용 절감 포인트 — 상용 대비 무료의 의미
1:30GitHub 클론 및 npm install 실습
3:30Supabase 프로젝트 생성 및 12개 SQL 마이그레이션
6:30Meta 개발자 앱 생성, 영구 액세스 토큰 발급
11:00ngrok Webhook 연결 및 실제 메시지 수신 테스트
13:00키워드 자동화 규칙 생성 및 실시간 데모
15:00Hostinger 클라우드 배포 완료

06

보안 주의사항

Service Role Key: Supabase 행 수준 보안(RLS)을 우회해 DB에 직접 접근 가능한 마스터 키 — 절대 외부 공유 금지

Meta App Secret: 동일하게 외부 공유 금지 — 노출 시 즉시 재발급

테스트 전화번호는 90일간만 유효 — 실서비스 전 실제 번호 등록 필수

무료 오픈소스 WhatsApp CRM & 자동화