Conectar o WhatsApp ao Zed

O que você pode fazer

Passo a passo

O Zed se conecta com uma chave de API da organização e o cabeçalho X-SyncZap-Workspace. Os exemplos usam só marcadores: nunca publique a sua chave num repositório.

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

   Crie uma chave de API

   No painel, abra Acesso API e clique em Gerar chave (dono ou administrador). Dê um nome, como o do cliente, e marque Leitura; marque também Envio de mensagens se o assistente for enviar. Copie a chave: ela aparece uma única vez e o SyncZap guarda só o hash.

5. 5

   Copie o ID da organização

   A chave só vale com o ID da sua organização no cabeçalho X-SyncZap-Workspace. Ele aparece em Acesso API, na requisição de exemplo (o trecho depois de /api/agent/), e no endereço do painel, depois de workspace=.

6. 6

   Adicione o SyncZap ao Zed

   Vá em Settings → AI → MCP Servers → Add Server → Add Remote Server, ou edite o settings.json do Zed e acrescente o SyncZap em context_servers com url https://synczap.ai/mcp e os cabeçalhos. Troque ID_DA_ORGANIZACAO pelo ID da organização e SUA_CHAVE_DE_API pela chave, quando aparecer.

   settings.json

   {
     "context_servers": {
       "synczap": {
         "url": "https://synczap.ai/mcp",
         "headers": {
           "Authorization": "Bearer SUA_CHAVE_DE_API",
           "X-SyncZap-Workspace": "ID_DA_ORGANIZACAO"
         }
       }
     }
   }

7. 7

   Confira e teste

   Um ponto verde com a dica Server is active indica que o servidor está rodando. No painel de agente, peça: Liste as conversas do WhatsApp sem resposta.

Planos necessários

Zed

• A documentação do Zed não cita requisito de plano para servidores 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 Zed pede confirmação a cada ferramenta

É o padrão do Zed (tool_permissions com confirm). Ajuste nas configurações do agente, se quiser.

O cliente recebe 401 ou abre uma tela de login

Os dois cabeçalhos precisam chegar juntos: Authorization: Bearer com a chave e X-SyncZap-Workspace com o ID da mesma organização. Uma chave revogada, de outra organização ou de uma organização suspensa também recebe 401. O login OAuth do SyncZap só aceita ChatGPT, Claude e Claude Code, então este cliente precisa da chave.

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 uma chave com Envio de mensagens e um plano com envio por agentes (Plus, Pro, Max e Business e o teste). Se a chave é só de leitura, gere outra em Acesso API marcando Envio de mensagens e troque no arquivo.

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

A chave e o ID valem para uma organização só. Para outra, gere uma chave nela e use o ID dela.

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?

Em Acesso API, revogue a chave. O cliente perde o acesso na próxima chamada.

Perguntas frequentes

O Zed vê todas as minhas conversas?

Não. O Zed 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.

Por que este cliente usa chave de API em vez de login?

O login OAuth do SyncZap aceita hoje o ChatGPT, o Claude e o Claude Code. Para os demais clientes, a chave de API da organização com o cabeçalho X-SyncZap-Workspace dá o mesmo acesso, com as permissões marcadas na chave. O SyncZap guarda só o hash da chave.

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 Zed Industries. 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?