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:read ler conversas sincronizadas · whatsapp:send enviar e agir (dono ou administrador)

Passo a passo

  1. 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. 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. 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. 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. 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. 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. 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/mcp

Dentro 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. 1. Preparar

    O assistente prepara a mensagem com o destinatário e o texto exatos. Preparar não envia nada.

  2. 2. Mostrar

    O assistente mostra a você para quem vai e o que vai ser enviado.

  3. 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.

Pergunte ao seu assistente o que aconteceu no WhatsApp hoje.

Conecte em poucos minutos e use todos os recursos por 7 dias, sem compromisso.