Como conectar o WhatsApp a uma IA (ChatGPT, Claude e agentes)

Você pode dar ao seu assistente de IA a capacidade de mandar e receber WhatsApp — pra ele enviar mensagens, cobrar via PIX e disparar campanhas por você. Há três formas, da mais direta à mais flexível. Todas usam a API REST do Visto Azul.

1. Servidor MCP (Claude, Claude Code, Cursor)

O MCP (Model Context Protocol) virou o padrão universal que conecta agentes de IA a ferramentas. É o jeito mais direto: você instala o servidor MCP da Visto Azul e o assistente passa a operar o WhatsApp em linguagem natural, sem você montar nada.

Funciona nos principais clientes MCP: Claude (Desktop e Code), ChatGPT, Gemini, Copilot, Cursor, Windsurf, VS Code, Zed, Cline e Goose.

No Claude Code, um comando:

claude mcp add vistoazul -e VISTOAZUL_API_KEY=SUA_API_KEY -- npx -y vistoazul-mcp

No Claude Desktop ou no Cursor, cole no config:

{
  "mcpServers": {
    "vistoazul": {
      "command": "npx",
      "args": ["-y", "vistoazul-mcp"],
      "env": { "VISTOAZUL_API_KEY": "SUA_API_KEY" }
    }
  }
}

Depois é só pedir: "manda uma mensagem pro cliente confirmando a entrega". Veja o guia completo do MCP.

2. GPT personalizado no ChatGPT (Actions)

No ChatGPT, dá para criar um GPT personalizado e conectar a nossa API como uma Action. O ChatGPT lê a especificação da API e passa a saber operar o WhatsApp sozinho.

1. No ChatGPT, crie um GPT e vá em Configure → Actions → Create new action.
2. Em schema, importe a nossa especificação OpenAPI: vistoazul.com.br/docs/openapi.yaml.
3. Em autenticação, escolha API Key do tipo Bearer e cole a sua API key.

Pronto: o seu GPT já envia mensagem, mídia e PIX pelo WhatsApp. O mesmo arquivo funciona em qualquer plataforma que aceite Actions/OpenAPI.

3. Webhook + API (qualquer agente, 24/7)

Para um atendente que responde sozinho o dia todo no seu servidor, use o laço clássico: o Visto Azul avisa você por webhook quando chega uma mensagem, a sua IA gera a resposta e você devolve com /v1/messages/text. É o padrão detalhado em como criar um atendente de IA com o Claude e que também roda no n8n.

4. Frameworks de agente (para desenvolvedores)

Se você constrói agentes com código, qualquer framework do momento fala com a nossa API REST — ou com o servidor MCP direto. Vale para LangChain / LangGraph, CrewAI, Vercel AI SDK, Mastra, PydanticAI, OpenAI Agents SDK e Google ADK. Importe o openapi.yaml como ferramenta, ou conecte o MCP — que já é suportado por vários desses SDKs.

Qual escolher?

• MCP: você quer operar o WhatsApp você mesmo, conversando com Claude, Cursor, Windsurf, VS Code e afins. Mais direto.
• GPT com Actions: você vive no ChatGPT e quer um assistente que age no WhatsApp.
• Webhook + API: você quer um bot autônomo respondendo clientes 24/7.
• Framework de agente: você é dev e monta o agente em código (LangGraph, CrewAI, Vercel AI SDK…).

Os três precisam só de uma API key do Visto Azul — sem taxa por mensagem da Meta, com PIX e anti-ban de fábrica.