WhatsApp → ChatGPT (über MCP)

Verbinde WhatsApp mit ChatGPT: Jeder Kunde bzw. jede Agentur wird zu einem Projekt in ChatGPT, mit Tagesbericht (über Geplante Aufgaben) und offenen Fragen zu den Unterhaltungen. Keine Kosten — alles Open-Source/self-hosted.

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

Struktur

Related MCP server: WhatsApp Cloud API MCP Server

Bereitstellungsplan

1. Infrastruktur (~15 Min., auf einer Ubuntu-VPS mit 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

Voraussetzung: eine Domain/Subdomain, die auf die IP der VPS zeigt (A-Record) — Caddy stellt das HTTPS-Zertifikat selbst aus.

2. WhatsApp verbinden (2 Min., einmalig)

1. Öffne das Evolution-Dashboard: http://<servidor>:8080/manager (Login = EVOLUTION_API_KEY)

2. Erstelle eine Instanz mit dem in EVOLUTION_INSTANCE festgelegten Namen (Integration: Baileys)

3. Auf dem Handy: WhatsApp → Einstellungen → Verknüpfte Geräte → Gerät verknüpfen → QR-Code scannen

Teste zuerst mit deiner EIGENEN Nummer; wiederhole dann mit der endgültigen Nummer (indem du EVOLUTION_INSTANCE änderst oder eine weitere Instanz erstellst).

3. An ChatGPT anschließen (3 Min.)

1. ChatGPT → Einstellungen → Plugins → Entwicklermodus → Connector erstellen

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

3. In einem Chat testen: „Zeig mir meine letzten WhatsApp-Unterhaltungen“ und „Fasse die Nachrichten zusammen, die ich heute erhalten habe“

4. Projekte pro Agentur (je 2 Min.)

Erstelle pro Agentur ein Projekt in ChatGPT mit diesen Anweisungen (anpassen):

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. Automatischer Tagesbericht

ChatGPT → Geplante Aufgaben → neue Aufgabe: „Suche jeden Tag um 18:00 Uhr im WhatsApp nach den heutigen Nachrichten von [Agentur/Kontakte] und erstelle den Tagesbericht im Format Entscheidungen / Offene Punkte / Fristen / Antwort erforderlich / Neue Kontakte.“ (Business: bis zu 15 aktive Aufgaben; darüber hinaus eine einzelne Aufgabe verwenden, die alle Agenturen abdeckt.)

Liste verbotener Nummern

BLOCKED_NUMBERS in der .env (mit Ländervorwahl, durch Kommas getrennt). Es ist ein technischer Filter auf dem Server: Unterhaltungen dieser Nummern werden niemals an ChatGPT übermittelt, unabhängig davon, worum man bittet. Wenn du die .env geändert hast → docker compose up -d erneut ausführen, um es anzuwenden.

Wartung (was passieren kann)

• WhatsApp-Sitzung wurde getrennt (selten): QR-Code im Evolution-Dashboard erneut scannen (Schritt 2).

• Server neu gestartet: Container starten von selbst (restart: always); die Sitzung bleibt erhalten (liegt in Postgres).

• Endgültig trennen: auf dem Handy unter Verknüpfte Geräte → Sitzung beenden; docker compose down; Connector in ChatGPT entfernen.

Hinweise

• Evolution verwendet die WhatsApp-Web-Brücke — nicht offiziell von Meta. Das Risiko einer Sperre ist beim Lesen gering, aber nicht null; der Inhaber der Nummer muss sich dessen bewusst sein.

• Die Unterhaltungen laufen über den Server und über OpenAI (Standard von ChatGPT).