O showroom entrega o interessado, o consultor monta a proposta — e depois disso o negócio some numa conversa que ninguém retomou. Com a API do zapon, o sistema da loja confirma o test drive, retoma a proposta parada no prazo certo, avisa a revisão programada e reabre o cliente que sumiu, recebendo cada resposta por webhook para virar tarefa do consultor.
Loja de veículos raramente perde negócio por falta de interessado. Perde no intervalo: a pessoa fez test drive na quinta, recebeu a proposta na sexta, e na segunda ninguém retoma porque o consultor está no salão com outro cliente e a planilha de propostas abertas tem quarenta linhas iguais.
Esse intervalo é operacional, não comercial — e por isso dá para tratá-lo com software. O zapon expõe uma API de WhatsApp REST simples — header token, JSON entrando e saindo — que o sistema da loja ou a rotina de pós-venda chamam como chamariam qualquer serviço. Abaixo: os quatro gatilhos do ciclo do veículo, os endpoints em cURL e Node, o evento que chega quando o cliente responde e os limites que impedem o número da loja de virar número de propaganda.
Porque comprar carro é decisão compartilhada e demorada: a pessoa precisa conversar em casa, comparar a avaliação do usado, ver o que sobra de parcela. Nesse intervalo ela não diz não — ela só para de responder. O consultor interpreta silêncio como recusa e passa para o próximo interessado, quando o que faltava era uma retomada no quarto dia, com a proposta ainda válida e o veículo ainda no pátio.
São quatro perdas diferentes na mesma loja, e cada uma tem um remédio próprio:
Porque o acompanhamento compete com a venda do dia, e quem está na frente do consultor sempre parece mais próximo de fechar do que a proposta de terça. O resultado é conhecido: no dia 28 alguém puxa a lista de propostas abertas e liga para todo mundo de uma vez, tarde demais. Um disparo por gatilho — quatro dias depois da proposta, um dia antes do test drive, um mês antes da revisão — não depende de sobrar tempo.
Três coisas: um número de WhatsApp da loja, uma conexão no zapon com esse número lido por QR Code ou código de pareamento, e um lugar que saiba dos fatos — o sistema de vendas, a agenda de test drive ou a planilha de propostas. Não é preciso servidor próprio, conta na Meta, aprovação de template nem aplicativo instalado em aparelho nenhum.
token, credencial de todas as chamadas daquele número. Se a loja separa vendas de pós-venda em dois números, são duas conexões — e a oficina não escreve com o token do salão.Serve, e o ganho costuma ser maior. A revenda não tem plano de manutenção de fábrica nem sistema da montadora impondo processo, então o acompanhamento depende inteiramente da disciplina da loja — que é justamente o que a rotina automatizada fornece. Os gatilhos mudam de nome: em vez de revisão programada, retorno de garantia da loja; em vez de proposta com tabela da marca, proposta com avaliação do usado e prazo curto.
Os dois caminhos funcionam. Se o sistema da loja permite chamar uma URL quando a proposta é emitida, ele mesmo chama a API. Se é fechado, coloque uma rotina no meio, lendo um relatório diário e disparando dali. A API pede sempre telefone e texto, então o que muda é apenas de onde esses campos saem.
Cinco etapas: (1) o test drive agendado recebe confirmação com data, endereço e o que levar; (2) quatro dias depois da proposta emitida, uma retomada pergunta se a condição ainda faz sentido; (3) um mês antes da janela da revisão programada, sai o aviso com a quilometragem de referência; (4) o cliente sem contato há muito tempo recebe uma única reabertura, com saída fácil; (5) toda resposta volta por webhook e vira tarefa nominal do consultor ou do consultor de serviços.
Os quatro gatilhos são independentes: dá para ligar um, medir por um mês e só então ligar o próximo. Não tente subir os quatro na mesma semana.
A mensagem de agendamento resolve três coisas de uma vez: registra o combinado por escrito, avisa o que a pessoa precisa levar e abre um caminho de um toque para desmarcar. A CNH é o detalhe que mais derruba test drive — cliente que chega sem carteira física ou com habilitação vencida não dirige, e a visita vira frustração dos dois lados. Diga isso na confirmação, não na portaria.
Na véspera sai um lembrete curto. "Seu test drive é amanhã" vale menos do que "o SUV prata 1.4 turbo que você viu está separado para amanhã às 10h" — a segunda reconstrói a memória da visita.
Escolha um prazo e cumpra: entre três e cinco dias da emissão costuma ser onde a lembrança ainda existe e a condição ainda vale. A retomada não repete a proposta — ela oferece um caminho. Três botões dão conta do estado real do negócio: Seguir, Preciso pensar e Desisti. O terceiro botão parece contra o interesse da loja e é o mais valioso: transforma silêncio em informação e libera o consultor de perseguir quem já decidiu.
Duas regras evitam constrangimento. A retomada precisa ler a situação da proposta no instante do envio — proposta já assinada, veículo já vendido para outro cliente ou avaliação do usado vencida cancelam o disparo. E uma proposta gera uma retomada automática; a segunda conversa é do consultor, com o nome dele, ou não é conversa nenhuma.
A revisão tem dois marcadores — meses desde a entrega e quilometragem estimada — e o aviso deve citar os dois, porque o cliente não sabe qual está mais perto. Trinta dias antes da janela, uma mensagem com o modelo, a placa, a revisão da vez e a faixa de quilometragem, mais um convite para escolher o dia. É a mensagem mais bem recebida de todo o fluxo: ela evita perder garantia e evita o cliente descobrir tarde demais que passou do prazo.
Aqui vale o /chat/send/document: o espelho da revisão em PDF, com o que está incluído e o que é cobrado à parte, encerra metade das perguntas antes de o cliente chegar na oficina. Não mande valor de peça se o preço muda entre a cotação e a execução — mande o escopo e diga que o orçamento é confirmado na recepção do veículo.
Reabrir não é ofertar. A mensagem de retorno funciona quando tem um motivo verdadeiro e específico: o veículo dele completou o tempo típico de troca, a revisão passou da janela, o test drive de dois meses atrás ficou sem desfecho. E precisa carregar a saída no próprio texto — uma frase dizendo como pedir para não receber mais. Uma tentativa, um motivo, uma saída. Quem não responde a essa mensagem não recebe a segunda: entra numa lista que o consultor trabalha à mão, se quiser.
O que essa mensagem nunca deve conter: condição de financiamento, promessa de aprovação de crédito, valor de parcela ou qualquer número que dependa de análise. Isso é assunto de proposta formal, não de mensagem de reativação.
O webhook entrega, a sua regra interpreta e a ação acontece no sistema da loja: o test drive muda de status, a proposta ganha um desfecho, a revisão vira agendamento na oficina e o pedido de descadastro grava um campo que todas as rotinas consultam. O que a regra não reconhecer vira pendência nominal — com telefone, veículo e o texto do cliente — para o consultor responder no próprio WhatsApp.
Quatro resolvem: POST /chat/send/text para as mensagens do fluxo, POST /chat/send/buttons para o desfecho da proposta e a confirmação do test drive, POST /chat/send/document para o espelho da revisão ou a proposta em PDF, e POST /user/check para conferir quais telefones da base de compradores ainda têm WhatsApp. Todos na base https://api.zapon.dev, com o header token. São 49 endpoints publicados, todos com schema — o ciclo do veículo vive nesses quatro.
A credencial é o header token e só ele, copiado da conexão no painel. Não existe Bearer, não existe OAuth, não existe segunda chave. Quem segura esse valor fala em nome da loja, então ele mora em variável de ambiente, nunca no código de um site público.
Um POST em /chat/send/text com dois campos obrigatórios: Phone, o número em formato internacional só com dígitos, e Body, o texto.
curl -X POST https://api.zapon.dev/chat/send/text \ -H "token: SEU_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "Phone": "5511999999999", "Body": "Rodrigo, seu test drive está agendado.\n\nVeículo: SUV 1.4 turbo, versão Comfort, prata\nData: sábado, 14/03, às 10h\nOnde: Loja Exemplo — Av. das Indústrias, 2400\nConsultor: Daniel\n\nLeve a CNH física ou digital dentro da validade — sem ela não conseguimos liberar a direção. Se precisar mudar o horário, responda por aqui." }'
A resposta traz o identificador da mensagem dentro do WhatsApp:
{
"code": 200,
"success": true,
"data": {
"Details": "Sent",
"Id": "90B2F8B13FAC8A9CF6B06E99C7834DC5",
"Timestamp": "2026-03-13T09:12:08-03:00"
}
}Guarde esse Id no registro do test drive. Ele prova qual mensagem saiu e quando, e impede que uma rotina executada duas vezes na sexta mande a mesma confirmação duas vezes.
O /chat/send/buttons envia botões de resposta rápida, com rótulo curto — o WhatsApp corta texto longo, então até vinte caracteres é a regra prática. Cada botão carrega um id que você define, e é esse identificador que volta no webhook: coloque o número da proposta ali dentro e a resposta chega amarrada ao registro certo, sem interpretar texto. Além da resposta rápida, o mesmo endpoint monta botão que abre um link ("type": "cta_url"), botão que abre o discador ("type": "cta_call") e botão que copia um código ("type": "copy") — e os tipos convivem na mesma mensagem. O toque em resposta rápida volta no webhook; os outros três agem no aparelho de quem recebe.
POST https://api.zapon.dev/chat/send/buttons token: SEU_TOKEN { "Phone": "5511999999999", "Body": "Rodrigo, sobre a proposta 4821 do SUV 1.4 turbo prata que o Daniel te passou na sexta: como você prefere seguir?", "Footer": "Loja Exemplo — Vendas", "Buttons": [ { "id": "pr4821|seguir", "text": "Seguir" }, { "id": "pr4821|pensar", "text": "Preciso pensar" }, { "id": "pr4821|desisti", "text": "Desisti" } ] }
Repare no que a mensagem não faz: não repete valores, não pressiona com prazo inventado e não promete condição nenhuma. Ela pergunta o estado do negócio. Se a loja precisar de mais opções — escolher entre três horários de test drive, por exemplo —, o /chat/send/list entrega um menu em lista.
O /chat/send/document recebe o arquivo em data URI base64, o nome com que ele aparece na conversa e uma legenda opcional. O nome do arquivo é parte da mensagem: revisao-40000km-placa-ABC1D23.pdf se explica sozinho na lista de mídia do cliente seis meses depois; anexo.pdf não.
curl -X POST https://api.zapon.dev/chat/send/document \ -H "token: SEU_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "Phone": "5511999999999", "Document": "data:application/pdf;base64,JVBERi0xLjQKJcfs…", "FileName": "revisao-40000km-placa-ABC1D23.pdf", "Caption": "Escopo da revisão de 40.000 km do seu veículo: o que está incluído e o que é cobrado à parte. O orçamento final é confirmado na recepção." }'
O padrão é uma rotina agendada — um horário fixo pela manhã — que busca as propostas emitidas há quatro dias, filtra as que ainda estão de pé e chama a API. Em Node:
// propostas-paradas.js — roda todo dia útil às 9h30 const API = "https://api.zapon.dev"; const TOKEN = process.env.ZAPON_TOKEN; async function enviarBotoes(phone, body, buttons) { const r = await fetch(`${API}/chat/send/buttons`, { method: "POST", headers: { "token": TOKEN, "Content-Type": "application/json" }, body: JSON.stringify({ Phone: phone, Body: body, Footer: "Loja Exemplo", Buttons: buttons }) }); const json = await r.json(); if (!r.ok || !json.success) throw new Error(json.error || `HTTP ${r.status}`); return json.data.Id; } const respiro = (ms) => new Promise((r) => setTimeout(r, ms)); for (const p of await propostasEmitidasHa(4)) { if (p.situacao !== "aberta") continue; // assinada ou perdida: não retoma if (p.veiculo.status !== "disponivel") continue; // já vendido para outro if (p.cliente.naoPerturbe || p.retomadaEnviada) continue; try { const id = await enviarBotoes(p.cliente.telefone, `${p.cliente.nome}, sobre a proposta ${p.numero} do ${p.veiculo.descricao} ` + `que o ${p.consultor.nome} te passou: como você prefere seguir?`, [ { id: `pr${p.numero}|seguir`, text: "Seguir" }, { id: `pr${p.numero}|pensar`, text: "Preciso pensar" }, { id: `pr${p.numero}|desisti`, text: "Desisti" } ]); await marcarRetomada(p.numero, id); // uma retomada por proposta } catch (e) { await registrarFalha(p.numero, "retomada", String(e)); // vira tarefa do gerente } await respiro(5000); // a carteira inteira no mesmo segundo não parece loja }
Quatro linhas desse laço separam a rotina que dura da que constrange na primeira semana. Os continue impedem retomada de proposta assinada, de veículo já vendido e de quem pediu para não receber. O marcarRetomada garante uma tentativa por proposta. E o intervalo mantém um ritmo compatível com uma loja de verdade.
Base de loja acumula número de dez anos, telefone fixo de recado e o celular do cônjuge cadastrado no lugar do titular. O POST /user/check recebe uma lista e diz quais têm conta no WhatsApp — útil antes de qualquer trabalho sobre a base de pós-venda.
curl -X POST https://api.zapon.dev/user/check \ -H "token: SEU_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "Phone": ["5511999999999", "5511888888888"] }' // resposta { "code": 200, "success": true, "data": { "Users": [ { "Query": "5511999999999", "IsInWhatsapp": true, "JID": "[email protected]" }, { "Query": "5511888888888", "IsInWhatsapp": false, "JID": "" } ] } }
Uma ressalva que vale repetir: descobrir que o número existe não autoriza escrever para ele. O /user/check resolve base suja, não consentimento.
Cada conexão tem um webhook próprio: você cadastra no painel a URL do seu sistema e escolhe os eventos. A partir daí, toda mensagem recebida naquele número vira um POST nessa URL, com o conteúdo inteiro no corpo — telefone, identificador, horário, texto e, quando é resposta de botão, o id que você definiu. É assim que "o cliente desistiu da proposta 4821" chega ao sistema sem ninguém copiar nada da tela do celular.
Vale separar os papéis antes de escrever a primeira linha: entregar é do webhook, entender é do seu código, agir é do sistema da loja. Do lado do WhatsApp ninguém sabe o que é proposta ou revisão — existe apenas uma mensagem que chegou naquele número.
O corpo traz o tipo do evento e a mensagem completa. Assim chega quem escreveu "pode ser" em texto:
{
"type": "Message",
"event": {
"Info": {
"ID": "3EB0C767D26A1B5F7C83",
"Chat": "[email protected]",
"Sender": "[email protected]",
"IsFromMe": false, "IsGroup": false,
"PushName": "Rodrigo Prado",
"Timestamp": "2026-03-17T10:41:22-03:00"
},
"Message": { "conversation": "pode ser" }
}
}
// tocando num botão, muda só o bloco Message:
"Message": { "buttonsResponseMessage": {
"selectedButtonID": "pr4821|desisti",
"Response": { "SelectedDisplayText": "Desisti" }
} }Dois detalhes poupam uma tarde de investigação. O corpo às vezes chega como JSON puro e às vezes como formulário codificado, com o JSON dentro de um campo: aceite as duas formas. E tudo que sai do próprio número também vira evento, marcado com IsFromMe verdadeiro — sem esse filtro, o consultor digitando no aparelho dispara a sua automação.
Descarte o que não interessa, encontre o registro, decida pela intenção e devolva uma frase curta confirmando o que foi feito.
app.post("/zapon/eventos", express.json(), async (req, res) => { res.sendStatus(200); // responda primeiro, processe depois const ev = req.body?.event ?? req.body, info = ev?.Info ?? {}; if (info.IsFromMe || info.IsGroup) return; // o que a loja enviou, e grupos, fora if (await jaTratado(info.ID)) return; // o mesmo evento pode chegar 2x const telefone = String(info.Chat || "").split("@")[0]; const botao = ev?.Message?.buttonsResponseMessage?.selectedButtonID ?? ""; const texto = (ev?.Message?.conversation ?? ev?.Message?.extendedTextMessage?.text ?? "").trim().toLowerCase(); if (/(parar|nao quero mais|não quero mais|descadastr)/.test(texto)) { await marcarNaoPerturbe(telefone); // vale para TODAS as rotinas return enviarTexto(telefone, "Certo, não enviamos mais avisos por aqui."); } const [chave, acao] = botao ? botao.split("|") : [null, null]; if (acao === "seguir") { await priorizarProposta(chave); // topo da fila do consultor return enviarTexto(telefone, "Ótimo. O consultor te chama ainda hoje."); } if (acao === "pensar") { await adiarProposta(chave, 7); // sem novo disparo automático return enviarTexto(telefone, "Combinado. Fico à disposição por aqui."); } if (acao === "desisti") { await encerrarProposta(chave, "desistencia"); await liberarVeiculo(chave); // volta para a vitrine return enviarTexto(telefone, "Obrigado por avisar. Qualquer coisa, é só chamar."); } return filaDoConsultor(telefone, texto); // o resto é assunto de gente });
Ele vai perguntar — "quanto fica em 48 vezes?", "quanto vocês dão no meu carro?", "aprova com nome sujo?". Não responda nada disso automaticamente. Parcela depende de análise, avaliação de usado depende de vistoria presencial, e número errado por escrito volta na mesa de negociação como promessa. Essas mensagens viram pendência nominal do consultor daquele cliente, com telefone, número da proposta e o texto original. O papel da automação é apontar a conversa que espera alguém — quem negocia é a loja.
Não como lista de disparo. Mensagem sobre um fato do próprio cliente — test drive que ele marcou, proposta que ele pediu, revisão do veículo que ele comprou — é atendimento esperado. Feirão, condição do mês e lançamento são publicidade: exigem consentimento registrado, com data, e um caminho de saída que funcione. Misturar os dois no mesmo canal é o jeito mais rápido de o número da loja ser denunciado por quem só queria agendar uma revisão.
naoPerturbe fez no exemplo. O pedido chega em qualquer palavra, então alguém precisa olhar a fila de exceções todo dia.R$ 27 por mês por número conectado, sem cobrança por mensagem: o valor não muda entre 80 e 5.000 mensagens no mês. Cada número conectado tem cota de 300 mensagens por dia, mais do que o funil de test drive e proposta de uma loja consome, e ela existe para o número da concessionária não cair por excesso de disparo. O teste é de 14 dias sem cartão e só começa a contar na primeira conexão — dá para criar a conta, integrar com o sistema da loja com calma e conectar o número quando a rotina estiver pronta.
Essa previsibilidade é o que viabiliza a régua completa. Entre confirmação de test drive, lembrete de véspera, retomada de proposta e dois avisos de revisão por ano, um único cliente recebe meia dúzia de mensagens ao longo do ciclo. Com cobrança por mensagem, o custo cresceria com o movimento até alguém cortar justamente o aviso de revisão — o de menor volume aparente e maior retorno. Com duas áreas ou duas lojas, é uma conexão para cada, e o seu sistema escolhe de qual número a mensagem sai trocando o header token.
O estado de cada conexão aparece no painel e é atualizado a cada 10 segundos com a página aberta. Como ninguém fica olhando tela em sábado de movimento, assine também os eventos de conexão no webhook: Disconnected para a queda, LoggedOut para quando o número precisa ler o QR Code de novo. Junte a isso a lista de falhas que o registrarFalha alimenta, conferida uma vez por dia por alguém do salão. Confirmação de test drive que não saiu tem de aparecer em algum lugar, e não em lugar nenhum.
Funciona sempre que esse sistema conseguir fazer uma chamada HTTP ou expor os dados de alguma forma. Se ele tem área de integrações, chama a API direto quando a proposta é emitida ou o test drive é agendado. Se é fechado, leia os dados por fora — relatório diário, banco, exportação — e dispare com uma rotina ou uma ferramenta de automação no meio.
Dá. O que a rotina precisa é de nome, telefone, placa, modelo e a data ou quilometragem de referência da próxima revisão. Uma planilha com essas colunas alimenta o disparo mensal tão bem quanto um sistema, desde que alguém a mantenha atualizada e que a rotina respeite o campo de descadastro.
Não pela automação. Parcela, entrada e taxa dependem de análise e mudam de um dia para o outro; número errado por escrito vira promessa na mesa de negociação. A automação avisa que existe uma proposta e pergunta como o cliente quer seguir — os valores ficam no documento formal e na conversa com o consultor.
Uma vez de forma automática. A segunda tentativa deve ser do consultor, com nome e contexto, ou não deve existir. Régua automática que insiste não recupera negócio: transforma um cliente indeciso em alguém que bloqueia o número da loja.
R$ 27 por mês por número conectado, sem cobrança por mensagem, com cota de 300 mensagens diárias por número. O teto sobra para o volume de leads de portal que uma loja trabalha por dia e age como proteção: é ele que impede a rajada capaz de derrubar o número da concessionária. O teste é de 14 dias sem cartão e só começa a contar quando você conecta o primeiro número.
Pode — em qualquer API, inclusive na oficial da Meta. O risco não é eliminável, é gerenciável: fale de fatos do próprio cliente, não transforme a base de compradores em lista de oferta, mantenha volume compatível com o tamanho da operação e pare de enviar para quem pediu para sair. O que dispara bloqueio é mensagem não solicitada em massa, não o uso de API.
Não precisam, mas costuma valer em operação com oficina movimentada: uma conexão para o salão e outra para o serviço evitam que o cliente agendando revisão receba retomada de proposta no meio. Cada conexão tem o seu token e o seu webhook, e a cobrança é por número conectado.
Não. O número é conectado por QR Code ou código de pareamento, sem fila de aprovação, sem cadastro de template e sem custo por mensagem. Em compensação, a boa conduta do número é responsabilidade da loja.
14 dias grátis, sem cartão — a contagem só começa quando você conectar o número. Crie a conta, leia o QR Code e confirme o próximo test drive pelo sistema da loja.