FAQ

z-mcp é uma plataforma que conecta seu WhatsApp a LLMs como Claude e GPT. Você pode enviar e receber mensagens, transcrever áudios, cruzar contexto de conversas e criar automações... tudo via API REST ou protocolo MCP.

Não! Você usa seu número atual. O z-mcp funciona exatamente como o WhatsApp Web... você escaneia um QR code e pronto. Não precisa de chip novo ou número especial.

Sim. Suas mensagens são transmitidas com criptografia e a conexão usa a mesma tecnologia do WhatsApp Web oficial. Sua instância é isolada das demais.

Sim, cada instância conecta a um número de WhatsApp. Você pode criar múltiplas instâncias no mesmo dashboard para conectar diferentes números.

No Claude (claude.ai ou Claude Desktop), vá em Configurações > Conectores > Adicionar conector personalizado. Cole a URL da sua instância sem a chave (https://sua-instancia.zmcp.me/api/mcp), escolha "No sign-in" em Authentication e, em Request headers, adicione X-API-Key com sua chave. Veja a documentação de MCP Integration para o passo a passo completo.

O plano gratuito permite 100 requisições por minuto. Planos pagos têm limites maiores. Você pode verificar seu uso atual no dashboard.

Sim! Configure uma URL de webhook no dashboard para receber eventos em tempo real: novas mensagens, status de envio, conexão/desconexão do WhatsApp, etc.

Sim! A API REST funciona com qualquer linguagem ou LLM. O MCP é específico para clientes que suportam o protocolo (Claude, ChatGPT, Cursor, Windsurf). Para outros, use a API REST diretamente.

Quando você recebe um áudio no WhatsApp, a instância transcreve automaticamente e o texto fica disponível junto com a mensagem, pronto para a IA ler.

A ferramenta get_response_metrics calcula tempo médio, mediano e p90 de resposta num período, com comparação contra o mês anterior. get_attention_chats lista as conversas esperando resposta há mais tempo.

Sim, se você conectar o Grilo. A ferramenta get_contact_context resolve o contato e seus aliases para você cruzar com o histórico de reuniões.

Sim! A API REST e as ferramentas MCP permitem enviar mensagens de texto para qualquer contato ou grupo da instância conectada.

Verifique se a instância foi criada corretamente no dashboard. Tente recarregar a página ou criar uma nova instância. Se persistir, verifique se seu navegador permite popups.

Isso pode acontecer se o WhatsApp no celular ficar muito tempo offline ou se você deslogou manualmente. Acesse o dashboard e escaneie o QR code novamente.

Verifique: 1) se a instância está conectada (status verde no dashboard), 2) se o número de destino está correto com código do país, 3) se sua API key está correta nas requisições.

Use o header X-API-Key: sua-api-key (recomendado), ou Authorization: Bearer sua-api-key como alternativa. Você pode gerar uma nova chave na aba Conectar da instância se necessário.