FAQ
Perguntas frequentes e solucao de problemas.
Geral
z-mcp e uma plataforma que conecta seu WhatsApp a LLMs como Claude e GPT. Voce pode enviar e receber mensagens, transcrever audios, analisar imagens e criar automacoes - tudo via API REST ou protocolo MCP.
Nao! Voce usa seu numero atual. O z-mcp funciona exatamente como o WhatsApp Web - voce escaneia um QR code e pronto. Nao precisa de chip novo ou numero especial.
Sim. Suas mensagens sao transmitidas com criptografia e nao armazenamos o conteudo das conversas em nossos servidores. A conexao e a mesma tecnologia usada pelo WhatsApp Web oficial.
Sim, cada instancia conecta a um numero de WhatsApp. Voce pode criar multiplas instancias no mesmo dashboard para conectar diferentes numeros.
Integracao
Adicione a configuracao no arquivo claude_desktop_config.json com sua API key. Veja a documentacao de MCP Integration para o passo a passo completo.
O plano gratuito permite 100 requisicoes por minuto. Planos pagos tem limites maiores. Voce 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, conexao/desconexao do WhatsApp, etc.
Sim! A API REST funciona com qualquer linguagem ou LLM. O MCP e especifico para clientes que suportam o protocolo (Claude Desktop, Cursor, Continue). Para GPT ou outros, use a API REST diretamente.
Recursos
Quando voce recebe um audio no WhatsApp, pode usar a ferramenta transcribe_audio para converte-lo em texto. Usamos Whisper para transcricao de alta qualidade em portugues e outros idiomas.
Sim! Use a ferramenta analyze_image para extrair texto de documentos, descrever fotos, ler comprovantes de pagamento e muito mais. Integracao com GPT-4 Vision.
Voce pode criar regras no dashboard: 'quando receber mensagem com palavra X, responder com Y'. Tambem pode criar automacoes mais complexas usando webhooks e sua propria logica.
Sim! A API suporta envio de imagens, documentos, audios e videos. Basta fazer upload do arquivo e enviar para o contato desejado.
Troubleshooting
Verifique se a instancia foi criada corretamente no dashboard. Tente recarregar a pagina ou criar uma nova instancia. Se persistir, verifique se seu navegador permite popups.
Isso pode acontecer se o WhatsApp no celular ficar muito tempo offline ou se voce deslogou manualmente. Acesse o dashboard e escaneie o QR code novamente.
Verifique: 1) Se a instancia esta conectada (status verde no dashboard), 2) Se o numero de destino esta correto com codigo do pais, 3) Se sua API key esta correta nas requisicoes.
Confirme que sua API key esta no header Authorization: Bearer sua-api-key. Voce pode gerar uma nova chave no dashboard se necessario.
Ainda tem duvidas?
Nao encontrou o que procurava? Estamos aqui para ajudar.
Base de conhecimento