WhatsApp → ChatGPT (MCP 경유)

WhatsApp을 ChatGPT에 연결합니다: 각 고객/대행사가 ChatGPT의 프로젝트가 되어, (예약됨을 통한) 일일 보고서와 대화에 대한 자유 질문이 가능합니다. 비용 없음 — 모두 오픈소스/자체 호스팅입니다.

WhatsApp ←QR code→ Evolution API ←→ servidor MCP ←→ ChatGPT (Modo de desenvolvedor)
                               ↓
                        Postgres (sessão + mensagens)

구조

Related MCP server: WhatsApp Cloud API MCP Server

배포 로드맵

1. 인프라 (~15분, Docker가 설치된 Ubuntu VPS에서)

git clone https://github.com/rafaelacoelhob/whatsapp-chatgpt-mcp.git
cd whatsapp-chatgpt-mcp
cp .env.example .env
nano .env   # preencher senhas e domínio (instruções no próprio arquivo)
docker compose up -d

요구 사항: VPS IP를 가리키는 도메인/하위 도메인 (A 레코드) — Caddy가 HTTPS 인증서를 자동으로 발급합니다.

2. WhatsApp 연결 (2분, 1회)

1. Evolution 패널에 접속: http://<servidor>:8080/manager (로그인 = EVOLUTION_API_KEY)

2. EVOLUTION_INSTANCE에 정의된 이름으로 인스턴스 생성 (통합: Baileys)

3. 휴대폰에서: WhatsApp → 설정 → 연결된 기기 → 기기 연결 → QR 스캔

먼저 본인 번호로 테스트하세요. 그런 다음 최종 번호로 반복합니다 (EVOLUTION_INSTANCE를 바꾸거나 다른 인스턴스를 생성).

3. ChatGPT에 연결 (3분)

1. ChatGPT → 설정 → 플러그인 → 개발자 모드 → 커넥터 만들기

2. URL: https://<dominio-do-mcp>/mcp/<MCP_PATH_SECRET>

3. 채팅에서 테스트: "WhatsApp의 최근 대화를 나열해 줘" 및 "오늘 받은 메시지를 요약해 줘"

4. 대행사별 프로젝트 (각 2분)

각 대행사에 대해 ChatGPT에 프로젝트를 만들고 다음 지침을 사용합니다 (조정 필요):

Você acompanha as conversas da AGÊNCIA X no meu WhatsApp (use as
ferramentas do conector WhatsApp).

Contatos conhecidos da agência:
- Fulana — +55 11 9XXXX-XXXX
- Grupo "Agência X"

Contatos novos: se uma conversa de número desconhecido claramente for
desta agência, inclua no relatório na seção "🆕 Contato novo — confirmar".
Só trate como contato fixo depois que eu confirmar.

Relatório do dia — quando eu pedir, busque as mensagens de hoje e
organize em: 📌 Decisões / ⏳ Pendências / 📅 Prazos / ❗ Precisa de
resposta / 🆕 Contatos novos.

Responda sempre em português, direto. Se a informação não estiver nas
conversas, diga que não está — não invente.

5. 자동 일일 보고서

ChatGPT → 예약됨 → 새 작업: "매일 18시에 WhatsApp에서 [대행사/연락처]의 오늘 메시지를 검색하고 결정 / 지연 사항 / 마감 기한 / 답변 필요 / 새 연락처 형식으로 오늘의 보고서를 생성해 줘." (Business: 활성 작업 최대 15개; 그 이상이면 모든 대행사를 포괄하는 단일 작업을 사용하세요.)

금지 번호 목록

.env의 BLOCKED_NUMBERS (국가 코드 포함, 쉼표로 구분). 이는 서버의 기술적 필터입니다: 이 번호들의 대화는 무엇을 요청하든 절대 ChatGPT에 전달되지 않습니다. .env를 변경했으면 docker compose up -d를 다시 실행하여 적용하세요.

유지보수 (발생할 수 있는 상황)

• WhatsApp 세션이 끊김 (드묾): Evolution 패널에서 QR을 다시 스캔하세요 (2단계).

• 서버가 재시작됨: 컨테이너는 자동으로 돌아옵니다 (restart: always); 세션은 유지됩니다 (Postgres에 저장됨).

• 완전히 연결 해제: 휴대폰에서 연결된 기기 → 세션 종료; docker compose down; ChatGPT에서 커넥터 제거.

주의사항

• Evolution은 WhatsApp Web 스타일 브리지를 사용합니다 — Meta의 공식 기능이 아닙니다. 읽기 목적의 차단 위험은 낮지만 0은 아닙니다; 번호 소유자가 인지하고 있어야 합니다.

• 대화는 서버와 OpenAI를 거칩니다 (ChatGPT 기본 방식).