Quatro avisos sustentam a carteira de uma corretora e de uma administradora: a vigência que está para acabar, o documento que falta no sinistro, a parcela que vence e a contemplação que precisa ser comunicada. Com a API do zapon, o sistema da corretora dispara cada um no prazo certo e recebe a resposta — inclusive a foto do documento — por webhook.
A carteira de uma corretora é feita de datas. Vigência que termina, parcela que vence, prazo de entrega de documento na regulação do sinistro, assembleia que acontece todo mês. Nenhuma dessas datas é surpresa: todas estão no sistema há meses. O que falta é o aviso sair sozinho, sem depender de alguém puxar o relatório de vencimentos numa sexta cheia.
É isso que uma API de WhatsApp resolve. O zapon expõe uma API REST direta — header token, JSON entrando e saindo — que o sistema de gestão da corretora, o controle de cotas da administradora ou a rotina de vencimentos chamam como chamariam qualquer serviço. A seguir: os quatro avisos do ciclo, os endpoints em cURL e Node, o evento que chega quando o cliente responde ou manda uma foto, e as linhas que uma comunicação de seguro e de consórcio não pode cruzar.
Porque ele não pensa no seguro durante os onze meses em que nada acontece. A comunicação de renovação costuma sair por carta ou por e-mail que ninguém abre, e o telefone que a corretora tem em cadastro toca no meio do expediente da pessoa. Quando o assunto vira urgente — um carro amassado, uma casa alagada — é tarde para descobrir que a cobertura terminou há dez dias.
São quatro furos, cada um com um custo diferente:
Porque o relatório de um mês tem centenas de linhas e a equipe de retenção tem três pessoas. A ligação chega em horário ruim, cai na caixa postal e não deixa rastro: ninguém sabe se o cliente foi avisado. Uma mensagem escrita fica na conversa, pode ser relida à noite e — quando ele responde — vira um evento com telefone, horário e conteúdo dentro do sistema da corretora.
Três peças: um número de WhatsApp da corretora, uma conexão no zapon com esse número lido por QR Code ou código de pareamento, e uma fonte de datas — o sistema de gestão, o controle de cotas ou um relatório de vencimentos. 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. Corretora que separa seguros de consórcio em dois atendimentos costuma manter duas conexões — assim o consorciado não recebe aviso de vigência de auto.Serve para as duas: um contrato com datas, um cliente que precisa saber delas e um documento que às vezes vai ou volta. Muda o vocabulário — cota, grupo, assembleia e carta de crédito de um lado; apólice, vigência, endosso e sinistro do outro — e muda o que é proibido dizer, assunto de uma seção inteira mais adiante.
Cinco etapas: (1) a rotina de vigência avisa o cliente com antecedência e abre caminho para falar com o corretor; (2) quando um sinistro está aberto, a corretora pede por escrito o documento que falta e recebe a foto pelo próprio WhatsApp; (3) o boleto da parcela vai como PDF antes do vencimento, com regras rígidas contra golpe; (4) a contemplação é comunicada como fato, com o que fazer em seguida; (5) toda resposta volta por webhook e vira tarefa nominal de quem cuida daquele cliente.
Cada aviso tem um prazo próprio e nenhum deles vende nada. Ligue um por vez.
Antecedência é tudo. Um aviso a trinta dias dá tempo de conversar, ajustar coberturas e comparar condição; um aviso na véspera só serve para o cliente descobrir que ficou sem cobertura. A mensagem cita o número da apólice, o bem segurado de forma genérica (o veículo pela placa, o imóvel pelo bairro) e a data final da vigência — e termina oferecendo o caminho humano: falar com o corretor responsável.
O que essa mensagem não faz: não apresenta valor de renovação, não anuncia condição especial e não pede pagamento. Ela avisa uma data e abre uma conversa. Preço de renovação depende de análise e é assunto do corretor, com proposta formal — não de uma mensagem automática que a pessoa lê no ponto de ônibus.
O sinistro é o momento em que a corretora é julgada. E é onde o WhatsApp rende mais, porque o cliente está com o celular na mão, muitas vezes na rua, e a foto do documento sai dali mesmo. A mensagem precisa ser específica ao ponto do constrangimento: em vez de "faltam documentos", escreva "falta a foto do documento do veículo (CRLV) e o boletim de ocorrência; pode mandar aqui mesmo, uma foto por vez".
Quando o cliente responde com a imagem, o webhook entrega o evento — e é o seu sistema que anexa ao processo e marca o item como recebido. Se o processo exige arquivo em formato específico, diga isso na mensagem: a foto de tela de um PDF costuma voltar como pendência.
Parcela de consórcio e prêmio parcelado seguem calendário fixo, então o envio é previsível: três dias antes do vencimento, o PDF do boleto vai por /chat/send/document, com nome de arquivo que se explica sozinho e uma legenda curta com valor e data. Só isso.
E aqui entra a regra mais importante desta página: a mensagem nunca muda dados de pagamento. Não manda chave PIX nova, não avisa troca de banco, não pede pagamento em conta de pessoa física, não anexa boleto com desconto por antecipação inventado. Golpe de boleto usa exatamente esse formato, e o cliente que cair vai — com razão — cobrar a corretora. Escreva uma frase fixa em toda mensagem de cobrança dizendo que os dados nunca mudam por mensagem e que, na dúvida, o cliente confira pelo canal oficial da administradora.
A contemplação é um fato consumado quando você comunica: aconteceu na assembleia, está registrada, e o consorciado precisa saber o que fazer em seguida — quais documentos apresentar, qual o prazo e com quem falar. A mensagem é curta, informativa e nominal ao grupo e à cota.
O que a automação jamais deve fazer é falar de contemplação no futuro. Nada de "sua cota está próxima de ser contemplada", "com um lance você garante a contemplação" ou qualquer estimativa de quando isso vai acontecer. Além de não ser verdade — contemplação depende de sorteio e de lance dentro do grupo —, esse tipo de mensagem transforma um aviso operacional em promessa de resultado. Comunique o que já ocorreu; o resto é conversa do consultor, com as regras do contrato na mão.
O webhook entrega, a sua regra interpreta e a ação acontece no seu sistema: a apólice entra na fila de retenção, o item do sinistro é marcado como recebido, a parcela ganha um lembrete de acompanhamento 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, número do contrato e o texto do cliente — para o corretor responder no próprio WhatsApp.
Quatro dão conta: POST /chat/send/text para os avisos, POST /chat/send/buttons para a resposta em um toque na renovação, POST /chat/send/document para boleto e apólice em PDF, e POST /user/check para conferir quais telefones da carteira têm WhatsApp. Todos na base https://api.zapon.dev, com o header token. São 49 endpoints publicados, todos com schema — o ciclo da corretora vive nesses quatro.
A identificação da chamada é um cabeçalho token, copiado da conexão no painel — sem Bearer, sem OAuth, sem chave adicional. Esse valor tem o peso da senha do sistema de gestão: ele autoriza escrever em nome da corretora.
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": "Sra. Helena, aqui é da Corretora Exemplo.\n\nA vigência da apólice 88.442-1 (veículo placa ABC1D23) termina em 12/04.\n\nA renovação não é automática. O corretor Paulo pode revisar com a senhora as coberturas antes disso — responda por aqui que ele entra em contato." }'
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"
}
}Grave esse Id no registro da apólice. Ele é a prova de que o aviso saiu e quando — informação que vale ouro na conversa difícil de "ninguém me avisou" — e impede que a rotina, executada duas vezes, mande o mesmo aviso 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 definido por você: ponha o número da apólice ali dentro e a resposta volta amarrada ao contrato 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": "Sobre a apólice 88.442-1, que vence em 12/04: como a senhora prefere seguir?", "Footer": "Corretora Exemplo", "Buttons": [ { "id": "ap884421|falar", "text": "Falar com corretor" }, { "id": "ap884421|depois", "text": "Me chame depois" }, { "id": "ap884421|naorenov", "text": "Não vou renovar" } ] }
O terceiro botão é o que mais gente hesita em colocar, e é o mais útil: saber com trinta dias que o cliente não vai renovar permite uma conversa de retenção enquanto ainda há prazo — e, se ele mantiver a decisão, encerra a régua em vez de insistir. Para mais de três opções, 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. Nome de arquivo é parte da mensagem: parcela-04-2026-grupo-3120-cota-455.pdf se explica sozinho na lista de mídia do cliente; boleto.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": "parcela-04-2026-grupo-3120-cota-455.pdf", "Caption": "Parcela de abril do grupo 3120, cota 455. Vencimento em 10/04. Os dados de pagamento nunca mudam por mensagem: na dúvida, confira no canal oficial da administradora antes de pagar." }'
O padrão é uma rotina agendada que roda todo dia útil pela manhã, busca as apólices que vencem daqui a trinta dias e chama a API. Em Node:
// vigencias.js — roda todo dia útil às 9h const API = "https://api.zapon.dev"; const TOKEN = process.env.ZAPON_TOKEN; async function enviarTexto(phone, body) { const r = await fetch(`${API}/chat/send/text`, { method: "POST", headers: { "token": TOKEN, "Content-Type": "application/json" }, body: JSON.stringify({ Phone: phone, Body: body }) }); const json = await r.json(); if (!r.ok || !json.success) throw new Error(json.error || `HTTP ${r.status}`); return json.data.Id; } const espera = (ms) => new Promise((r) => setTimeout(r, ms)); for (const ap of await apolicesQueVencemEm(30)) { if (ap.situacao !== "vigente") continue; // cancelada ou já renovada: fora if (ap.cliente.semAvisos || ap.avisoD30) continue; // um aviso por vigência try { const id = await enviarTexto(ap.cliente.telefone, `${ap.cliente.tratamento} ${ap.cliente.nome}, aqui é da Corretora Exemplo.\n\n` + `A vigência da apólice ${ap.numero} termina em ${ap.fimVigencia}.\n` + `A renovação não é automática. Responda por aqui e o ${ap.corretor.nome} entra em contato.`); await marcarAviso(ap.numero, "d30", id); } catch (e) { await registrarFalha(ap.numero, "aviso_d30", String(e)); // vira tarefa da retenção } await espera(5000); // a carteira inteira no mesmo segundo não parece corretora }
Três detalhes desse laço evitam o constrangimento clássico. Os continue impedem aviso de apólice já renovada, de contrato cancelado e de quem pediu para não receber. O marcarAviso garante um aviso por vigência mesmo que a rotina rode duas vezes. E o intervalo entre envios mantém um ritmo compatível com o tamanho da operação.
Carteira de corretora acumula telefone de dez anos atrás, fixo de recado e número do cônjuge no lugar do titular. O POST /user/check recebe uma lista e diz quais têm conta no WhatsApp — serve para dimensionar quanto da carteira é realmente alcançável antes de montar a rotina.
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": "" } ] } }
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. Mensagem com imagem chega com o bloco correspondente, e é o seu sistema que anexa aquilo ao processo do sinistro.
A entrega é do webhook; a decisão, da sua regra; a execução, do seu sistema. Apólice, cota e sinistro são conceitos que existem apenas do seu lado: para o canal, houve uma mensagem naquele número.
O corpo traz o tipo do evento e a mensagem completa. Assim chega quem escreveu "pode ligar amanhã":
{
"type": "Message",
"event": {
"Info": {
"ID": "3EB0C767D26A1B5F7C83",
"Chat": "[email protected]",
"Sender": "[email protected]",
"IsFromMe": false, "IsGroup": false,
"PushName": "Helena Prado",
"Timestamp": "2026-03-13T11:02:47-03:00"
},
"Message": { "conversation": "pode ligar amanhã" }
}
}
// tocando num botão, muda só o bloco Message:
"Message": { "buttonsResponseMessage": {
"selectedButtonID": "ap884421|falar",
"Response": { "SelectedDisplayText": "Falar com corretor" }
} }Dois pontos merecem atenção na implementação. O corpo tanto pode vir como JSON puro quanto como formulário codificado, com o JSON aninhado num campo — trate as duas formas. E as mensagens que partem do próprio número retornam com IsFromMe verdadeiro; sem esse descarte, o corretor atendendo pelo aparelho aciona a sua automação.
Descarte o que não interessa, encontre o contrato, 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 corretora enviou, 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(); const temImagem = Boolean(ev?.Message?.imageMessage); const temArquivo = Boolean(ev?.Message?.documentMessage); if (temImagem || temArquivo) { // documento do sinistro const sinistro = await sinistroAbertoPorTelefone(telefone); if (!sinistro) return filaDoAtendimento(telefone, "anexo sem sinistro aberto"); await anexarAoProcesso(sinistro.numero, info.ID); return enviarTexto(telefone, `Recebido. Anexei ao sinistro ${sinistro.numero}. Se faltar algo, aviso por aqui.`); } if (/(parar|nao quero|não quero|descadastr)/.test(texto)) { await marcarSemAvisos(telefone); // vale para TODAS as rotinas return enviarTexto(telefone, "Certo, não enviamos mais avisos por aqui."); } const [contrato, acao] = botao ? botao.split("|") : [null, null]; if (acao === "falar") { await abrirTarefaRetencao(contrato, "hoje"); return enviarTexto(telefone, "O corretor responsável entra em contato ainda hoje."); } if (acao === "depois") { await adiarContato(contrato, 7); // sem novo disparo automático return enviarTexto(telefone, "Combinado, falamos na próxima semana."); } if (acao === "naorenov") { await registrarNaoRenovacao(contrato); return enviarTexto(telefone, "Obrigado por avisar. Registrei aqui."); } return filaDoAtendimento(telefone, texto); // o resto é assunto de gente });
Ele vai perguntar — "isso está coberto?", "quanto vou pagar de franquia da apólice?", "posso usar o carro reserva?". Nada disso pode ser respondido automaticamente. Cobertura depende das condições contratadas e da análise do caso concreto; resposta errada por escrito vira expectativa e, no sinistro, vira conflito. Essas mensagens viram pendência nominal do corretor daquele cliente, com telefone, número do contrato e o texto original. O papel da automação é sinalizar a conversa que espera alguém — quem interpreta apólice é o profissional.
Não pela mesma rotina que avisa vencimento. Aviso sobre um contrato que a pessoa já tem é comunicação operacional e esperada. Oferecer produto novo para quem não pediu é publicidade: exige consentimento registrado, com data, e um caminho de saída que funcione. Quando as duas coisas saem do mesmo canal sem separação, o cliente para de ler as duas — inclusive o aviso de vencimento que ele precisava ver.
Este setor tem três linhas que a automação não cruza, e vale escrevê-las na política antes de escrever a primeira linha de código:
Conversa de sinistro carrega foto de documento, endereço, placa e, às vezes, boletim de ocorrência com detalhes desagradáveis. Escreva imaginando que a notificação vai aparecer na tela de alguém em uma sala com outras pessoas: cite o número do processo, não o que aconteceu. E trate o que você guardar no seu sistema com o mesmo cuidado do resto do cadastro — o anexo que veio pelo WhatsApp passa a ser dado da corretora, sujeito ao mesmo controle de acesso.
semAvisos fez no exemplo — e faça alguém olhar a fila de exceções todo dia, porque o pedido chega em qualquer palavra.R$ 27 por mês por número conectado, sem cobrança por mensagem: o valor não muda entre 60 e 6.000 mensagens no mês. O teto está no dia, não na fatura: 300 mensagens por número conectado, calibrado para a corretora não ser confundida com disparo de renovação em massa. 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 de gestão com calma e conectar o número quando a rotina de vencimentos estiver pronta.
Essa previsibilidade é o que torna a régua completa viável: entre aviso de vigência, boleto mensal, cobrança de documento no sinistro e comunicado de assembleia, um cliente recebe dezenas de mensagens ao ano. Com cobrança por mensagem, o custo cresceria com a carteira até alguém cortar o envio de boleto — o mais frequente e o mais útil. Com seguros e consórcio em números separados, é uma conexão para cada, e o seu sistema escolhe de qual número a mensagem sai trocando o header token.
No painel, o estado de cada conexão fica à vista e é atualizado a cada 10 segundos com a página aberta. Como acompanhar tela não é função de ninguém na corretora, assine igualmente os eventos de conexão no webhook: Disconnected sinaliza queda e LoggedOut sinaliza que o número terá de ler o QR Code novamente. A relação alimentada pelo registrarFalha merece um responsável e um horário fixo de leitura: envio que não completou não pode terminar em silêncio.
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 apólice entra na janela de renovação. Se é fechado, leia os dados por fora — relatório de vencimentos, banco, exportação — e dispare com uma rotina ou uma ferramenta de automação no meio.
Não pela automação. Valor de renovação depende de análise e muda; número por escrito numa mensagem automática vira expectativa que o corretor terá de desfazer. O aviso informa a data e abre a conversa — a proposta com valores é documento formal, apresentado por quem responde por ele.
Dá. Quando o cliente responde com imagem ou arquivo, o webhook entrega o evento com o bloco correspondente, e o seu sistema decide o que fazer: anexar ao processo, marcar o item como recebido e avisar quem regula o caso. Diga na mensagem exatamente qual documento falta e em que formato, uma coisa por vez.
Não. Contemplação depende de sorteio e de lance dentro do grupo, e nenhuma estimativa por mensagem é honesta. A automação comunica a contemplação que já ocorreu, com grupo, cota, o que apresentar e o prazo — o resto é conversa do consultor, com as regras do contrato.
Mantendo o padrão sempre igual e nunca alterando dados de pagamento por mensagem. Envie do mesmo número, com nome de arquivo que identifica grupo, cota ou apólice, valor e vencimento na legenda, e uma frase fixa dizendo que os dados nunca mudam por mensagem e que na dúvida o cliente confira pelo canal oficial antes de pagar.
R$ 27 por mês por número conectado, sem cobrança por mensagem, com cota de 300 mensagens por dia em cada número conectado. Nada a ver com a franquia da apólice: é um limite técnico de ritmo, criado para proteger o número da corretora contra bloqueio. 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 contratos que a pessoa tem, não transforme a carteira 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. 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 corretora.
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 ligue a rotina de vencimentos da carteira.