WhatsApp → ChatGPT (vía MCP)

Conecta un WhatsApp a ChatGPT: cada cliente/agencia se convierte en un Proyecto en ChatGPT, con informe del día (vía Programados) y preguntas libres sobre las conversaciones. Coste cero — todo open-source/self-hosted.

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

Estructura

Related MCP server: WhatsApp Cloud API MCP Server

Guía de implementación

1. Infraestructura (~15 min, en una VPS Ubuntu con Docker)

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

Requisito: un dominio/subdominio apuntando a la IP de la VPS (registro A) — Caddy emite el certificado HTTPS por sí solo.

2. Conectar WhatsApp (2 min, una vez)

1. Acceder al panel de Evolution: http://<servidor>:8080/manager (login = EVOLUTION_API_KEY)

2. Crear instancia con el nombre definido en EVOLUTION_INSTANCE (integración: Baileys)

3. En el móvil: WhatsApp → Configuración → Dispositivos vinculados → Vincular dispositivo → escanear el QR

Prueba primero con TU número; después repite con el número definitivo (cambiando EVOLUTION_INSTANCE o creando otra instancia).

3. Conectar a ChatGPT (3 min)

1. ChatGPT → Configuración → Plugins → Modo de desarrollador → crear conector

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

3. Probar en un chat: "Lista mis conversaciones recientes de WhatsApp" y "Resume los mensajes que recibí hoy"

4. Proyectos por agencia (2 min cada uno)

Crear un Proyecto en ChatGPT por agencia con estas instrucciones (adaptar):

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. Informe diario automático

ChatGPT → Programados → nueva tarea: "Todos los días a las 18h, busca en WhatsApp los mensajes de hoy de [agencia/contactos] y genera el informe del día en el formato Decisiones / Pendientes / Plazos / Necesita respuesta / Contactos nuevos." (Business: hasta 15 tareas activas; por encima de eso, usar una tarea única que cubra todas las agencias.)

Lista de números prohibidos

BLOCKED_NUMBERS en .env (con DDI, separados por coma). Es un filtro técnico en el servidor: las conversaciones de esos números nunca se entregan a ChatGPT, independientemente de lo que se pida. Modificaste el .env → docker compose up -d de nuevo para aplicar.

Mantenimiento (lo que puede ocurrir)

• La sesión de WhatsApp cayó (raro): volver a escanear el QR en el panel de Evolution (paso 2).

• El servidor se reinició: los contenedores vuelven solos (restart: always); la sesión sobrevive (queda en Postgres).

• Desconectar definitivamente: en el móvil, Dispositivos vinculados → cerrar sesión; docker compose down; quitar el conector en ChatGPT.

Avisos

• Evolution usa el puente estilo WhatsApp Web — no es oficial de Meta. Riesgo de baneo bajo para lectura, pero no nulo; el dueño del número debe ser consciente.

• Las conversaciones transitan por el servidor y por OpenAI (estándar de ChatGPT).