O caderno atrás do balcão guarda o bolo de sábado às 15h, os cem salgados de domingo e a torta sem lactose de sexta — e é só ele que guarda. Com a API do zapon, o seu sistema manda a ficha da encomenda por escrito, confirma na véspera, avisa quando o produto sai do forno e recebe a resposta do cliente por webhook.
Encomenda de padaria é um combinado com muitos detalhes e uma hora exata: sabor da massa, recheio, cobertura, tamanho, o nome que vai escrito em cima, quem retira, a que horas, quanto foi de sinal e quanto falta. Tudo isso costuma caber em três linhas de caneta que só uma pessoa sabe ler.
O prejuízo aparece de dois jeitos. No telefone, com o cliente ligando na véspera para conferir e de novo no dia para saber se já ficou pronto. E na bancada, quando ninguém aparece e o perecível vira perda da casa. Uma API de WhatsApp ataca os dois pelo mesmo caminho: manda por escrito o que foi combinado e recebe de volta a confirmação de quem vai buscar. O zapon expõe uma API REST com header token e JSON entrando e saindo, que o seu sistema de pedidos ou o seu fluxo de automação chama como chamaria qualquer serviço.
Porque o caderno registra o pedido e não devolve nada ao cliente. Ele sai da loja sem papel na mão, e a única cópia do combinado é uma letra corrida atrás do balcão. Quando surge dúvida sobre sabor, hora ou valor, não há o que consultar: é a memória de quem anotou contra a memória de quem pediu. Mandar a mesma ficha por escrito custa uma requisição e encerra a discussão antes que ela exista.
É insumo. Padaria produz por lote e por hora: a fornada, a quantidade de massa, a montagem que começa de madrugada. Quem define o tamanho do lote precisa saber, na noite anterior, quais encomendas estão de pé. A confirmação não serve para ser gentil — serve para não fabricar o que não vai sair e não faltar o que vai.
Três coisas: um número de WhatsApp que a loja controla, uma conta no zapon com esse número conectado por QR Code ou código de pareamento, e algum lugar onde as encomendas do dia seguinte estejam registradas — sistema de pedidos, comanda digital ou planilha compartilhada. Não é preciso servidor próprio, conta na Meta, aprovação de template nem aplicativo instalado no celular do balcão.
token, que autentica as chamadas daquele número.Serve, desde que a encomenda saia do caderno. O mínimo é uma linha por encomenda com telefone, itens, data e hora de retirada. Uma planilha na nuvem com essas colunas já basta para uma automação varrer todo fim de tarde. Trocar o caderno pela planilha é trabalho de uma tarde e é ele que destrava o resto.
Seis etapas: (1) a encomenda é anotada e o cliente recebe a ficha por escrito, com número, itens, hora de retirada, valor e sinal; (2) ele confirma que está tudo certo antes de a produção começar; (3) na véspera sai o lembrete com botão para confirmar, mudar a hora ou cancelar; (4) quando fica pronto, sai o aviso de que está na bancada; (5) na retirada registra-se quem buscou, e a encomenda não retirada vira tarefa no mesmo dia; (6) o cliente recorrente confirma a repetição da semana com um toque.
Cada envio tem uma função diferente na produção — não é a mesma mensagem quatro vezes.
A ficha inteira, na hora: número da encomenda, item, sabor da massa, recheio, cobertura, tamanho ou quantidade, o texto que vai no topo do bolo, data com dia da semana, hora da retirada, valor, sinal pago e saldo. Registrar o combinado é o que encerra a discussão do balcão. Também valida o canal: se o envio falhar aqui, você descobre hoje que o telefone da comanda está errado, não no sábado de manhã.
Peça a confirmação explícita logo depois da ficha, enquanto corrigir é barato. Sabor trocado é um ok de dez segundos hoje; com a massa assada, é retrabalho e prejuízo. Em encomenda de valor alto — festa, cem salgados, bolo de três andares —, o envio de documento leva o orçamento em PDF para a mesma conversa, com nome de arquivo que o cliente encontra depois.
Uma rotina no fim da tarde varre as encomendas do dia seguinte e dispara um lembrete por cliente, repetindo o que foi encomendado e a hora combinada, com três botões: confirmar, mudar a hora ou cancelar. É aqui que a produção precisa da resposta — depois desta hora, a massa já foi feita. Cliente que some agora ainda sai da lista sem custo.
Este é o gatilho que quase nenhum outro negócio tem: o produto está na bancada e existe uma janela para retirar antes de perder qualidade. Quando a produção dá baixa, o sistema avisa que pode buscar e, se fizer sentido, manda a foto do bolo montado para o cliente aprovar a decoração antes de sair de casa. É esse aviso que derruba a segunda ligação do dia, a do "já ficou?".
Na retirada, quem entrega dá baixa e o sistema manda o comprovante do que saiu e do saldo quitado; se outra pessoa buscou, o nome de quem retirou entra na mensagem. Passada a hora combinada sem ninguém aparecer, a encomenda vira tarefa de alguém no mesmo dia: uma mensagem perguntando se ainda vem e um nome na lista de não retiradas que o dono olha antes de fechar. Perda de perecível descoberta no fechamento do mês não tem conserto.
A empresa que pede o café da manhã toda segunda, o salão que compra salgado toda sexta. Para esses, recomeçar a conversa toda semana é desperdício dos dois lados. Guarde a última encomenda como modelo e mande, no dia combinado, o pedido padrão escrito com dois botões: repetir igual ou alterar. Quem toca em "repetir" fecha sem digitar nada; quem toca em "alterar" cai na fila de quem fala com uma pessoa.
Quatro dão conta do fluxo: POST /chat/send/text para a ficha e os avisos, POST /chat/send/buttons para a confirmação em um toque, POST /chat/send/image para a foto do bolo montado e POST /user/check para conferir se o telefone da comanda tem WhatsApp. Todos na base https://api.zapon.dev, com o header token. São 49 endpoints publicados — 23 de /chat, 18 de /group e 8 de /user —, mas a encomenda vive nesses quatro.
A autenticação é um header só, token, copiado da conexão no painel: não é Authorization, não é Bearer, não há OAuth. Trate esse valor como a chave da loja.
Um POST em /chat/send/text com dois campos: Phone, o número em formato internacional só com dígitos, e Body, o texto. Escreva os itens em linhas separadas — essa mensagem vai ser relida no dia da festa.
curl -X POST https://api.zapon.dev/chat/send/text \ -H "token: SEU_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "Phone": "5511999999999", "Body": "Encomenda 3187 registrada.\n\nBolo 2 kg, massa branca\nRecheio: brigadeiro com morango\nCobertura: chantilly\nTopo: Parabéns, Letícia!\n\nRetirada: sábado, 14/03, às 15h\nValor: R$ 210,00 | Sinal pago: R$ 100,00 | Falta: R$ 110,00\n\nConfira o texto do topo: é exatamente assim que vai escrito no bolo." }'
A resposta traz o identificador da mensagem no WhatsApp:
{
"code": 200,
"success": true,
"data": {
"Details": "Sent",
"Id": "90B2F8B13FAC8A9CF6B06E99C7834DC5",
"Timestamp": "2026-03-01T09:12:08-03:00"
}
}Guarde esse Id junto da encomenda: ele prova qual mensagem saiu e evita mandar a ficha duas vezes se a rotina rodar de novo.
Uma rotina agendada no fim da tarde busca as encomendas de amanhã, monta o texto com os itens e chama a API:
// vespera.js — roda às 18h, antes de fechar a lista da produção const API = "https://api.zapon.dev"; const TOKEN = process.env.ZAPON_TOKEN; async function enviarBotoes(phone, body, botoes) { 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: "Padaria Exemplo", Buttons: botoes }) }); const json = await r.json(); if (!r.ok || !json.success) throw new Error(json.error || `HTTP ${r.status}`); return json.data.Id; } const pausa = (ms) => new Promise((r) => setTimeout(r, ms)); for (const enc of await encomendasDeAmanha()) { if (enc.status !== "em_producao" || enc.cliente.optOut) continue; try { const id = await enviarBotoes(enc.cliente.telefone, `${enc.cliente.nome}, sua encomenda ${enc.numero} é amanhã.\n\n` + `${enc.resumo}\nRetirada: ${enc.hora}\nFalta pagar: R$ ${enc.saldo}`, [ { id: `enc${enc.numero}|confirmar`, text: "Confirmar" }, { id: `enc${enc.numero}|mudarhora`, text: "Mudar hora" }, { id: `enc${enc.numero}|cancelar`, text: "Cancelar" } ]); await registrarEnvio(enc.id, "vespera", id); // guarda o Id: evita duplicar } catch (e) { await registrarFalha(enc.id, "vespera", String(e)); // vira tarefa do balcão } await pausa(4000); // não despeje a lista de sábado no mesmo segundo }
Três detalhes desse laço separam o fluxo que dura do que quebra no primeiro sábado cheio. O continue impede lembrete de encomenda cancelada e de quem pediu para não receber. O registrarEnvio guarda o Id, então rodar a rotina duas vezes não manda a mesma confirmação duas vezes. E a pausa evita transformar a véspera de Natal numa rajada de centenas de mensagens no mesmo instante.
O /chat/send/buttons aceita quantos botões você precisar, de rótulo curto — até vinte caracteres. Cada um carrega um id definido por você, e é ele que volta no webhook. Ponha o número da encomenda ali dentro: a resposta chega amarrada ao registro certo, sem depender de casar telefone nem de 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": "Letícia, sua encomenda 3187 (bolo 2 kg, brigadeiro com morango) é amanhã, retirada às 15h. Está confirmado?", "Footer": "Padaria Exemplo", "Buttons": [ { "id": "enc3187|confirmar", "text": "Confirmar" }, { "id": "enc3187|mudarhora", "text": "Mudar hora" }, { "id": "enc3187|cancelar", "text": "Cancelar" } ] }
O /chat/send/image recebe Phone, a imagem em Image (data URI em base64 ou URL) e um Caption. Use a legenda para amarrar a foto ao número da encomenda e dizer o que se espera do cliente.
curl -X POST https://api.zapon.dev/chat/send/image \ -H "token: SEU_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "Phone": "5511999999999", "Image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABA…", "Caption": "Encomenda 3187 pronta: bolo 2 kg, topo Parabéns, Letícia! Retirada a partir das 15h. Se algo estiver diferente do combinado, responda por aqui antes de vir." }'
Telefone anotado às pressas vem com dígito faltando, com número fixo e com DDD errado. O POST /user/check recebe uma lista e diz quais têm conta no WhatsApp — rode ao cadastrar a encomenda, não na véspera.
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": "" } ] } }
São 13 formas de envio ao todo — texto, imagem, áudio, vídeo, documento, sticker, localização, contato, enquete, lista, botões, template e edição de mensagem já enviada —, mais reação, "digitando", marcar como lido e histórico. Fora do quarteto principal, rendem numa padaria o documento, para o orçamento da festa, a localização, para quem nunca foi à loja, e a lista, quando há várias faixas de horário de retirada.
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 que chega naquele número é entregue como 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. Não há polling nem fila para ficar consultando.
O ciclo tem três partes que não se misturam: o webhook entrega o evento, a sua regra interpreta e a ação acontece no seu sistema. A API não sabe o que é uma encomenda; sabe que chegou uma mensagem.
O corpo traz o tipo do evento e a mensagem completa. Assim chega quem digitou "1":
{
"type": "Message",
"event": {
"Info": {
"ID": "3EB0C767D26A1B5F7C83",
"Chat": "[email protected]",
"Sender": "[email protected]",
"IsFromMe": false, "IsGroup": false,
"PushName": "Letícia Prado",
"Timestamp": "2026-03-11T18:04:22-03:00"
},
"Message": { "conversation": "1" }
}
}
// quando ela toca num botão, muda só o bloco Message:
"Message": { "buttonsResponseMessage": {
"selectedButtonID": "enc3187|confirmar",
"Response": { "SelectedDisplayText": "Confirmar" }
} }Duas observações que economizam horas: o corpo pode chegar como JSON puro ou como formulário codificado, com o JSON dentro de um campo — aceite os dois. E o que o próprio número envia também gera evento, com IsFromMe igual a true: ignore, senão o balcão respondendo um cliente aciona a sua automação.
Descarte o que não interessa, identifique a encomenda pelo id do botão, decida pela intenção e diga ao cliente o que foi feito — é o que evita o "eu confirmei e não sei se chegou".
app.post("/whatsapp/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 o balcão enviou, e grupos, fora if (await jaProcessado(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(); // foto de referência ("quero um bolo assim") é assunto de gente if (ev?.Message?.imageMessage) return filaDoBalcao(telefone, "imagem de referência"); const enc = botao ? await buscarEncomenda(botao.split("|")[0]) : await proximaEncomendaPorTelefone(telefone); if (!enc) return filaDoBalcao(telefone, texto); const acao = botao ? botao.split("|")[1] : /^(1|sim|confirmo|confirmado)$/.test(texto) ? "confirmar" : /^(2|mudar|outro horario)$/.test(texto) ? "mudarhora" : /^(3|cancelar|desisti)$/.test(texto) ? "cancelar" : null; if (acao === "confirmar") { await atualizarStatus(enc.id, "confirmada"); // entra no lote de amanhã return enviarTexto(telefone, `Confirmado. Estará pronto para retirada às ${enc.hora}.`); } if (acao === "cancelar") { await atualizarStatus(enc.id, "cancelada"); await tirarDaProducao(enc); // não vai para a fornada return enviarTexto(telefone, "Encomenda cancelada. Sobre o sinal, o balcão fala com você."); } if (acao === "mudarhora") { await atualizarStatus(enc.id, "mudar_hora"); return enviarTexto(telefone, "Certo. Que horas fica melhor para você retirar?"); } return filaDoBalcao(telefone, texto); // o resto é assunto de gente });
Acontece o tempo todo: a pessoa acha uma foto na internet e pergunta se a confeitaria faz igual. O evento chega como imagem, e não há automação que responda isso — é decisão de quem produz e envolve preço. A regra reconhece que veio imagem e manda a conversa para a fila de quem atende, como no filaDoBalcao. Vale o mesmo para áudio: o cliente descreve a encomenda falando, e alguém precisa ouvir e passar para a ficha.
Repetindo o texto do topo por escrito, exatamente como vai sair, numa linha isolada da mensagem — com acento, com a grafia que o cliente usa e com a pontuação. "Parabéns, Letícia!" e "Parabens Leticia" são coisas diferentes na cobertura de um bolo, e quem escreve na confeitaria copia o que está na ficha. Peça a conferência explícita desse campo: é o item que não tem conserto depois de escrito no chantilly.
Nome próprio é onde mais se erra, porque o balcão anota de ouvido: Taís ou Thaís, Isabela ou Izabela. Ao receber a ficha, o cliente lê o nome do próprio filho e corrige de graça. Idade e data entram no mesmo cuidado.
Vale, por dois motivos práticos: o cliente aprova a decoração enquanto ainda dá para ajustar um detalhe, e quem viu a foto vem buscar. A foto sai pelo /chat/send/image, com legenda ligando ao número da encomenda. Ela não substitui a conferência do passo 1 — é confirmação final, não primeira leitura.
Escreva sempre os três números juntos: valor total, sinal pago e saldo na retirada. Discutir valor no balcão, com o bolo na mão e a família esperando, é o pior momento possível. Se a padaria recebe sinal por PIX, a chave é sempre a mesma, divulgada nos canais oficiais da loja — e nunca se pede número de cartão, código de segurança ou senha pela conversa. Existe golpe em que alguém se passa pela loja e manda outra chave para receber o sinal, então a instrução na mensagem precisa ser fixa: chave diferente, confere no balcão antes de pagar. Comprovante recebido também se confere na conta, não só na tela.
Fechando a agenda no sistema e respondendo com clareza: a produção tem teto de forno, de forma e de gente, e prometer o que não sai é pior do que recusar. Marque no cadastro da data quantas encomendas cabem por faixa de horário e, ao bater o limite, mude a resposta do canal para "para o dia 20 já estamos completos; para o dia 21 ainda temos horário". Recusar cedo com alternativa é atendimento; aceitar e atrasar é perder o cliente e a festa dele.
Data de pico muda a natureza do fluxo: em semana comum a padaria confirma encomenda, na semana da Páscoa ela administra capacidade. Três ajustes ajudam:
Mensagem sobre uma encomenda que o próprio cliente fez é esperada: ele deixou o telefone para isso e o assunto é o pedido dele. Promoção, novidade do dia e aviso de fornada são outra coisa — são marketing, e exigem consentimento explícito de quem pediu para receber, além de descadastro que funcione. Misturar as duas coisas no mesmo número é o caminho curto para virar denúncia.
optOut do exemplo em Node fez. O pedido chega em qualquer palavra ("não manda mais"), então alguém olha 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 uma semana comum e a véspera do Natal. O que tem teto é o ritmo — são até 300 mensagens por dia em cada número conectado, limite pensado para a padaria não ser lida como disparo publicitário justamente na semana de maior movimento. O teste é de 14 dias sem cartão e a contagem só começa na primeira conexão — dá para criar a conta, montar a integração com calma e só depois conectar o número da loja.
Isso importa aqui mais do que parece: uma encomenda gera até cinco mensagens — ficha, confirmação, véspera, pronto e retirada — e com cobrança por mensagem alguém acabaria cortando o aviso de "ficou pronto", que é justamente o que evita a perda do perecível. Com duas lojas, é uma conexão por loja, e o seu sistema escolhe de qual número a mensagem sai trocando o header token.
O painel mostra o estado de cada conexão e atualiza a cada 10 segundos enquanto a página está aberta. Para não depender de alguém olhar a tela no meio da fila, assine os eventos de conexão no webhook: Disconnected avisa a queda e LoggedOut avisa que o número precisa ler o QR Code de novo. E quando um envio falhar, registre numa lista visível — foi o que o registrarFalha fez — que alguém olha antes de fechar a loja. Confirmação que não saiu precisa virar tarefa, não silêncio.
Dá. Uma rotina no fim da tarde varre as encomendas do dia seguinte e manda a confirmação com botões. Quem confirma entra no lote da produção; quem cancela sai antes de a massa ser feita — e o telefone da loja fica livre para quem está no balcão.
Ela vira tarefa no mesmo dia: uma mensagem perguntando se o cliente ainda vem e um nome na lista de não retiradas que alguém olha antes de fechar. A automação não elimina a perda, mas ela deixa de aparecer só no fechamento do mês, quando não há mais nada a fazer.
Consegue. O botão "Mudar hora" chega ao seu sistema com o número da encomenda embutido, o status vira pendente de horário e a conversa entra na fila de quem atende. Quem responde escrevendo o horário cai na mesma fila.
Pode, com o envio de imagem da API e a legenda trazendo o número da encomenda. Serve para o cliente aprovar a decoração enquanto ainda dá para ajustar um detalhe — e quem viu a foto vem buscar na hora combinada.
Serve, porque o fluxo termina na retirada e não na entrega. O que a integração organiza é o combinado e a hora: ficha escrita, confirmação da véspera, aviso de pronto e baixa na retirada.
Isso é marketing, não aviso de encomenda, e o tratamento é outro: consentimento explícito, lista só de quem pediu para receber e descadastro que funciona. Disparar para a base inteira porque saiu a fornada é o caminho mais curto para o bloqueio do número.
R$ 27 por mês por número conectado, sem cobrança por mensagem, e cada número conectado envia até 300 mensagens por dia. Esse teto protege o número da padaria: quem dispara em rajada é o primeiro que o WhatsApp bloqueia. O teste é de 14 dias sem cartão e só começa a contar quando você conecta o primeiro número.
Não precisa de sistema de gestão, mas a encomenda precisa estar em algum lugar legível por máquina. Uma planilha na nuvem com telefone, itens, data e hora de retirada já basta para uma ferramenta de automação disparar as mensagens. O que não funciona é o caderno.
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 mande a ficha da primeira encomenda hoje.