Conectar o WhatsApp ao Claude Code

O que você pode fazer

Passo a passo

1. 1

   Crie sua conta no SyncZap

   Clique em Começar teste grátis e crie sua conta com e-mail e senha ou com um dos provedores mostrados na tela de entrada. 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 servidor no terminal

   Rode o comando abaixo. Ele registra o SyncZap como servidor HTTP com a URL https://synczap.ai/mcp. Use --scope user para valer em todos os projetos.

   claude mcp add --transport http synczap https://synczap.ai/mcp
5. 5

   Autentique pelo /mcp

   Dentro do Claude Code, rode /mcp, escolha synczap e depois Authenticate. O navegador abre a tela do SyncZap: entre, escolha a organização e clique em Permitir acesso, deixando a opção de envio marcada se quiser enviar.

6. 6

   Comece a perguntar

   Peça, por exemplo: Liste as conversas do WhatsApp sem resposta. O Claude Code pede permissão antes de usar cada ferramenta, conforme as suas configurações.

Planos necessários

Claude Code

• Funciona em qualquer instalação do Claude Code; o plano é o da sua conta Anthropic.
• O login OAuth precisa de uma sessão interativa: claude -p e o Agent SDK não fazem o login, então autentique antes pelo /mcp.

SyncZap

• O teste grátis de 7 dias libera todos os recursos.
• Envio pelo assistente: Plus, Pro, Max e Business.
• Transcrição de áudios e leitura de imagens e PDFs por IA: Pro, Max e Business, com limite diário (por exemplo, 120 minutos de áudio e 300 imagens por dia no Pro).

Ver preços

Pergunte sobre suas conversas

• 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.
• O que foi combinado no grupo da equipe desde segunda-feira?
• Encontre o PDF da proposta que o Carlos mandou e resuma os valores.
• Responda ao João confirmando a entrega amanhã às 10h.
• Liste os pedidos de clientes desta semana e crie um checklist em PEDIDOS.md.

Nomes, mensagens e legendas são conteúdo de terceiros: o SyncZap os entrega ao assistente como dados, nunca como instruções.

Grupos do WhatsApp

• Grupos ficam desligados até você escolher. Com a gravação em Somente pessoas escolhidas, que é o padrão, nenhum grupo é salvo até você ativar a sincronização dele em Conversas.
• Em Configurações → O que fica salvo, a opção Grupos grava todas as conversas em grupo; desligada, nenhum grupo é salvo e o que já foi salvo fica oculto. Com Todas, exceto algumas pessoas, os grupos entram junto, a menos que essa opção esteja desligada.
• Salvar grupos faz parte dos planos Plus, Pro, Max e Business e do teste. A resposta automática com a transcrição de áudios não vale em grupos, salvo com a opção Incluir grupos.

Ferramentas que o assistente recebe

A mesma lista que o servidor MCP publica para qualquer cliente. Ferramentas de envio só funcionam com a permissão de envio. Ver descrições completas

• get_account_contextVer conexão e coberturaSomente leitura
• list_conversationsListar conversasSomente leitura
• get_messagesLer conversaSomente leitura
• search_messagesBuscar mensagensSomente leitura
• list_unanswered_conversationsVer conversas sem respostaSomente leitura
• list_contactsBuscar contatosSomente leitura
• search_attachmentsBuscar arquivosSomente leitura
• read_attachmentTranscrever ou ler anexoSomente leitura
• check_recipient_send_optionsVerificar destinatárioSomente leitura
• get_send_queueVer fila de enviosSomente leitura
• get_send_statusConsultar envioSomente leitura
• send_messageEnviar mensagemAção sem confirmação
• mark_as_readMarcar como lidaAção sem confirmação
• react_to_messageReagir a mensagemAção sem confirmação
• update_chatOrganizar conversaAção sem confirmação
• prepare_messagePreparar respostaPrepara, não envia
• prepare_message_actionPreparar ação em mensagemPrepara, não envia
• prepare_mediaPreparar envio de arquivoPrepara, não envia
• prepare_locationPreparar envio de localizaçãoPrepara, não envia
• prepare_contactPreparar envio de contatoPrepara, não envia
• execute_message_actionExecutar ação confirmadaExige confirmação
• send_mediaEnviar arquivo confirmadoExige confirmação
• send_locationEnviar localização confirmadaExige confirmação
• send_contactEnviar contato confirmadoExige confirmação

Escolha o que o assistente vê

