Documentação: WhatsApp com IA

Como conectar o WhatsApp ao ChatGPT ou ao Claude?

1. Crie sua conta e vincule o número de WhatsApp pelo QR Code, seguindo o guia de primeiros passos.
2. Siga o guia de conexão MCP para adicionar o z-mcp à sua IA. Entre na sua conta e autorize o acesso.
3. Faça uma primeira pergunta, como: “Quem ficou esperando resposta esta semana?” Confira o contexto antes de agir.

O caminho principal usa login e autorização, sem copiar uma chave. Desenvolvedores também podem integrar pela API REST e por webhooks. Consulte os planos e o período de teste; a assinatura da IA é à parte.

O que saber antes de conectar?

A conexão funciona como o WhatsApp Web e não é a API oficial da Meta. O WhatsApp pode desconectar o número. O histórico antigo depende da sincronização e pode chegar incompleto. Consulte as perguntas frequentes antes de começar.

Estas páginas explicam o produto. Suas conversas, chaves e conexões ficam na área autenticada. Para análise sem envio, use uma chave só de leitura nas opções avançadas.

O que posso perguntar depois de conectar?

Comece com uma consulta de leitura e informe o período. Exemplos de perguntas:

• “Quem ficou esperando resposta esta semana?”
• “Qual foi o tempo médio, mediano e p90 de resposta nos últimos sete dias?”
• “Resuma o histórico disponível de um contato antes de eu retomar a proposta.”

A resposta depende das mensagens disponíveis. Confira o contexto e as datas antes de agir. No login, leitura é o padrão e envio é opcional. Se usar uma chave nas opções avançadas, escolha o escopo read_only para consultar sem permitir envio.

Ainda não conectou? Veja o passo a passo com imagens ou consulte o guia MCP.

Avançado: listar ferramentas MCP com uma chave

Se você usa uma chave por número, substitua o endereço e a chave fictícios do exemplo pelos seus dados:

curl -s -X POST "https://sua-instancia.zmcp.me/api/mcp" \
  -H "X-API-Key: zmcp_sua-api-key" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

A chave é criada no painel da instância, aba Conectar.