O conector é um endereço que você adiciona no seu assistente. A partir dali, pedir “avise a Ana que o orçamento saiu” faz a mensagem sair pelo seu número de WhatsApp — com autorização por OAuth na tela do zapon, envio restrito aos contatos que você cadastrou e as travas de ritmo cumpridas pelo servidor, não pela IA.
Assistentes de IA passaram a falar um protocolo comum para usar ferramentas externas, o MCP. Quem publica um conector nesse protocolo entrega ao assistente uma lista de ações e o que cada uma faz; a partir daí a conversa em linguagem natural vira chamada de verdade. O zapon publica o número conectado como uma dessas ferramentas.
A pergunta que essa facilidade levanta é a certa: se a IA pode escrever no WhatsApp, o que impede um pedido mal formulado de virar disparo em massa pelo seu número? A resposta desta página é a arquitetura — quem decide o que sai não é o modelo, é o servidor.
Ele expõe o seu número de WhatsApp como ferramenta para o assistente de IA que você já usa: você adiciona um endereço na sua IA, autoriza uma vez, e passa a pedir envios em português comum. A mensagem sai pelo número que está conectado no seu painel, e todas as regras de proteção do zapon continuam valendo — inclusive quando quem pede é uma máquina.
O endereço é sempre https://zapon.dev/api/mcp, o mesmo para qualquer assistente. O que separa uma conta da outra é a autorização: quem manda por ali é o número que você autorizou, e nenhum outro. A tela MCP do painel mostra o endereço pronto para copiar, a lista de contatos permitidos e um botão para revogar todos os acessos de uma vez.
As ações disponíveis são poucas e nomeadas em português: enviar uma mensagem de texto, validar se um número tem WhatsApp, listar, adicionar, editar e remover contatos da lista de permitidos, além do conjunto que monta, simula, liga e desliga o chatbot. Não há ação de leitura de conversa alheia, de busca de números e de envio para lista.
Em lugar nenhum — e isso é intencional. Ao adicionar o endereço, a própria IA abre uma tela do zapon no seu navegador pedindo que você autorize aquele acesso. Você confirma logado na sua conta, e a IA recebe uma credencial de acesso que ela guarda sozinha. O token da conexão, que dá poder de envio sobre o número, nunca passa pelo histórico da conversa nem por um arquivo de configuração.
A diferença prática aparece no dia em que algo dá errado. Token colado em arquivo de configuração vive em três lugares que você esqueceu: o backup da máquina, a captura de tela que virou anexo, o repositório onde o arquivo entrou sem querer. Autorização por OAuth não tem esse rastro — e some inteira quando você aperta Revogar acessos na tela MCP, sem precisar trocar o token da conexão nem mexer nas integrações que usam a API.
Vale a mesma disciplina de qualquer autorização: autorize a partir do navegador em que você está logado na sua conta, confira o endereço na barra antes de confirmar e revogue quando parar de usar aquele assistente.
Quatro caminhos foram verificados: o Claude nas três formas (claude.ai, aplicativo de mesa e linha de comando), pelo menu de Conectores, adicionando um conector personalizado; o ChatGPT, pelo menu de Conectores em modo desenvolvedor, criando um conector com OAuth; o Codex CLI, por comando; e o Gemini CLI, por arquivo de configuração. Todos usam o mesmo endereço e a mesma autorização.
Nos dois primeiros o trabalho é de menu: procure a área de conectores, escolha adicionar um conector personalizado (no ChatGPT, ligue antes o modo desenvolvedor), cole o endereço e siga a tela de autorização que abre. Nos dois de linha de comando, o registro é escrito:
codex mcp add zapon --url https://zapon.dev/api/mcp
codex mcp login zapon # abre a tela de autorização do zapon no navegadorNo Gemini CLI o conector entra no bloco mcpServers do arquivo de configuração, como servidor HTTP com autorização ligada:
{
"mcpServers": {
"zapon": {
"httpUrl": "https://zapon.dev/api/mcp",
"oauth": { "enabled": true }
}
}
}Depois de conectado, a tela MCP do painel passa a exibir a marca IA conectada naquele número. É o jeito mais rápido de saber se a autorização foi concluída de verdade ou parou no meio.
Não. O aplicativo web do Gemini não fala o protocolo MCP, então não existe onde colar o endereço — não é limitação do zapon nem configuração escondida. No Gemini, o caminho é a versão de linha de comando, o Gemini CLI, que aceita o conector pelo bloco mcpServers. Se você precisa de navegador, use o Claude em claude.ai ou o ChatGPT em modo desenvolvedor.
Essa é, disparado, a dúvida que mais gera tempo perdido: a pessoa procura “conectores” no Gemini web, não encontra, e conclui que o conector está quebrado. Não está. Suporte a MCP é decisão de cada fabricante e muda com o tempo — o que vale hoje está escrito aqui e na tela MCP do painel.
Não. Ela só alcança contatos que estão na lista de permitidos daquele número, cadastrados com nome. Qualquer telefone fora da lista é recusado antes de o envio existir, com o motivo fora_da_whitelist. E cada número, ao entrar na lista, é validado no WhatsApp: telefone sem conta simplesmente não é aceito, então cadastro velho não vira envio queimado.
A lista se administra pelos dois lados. No painel, na tela MCP, você adiciona, edita e remove contatos à mão. Pela conversa, a IA usa as ações de contato — e ao adicionar, o nome é obrigatório, porque é por ele que você vai pedir o envio depois (“manda para a Ana” em vez de ditar treze dígitos). Se o número de um contato mudar, a edição revalida o novo número no WhatsApp antes de aceitar.
É a whitelist que transforma o conector em algo diferente de um disparador. O universo de destinos não é “quem a IA conseguir descobrir”: é uma lista curta, feita por você, auditável em uma tela.
O ritmo não é responsabilidade de quem pede. Entre um envio e o seguinte existe uma pausa aleatória de 8 a 20 segundos, cumprida pelo próprio zapon: se a IA chamar antes da hora, a chamada fica aguardando o tempo que falta e só então envia. Não há como acelerar pedindo com mais ênfase, nem por engano, nem de propósito.
A consequência aparece no relógio: um pedido de dez mensagens leva minutos, e a IA fica esperando. Isso é comportamento correto, não lentidão — a descrição da ferramenta avisa o modelo para aguardar a resposta em vez de cancelar e repetir a chamada, o que só duplicaria mensagens.
Até 300 por dia por número conectado — cerca de 9.000 por mês —, com renovação à meia-noite de Brasília. Toda resposta do conector devolve o consumo do dia: usado, limite, restante e percentual. Ao cruzar 80%, 90%, 95% e 100%, vem um aviso junto, para a IA te avisar e priorizar o que ainda falta em vez de descobrir o limite quando ele já bateu.
Ao atingir 100%, o envio passa a ser recusado com o motivo limite_diario e a resposta informa o horário da renovação. Nada se perde em silêncio: a IA sabe que não enviou e por quê, e pode retomar depois. A cota é por número, não por conta — dois números conectados têm 300 cada um, contados em separado.
O preço não muda com o volume: R$ 27 por mês por número conectado, sem cobrança por mensagem, dentro dessa cota. O teste é de 14 dias sem cartão e só começa a contar quando o primeiro número conecta.
Dá, e é um dos usos mais úteis do conector. A IA conduz a entrevista — nome do assistente, primeira mensagem, quais botões o cliente vê, o que acontece em cada botão —, grava a configuração, roda o simulador nos caminhos principais e só então liga. O passo do simulador não é sugestão: ligar é recusado enquanto o roteiro de teste não estiver completo.
O roteiro cobre os caminhos que quebram bot na vida real: o caminho feliz, a resposta que não bate com botão nenhum, o pedido de falar com uma pessoa, a chegada fora do horário e o caso em que você mesmo entra na conversa pelo WhatsApp. Passar por eles antes de ligar evita a estreia constrangedora com o cliente do outro lado.
Toda a configuração fica no mesmo lugar de sempre: o que a IA monta aparece na tela Chatbot do painel, e o que você editar no painel é o que a IA lê depois. Os detalhes do que dá para configurar estão em chatbot de WhatsApp com menus.
Não. Ele não acessa a agenda do seu telefone, não lê o histórico das suas conversas e não descobre números novos. A única lista que existe é a whitelist que você cadastrou, e o único sentido do tráfego é de saída: da IA para os contatos permitidos. Quem precisa receber e processar mensagens recebidas usa o webhook, que é outra coisa.
Ferramenta boa não conserta uso ruim. As travas do conector cobrem ritmo e destino, mas não sabem se a pessoa do outro lado quer receber a sua mensagem — e é isso que decide se o número vive muito ou pouco. A régua é simples: escreva para quem espera contato seu, mande uma mensagem que resolve algo, e pare de mandar quando pedirem para parar.
Não. No Claude e no ChatGPT o caminho inteiro é de menu: adicionar o endereço, autorizar na tela do zapon e pedir o envio em português. Programação só aparece se você escolher os assistentes de linha de comando, e ainda assim o trabalho é copiar um comando ou um bloco de configuração.
Não. O envio é sempre consequência de um pedido seu na conversa. O conector não tem agendamento próprio, não roda em segundo plano e não dispara por conta própria; ele só existe enquanto o assistente está executando o que você acabou de pedir.
Pode. Cada assistente faz a própria autorização e todos passam a usar o mesmo número, a mesma whitelist e a mesma cota diária de 300 envios — que é do número, não de cada IA. O botão Revogar acessos derruba todas de uma vez, e a autorização é refeita depois em quem você quiser manter.
Não. Revogar derruba as autorizações das IAs e nada além disso. A lista de contatos permitidos, o chatbot, o webhook e o token da conexão continuam intactos; basta autorizar de novo para o assistente voltar a enviar.
Funciona, e cada número é um mundo à parte: autorização própria, whitelist própria e cota própria de 300 mensagens por dia. Na tela MCP você escolhe de qual conexão está falando antes de copiar o endereço, e a autorização vale para aquela conexão.
Porque a pausa de 8 a 20 segundos entre envios é cumprida pelo servidor. Se o pedido anterior foi recente, a chamada aguarda o tempo que falta antes de enviar, em vez de recusar. É comportamento esperado: espere a resposta chegar, não cancele nem repita o pedido, ou a mesma mensagem pode sair duas vezes.
Não pelo envio. O conector é canal de saída: ele manda a mensagem e devolve o resultado. Para tratar o que chega, o caminho é o webhook da API, que entrega cada evento ao seu sistema. A exceção é a fila do chatbot, em que a IA consegue listar quem pediu atendimento humano e marcar quem já foi atendido.
Não. O número entra por QR Code ou código de pareamento no painel, sem fila de aprovação e sem cadastro prévio de mensagem. O conector usa esse mesmo número já conectado, e o custo é o de sempre: R$ 27 por mês por número, sem cobrança por mensagem.
14 dias grátis, sem cartão — a contagem só começa na primeira conexão. R$ 27 por mês por número, sem cobrança por mensagem.