• Conversa por conversa: em Conversas, abra uma conversa e ligue Sincronizar. Só conversas sincronizadas são gravadas, exibidas e lidas por assistentes.
• Sincronizar todas: em Conexões, dono ou administrador pode ligar Sincronizar todas as conversas, que grava em tempo real as conversas novas e existentes. A mudança fica na auditoria.
• Lista Nunca salvar: em Configurações → O que fica salvo, a regra Todas, exceto algumas pessoas grava tudo menos quem estiver na lista; a regra Somente pessoas escolhidas grava só a lista Salvar somente estas.
• Nunca são salvos: feeds de sistema do WhatsApp (transmissões, canais e o contato de sistema). As credenciais do WhatsApp ficam no servidor de sincronização e nunca vão para o assistente.
• Desligar a sincronização de uma conversa interrompe a gravação, e o que já foi salvo deixa de ser exibido e lido por assistentes. Em Configurações, O que a IA consegue ver mostra as contagens do que está acessível.

Como o SyncZap isola os dados

Áudios, arquivos e mídia

• Fotos, áudios, vídeos e documentos continuam no celular. Quando alguém abre um anexo ou pede a leitura por IA, o SyncZap baixa uma cópia temporária, apagada do servidor 24 horas depois do download.
• O assistente transcreve áudios e lê imagens, prints e PDFs com read_attachment nos planos Pro, Max e Business e no teste, dentro do limite diário. Transcrições e leituras ficam guardadas como texto e entram na busca.
• Nos planos Max e Business e no teste, cada áudio recebido é transcrito assim que chega. Dono ou administrador escolhe se a transcrição fica só no SyncZap, vai para o seu chat Mensagem para você ou é respondida na própria conversa, onde o contato também vê.
• Áudios e imagens enviados para transcrição ou leitura vão à API do Google Gemini ou da OpenAI, contratadas sem uso dos dados para treinar modelos.

Como funciona o envio

• Enviar e agir exige papel de dono ou administrador, a permissão de envio (marcada na autorização ou na chave de API) e um plano com envio por agentes.
• 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.
• Os envios passam pela fila do número, um por vez. Na fila ainda não é enviado, e 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 /mcp mostra o SyncZap sem autenticação

Escolha synczap no /mcp e clique em Authenticate. O comando claude mcp add não testa credenciais; a conexão só é verificada no /mcp.

Prefiro uma chave de API a OAuth

No .mcp.json do projeto, use type http, a mesma URL e headers com Authorization: Bearer e X-SyncZap-Workspace, como nos guias de clientes com chave. Um cabeçalho Authorization fixo desliga o login OAuth.

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 com envio por agentes (Plus, Pro, Max e Business e o teste). Se você autorizou só leitura, desconecte o SyncZap no assistente e conecte de novo, marcando a opção de envio.

Apareceu o limite de 60 envios por hora

Envios de texto diretos pelos assistentes têm um limite de 60 por hora em cada organização, somando todos os assistentes e chaves. Espere a janela passar; nada é enviado enquanto isso.

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 transcrição de áudios e a leitura de imagens e PDFs por IA fazem parte dos planos Pro, Max e Business 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.

Perguntas frequentes

O Claude Code vê todas as minhas conversas?

Não. O Claude Code só lê as conversas com sincronização ativa na organização que você conectou. Conversas não selecionadas, pessoas na lista Nunca salvar e feeds de sistema do WhatsApp ficam de fora.

O assistente pode enviar mensagens sozinho?

Só quando você pede e só com a permissão de envio, num plano com envio por agentes (Plus, Pro, Max e Business e o teste). Texto sai direto, sem etapa de confirmação, até 60 por hora por organização. Arquivos, localização e contatos são preparados e só saem depois da sua confirmação.

Preciso de chave de API?

Não. O Claude Code usa OAuth 2.1 com PKCE: você entra na tela do SyncZap e escolhe a organização. Nenhuma senha passa pelo Claude Code.

Tenho mais de um número de WhatsApp. Funciona?

Sim, nos planos com mais de um número. Listagens e buscas juntam todos os números e mostram de qual número veio cada item; para ler uma conversa ou enviar, o assistente informa o número.

O SyncZap é um produto do WhatsApp?

Não. O SyncZap é independente e não tem vínculo com o WhatsApp, a Meta ou a Anthropic. Ele conecta o seu número como aparelho vinculado, o mesmo recurso usado pelo WhatsApp Web, sem a API do WhatsApp Business.

Quanto custa?

Você testa tudo por 7 dias sem pagar. Depois, escolha um plano na página de preços; o plano do próprio cliente de IA é à parte.

Ainda com dúvida?