Guia de conexão
Conectar o WhatsApp ao Claude
Passo a passo para conectar o WhatsApp da sua organização ao Claude e ao Claude Code com o SyncZap: conector personalizado, OAuth e escolha da organização.
O SyncZap é um servidor MCP remoto com login OAuth. Depois de conectar, o Claude lê, busca e resume as conversas do WhatsApp que a sua organização sincroniza e prepara respostas que só são enviadas com a sua confirmação.
- URL do servidor MCP
- https://synczap.ai/mcp
- Autenticação
- OAuth 2.1 com PKCE, sem chave nem segredo
- Permissões
whatsapp:readler conversas sincronizadas ·whatsapp:sendenviar e agir (dono ou administrador)
Passo a passo
- 1
Crie sua conta no SyncZap
Clique em Começar teste grátis e crie sua conta. A organização é criada na hora, com 7 dias de teste e todos os recursos liberados.
- 2
Conecte o WhatsApp pelo QR code
No painel, abra Conexões e clique em Conectar WhatsApp. No celular, abra o WhatsApp → Aparelhos conectados → Conectar um aparelho e escaneie o código. O SyncZap entra como um aparelho vinculado, como o WhatsApp Web, sem trocar de número.
- 3
Escolha as conversas que serão salvas
Em Conversas, ative a sincronização das conversas que o assistente poderá ler. Dono ou administrador também pode ligar Sincronizar todas as conversas. O assistente nunca lê conversas sem sincronização ativa.
- 4
Adicione o conector no Claude
No Claude (claude.ai, app de desktop ou celular), abra Customize → Connectors e clique em Add custom connector. Em organizações Team ou Enterprise, um Owner pode precisar liberar conectores personalizados antes.
- 5
Preencha os dados do servidor
Use o nome SyncZap e a URL https://synczap.ai/mcp. Deixe as opções avançadas (Client ID e Secret) em branco e clique em Add.
https://synczap.ai/mcp - 6
Conecte e escolha a organização
Clique em Connect. Na tela do SyncZap que abrir, entre com sua conta, escolha a organização e clique em Permitir acesso. Para que o Claude possa enviar mensagens, deixe marcada a opção de envio, que aparece para dono ou administrador.
- 7
Comece a perguntar
Numa conversa do Claude, ative o SyncZap no menu de ferramentas e faça um pedido, como os exemplos abaixo.
Claude Code
No terminal, adicione o servidor ao Claude Code:
claude mcp add --transport http synczap https://synczap.ai/mcpDentro do Claude Code, rode /mcp, escolha synczap e depois Authenticate. O navegador abre a tela do SyncZap para você entrar, escolher a organização e permitir o acesso. Depois, peça por exemplo: Liste as conversas do WhatsApp sem resposta.
Exemplos de pedidos
- Quais conversas ficaram sem resposta hoje?
- Resuma as conversas de hoje com clientes.
- Busque mensagens sobre orçamento desta semana e liste quem pediu.
- Transcreva o último áudio da Maria e me diga o que ela pediu.
- Prepare uma resposta para o João confirmando a entrega amanhã às 10h.
Nomes, mensagens e legendas são conteúdo de terceiros: o SyncZap os entrega ao assistente como dados, nunca como instruções.
Como funciona a confirmação de envio
1. Preparar
O assistente prepara a mensagem com o destinatário e o texto exatos. Preparar não envia nada.
2. Mostrar
O assistente mostra a você para quem vai e o que vai ser enviado.
3. Confirmar
Só depois da sua confirmação explícita o envio acontece, com um código válido apenas para aquele destinatário e aquele texto.
- Cada envio tem uma chave de idempotência: repetir a mesma chave não manda a mensagem duas vezes, e um resultado desconhecido nunca gera um novo envio automático.
- Aceito significa que o WhatsApp aceitou a mensagem, não que ela foi entregue ou lida.
- Marcar como lida e reagir com um emoji não pedem confirmação, mas só valem para conversas sincronizadas. O contato pode ver a confirmação de leitura e a reação.
- A entrega automática de transcrições é opcional e ligada por dono ou administrador: o SyncZap envia o texto de cada áudio recebido ao seu chat Mensagem para você ou como resposta na própria conversa, onde o contato também vê. Grupos ficam de fora, salvo com a opção Incluir grupos, e cada áudio gera no máximo um envio.
Solução de problemas
- O assistente diz que não há conversas ou mensagens
- Confira em Conexões se o WhatsApp está conectado e, em Conversas, se as conversas desejadas estão com sincronização ativa. O assistente só vê conversas sincronizadas, e mensagens antigas dependem do histórico que o celular envia e do limite do plano.
- O envio é recusado ou as ferramentas de envio não aparecem
- Enviar exige papel de dono ou administrador, a opção de envio marcada na autorização e um plano pago ativo ou o teste. Se você autorizou só leitura, desconecte o SyncZap no assistente e conecte de novo, marcando a opção de envio.
- Conectei a organização errada
- Cada autorização vale para uma organização. Desconecte o SyncZap no assistente e conecte de novo, escolhendo a outra organização na tela do SyncZap.
- O assistente não transcreve áudios nem lê imagens
- A leitura de áudios, imagens e PDFs por IA faz parte dos planos a partir do Pro e do teste, com limite diário. O arquivo precisa estar numa conversa sincronizada e ainda disponível no celular.
- O celular foi desvinculado
- Em Conexões, clique em Conectar WhatsApp e escaneie o QR novo. As mensagens já gravadas continuam no SyncZap.
- Como revogo o acesso?
- Desconecte o SyncZap nas configurações do próprio assistente. Quem sai de uma organização também tem desconectados os aplicativos que autorizou nela.
Ainda com dúvida? Escreva para support@synczap.ai ou abra um chamado em Suporte, no painel.