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. 访问 Ebolition 面板：http://<servidor>:8080/manager（登录 = EVOLUTION_API_KEY）

2. 使用 EVOLUTION_INSTANCE 中定义的名称创建实例（集成：Baileys）

3. 在手机上：WhatsApp → 设置 → 已连接的设备 → 连接设备 → 扫描二维码

请先用你自己的号码测试；之后再用正式号码操作一遍（修改 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:00，从 WhatsApp 获取当天 [机构/联系人] 的消息，并生成当日报告，格式为：决定 / 待办 / 期限 / 需要回复 / 新联系人。”（Business 版：最多 15 个活跃任务；超过时，则使用一个覆盖所有机构的单一任务。）

禁止号码列表

.env 中的 BLOCKED_NUMBERS（含 DDI 国际区号，用逗号分隔）。这是一个服务器端的技术过滤：无论要求什么，这些号码的对话都绝不会被交给 ChatGPT。修改了 .env → 重新执行 docker compose up -d 即可生效。

维护（可能发生的情况）

• WhatsApp 会话断开（很少见）：在 Evolution 面板中重新扫描二维码（步骤 2）。

• 服务器重启了：容器会自动恢复（restart: always）；会话会保留（保存在 Postgres 中）。

• 彻底断开：在手机上，已连接的设备 → 结束会话；docker compose down；在 ChatGPT 中删除连接器。

注意事项

• Evolution 使用类似 WhatsApp Web 的桥接方式——并非 Meta 官方。仅读取的话，封号风险较低，但并非为零；号码持有者应当知情。

• 对话会经由你的服务器和 OpenAI（ChatGPT 的默认机制）传输。