Do orçamento no WhatsApp à entrega no pátio.

Plano de corte, com a perda de serra na conta

O cliente chega com uma lista de medidas, "12 de 1,20 m, 8 de 0,85 m, 30 de 2,40 m", e quem decide como tirar aquilo das barras do pátio é o serrador, de cabeça. O desperdício não aparecia em lugar nenhum.

O plano resolve o corte unidimensional e imprime a ordem de serviço: por barra, a sequência de cortes com a posição acumulada, para o serrador riscar e cortar sem fazer conta.

• A perda de serra entra na conta. Sem os 3 mm do disco, três peças cabem no papel e não cabem na serra.
• A conta roda em décimo de milímetro inteiro. Em ponto flutuante, 1,20 + 0,85 + … fecha em 3,0499999 e a peça "quase cabe".
• Três heurísticas competem e a melhor vence; empate fica com a mais previsível, para o mesmo pedido dar sempre o mesmo plano.
• Sobra acima do mínimo é retalho, não lixo, vira registro próprio e volta à prateleira.
• Aproveitamento não conta retalho. Chamar sobra de aproveitamento é o jeito mais fácil de esconder desperdício num indicador.

A carga do caminhão, por peso e por volume

A lista de entregas do dia virou carga: quem sobe em qual caminhão, se cabe, em que ordem entregar, e o que voltou. Antes isso era um WhatsApp e um caderno.

Um caminhão de 6 toneladas leva pouquíssimo m³ de cumaru e muita ripa de pinus, por isso a ocupação é medida nas duas grandezas, com o volume saindo da bitola e o peso da densidade da espécie.

• "Não sei" em vez de zero. Material sem bitola no nome fica marcado como não estimado, e o aviso vai até o romaneio impresso. Zero silencioso é o que faz o caminhão sair com 800 kg a mais do que a conta dizia.
• Estourar a capacidade avisa, não bloqueia, o operador vê o caminhão, o sistema não. Mas exige confirmação e fica registrado.
• Roteiro é sugestão de sequência, nunca rota. Agrupa por proximidade de CEP, sem chave de mapa e sem km inventado, e a mão do operador vence a sugestão.
• Motivo de insucesso é lista fechada. Texto livre vira "n/a" e no fim do mês não soma, e é a soma que faz o dono mudar horário, endereço ou motorista.

Reposição: o que acaba, quanto comprar e de quem

A loja comprava por instinto, o dono passa no pátio, vê a pilha baixa e liga para o fornecedor. Falta o que vende e sobra o que não vende, e o dado para decidir já estava no banco.

Ponto de pedido com estoque de segurança, curva ABC por faturamento, capital parado, e um botão que transforma a sugestão em compra em rascunho. Toda conta abre passo a passo: sugestão que chega como caixa-preta não é seguida.

• Pico aparado, não mediana. Numa madeireira o mesmo item passa dias sem sair uma peça, a mediana do consumo diário é zero, e o sistema mandaria nunca comprar nada.
• Material a caminho conta como estoque. Sem isso, a sugestão vira compra, a compra fica em rascunho até a nota chegar, e no dia seguinte o mesmo item pede de novo.
• O prazo tem procedência visível, medido do histórico, do cadastro ou do padrão. Número sem procedência não convence ninguém a assinar uma ordem de compra.
• O dono pode discordar do histórico, item a item. Sistema que não deixa é abandonado na segunda semana.

A madeira que volta, e o crédito que fica

Madeira volta: empenada, rachada, na bitola errada, ou porque sobrou da obra. Antes o operador cancelava o pedido inteiro, destruindo histórico e financeiro, ou fazia um ajuste solto de estoque e "combinava" com o cliente.

• Revendável volta ao pátio; avariado não. Devolver madeira rachada para o saldo é como o pátio passa a mentir.
• O preço é o praticado no pedido, não o de hoje: se a tabela subiu desde a venda, devolver pelo preço novo dá ao cliente dinheiro que ele não pagou.
• O saldo de crédito é a soma do extrato, nunca um campo. O extrato não perde linha, senão não fecha com o papel que o cliente guardou.
• Motivo é lista fechada. "Empenada", "empenado", "torta" e "veio ruim" nunca somariam o relatório que faz o dono trocar de serraria.

O cliente resolve sozinho, no celular

O orçamento afundava no meio de outras quarenta mensagens do WhatsApp, e três dias depois alguém da loja ligava para perguntar se ficou bom. Agora vai um link: o cliente abre no celular, vê tudo e aprova com um toque, e o aceite cria o pedido na hora. Se recusar, a loja fica sabendo por quê.

E o bot passou a responder o que sempre caía no atendente humano: "cadê meu pedido?", "quanto eu ainda devo?" e "me manda de novo aquele orçamento".

• O bot só enxerga o telefone da conversa. A ferramenta nem declara parâmetro de telefone, se a porta existir, um dia o modelo entra por ela.
• Link revogado e link inexistente respondem igual. Distinguir os dois transformaria a página num oráculo de tokens válidos.
• O que a página mostra é lista de permissão. O orçamento carrega o preço de tabela antes do desconto de perfil, passar o dado adiante entregaria a tabela da construtora ao cliente varejo.
• Ver não é responder. A visualização só conta quando o cliente abre de verdade: o WhatsApp busca a página sozinho para montar a pré-visualização, e "visto sem resposta" é justamente o sinal que faz o vendedor ligar.

A IA escreve; o código calcula

O modelo entende o pedido em português de obra ("me vê 40 caibro de 5 por 6, 3 metros") e escreve a resposta. Ele não faz conta e não escolhe produto: preço, desconto por volume, frete e prazo saem de código determinístico.

Essa divisão não é preciosismo. Numa versão anterior, o modelo re-digitava a lista de itens a cada mensagem e trocou 40 caibros (R$ 1.308) por 40 m³ de madeira a granel (R$ 71.200), num orçamento já gravado.

• Carrinho no servidor, por conversa: o modelo só manda "acrescente tanto disso", nunca redigita o pedido inteiro.
• Lote todo ou nada: um código inválido no meio recusa o lote inteiro, em vez de seguir com os válidos e esconder o erro.
• A escolha do produto é do servidor, com busca ordenada por relevância, pedir "caibro" e receber viga é o tipo de erro que o modelo comete e a consulta não.
• Número de orçamento é conferido no banco antes de sair. Todo código de orçamento no texto de resposta é procurado; se não existir, a rodada volta ao modelo como erro e, se ele insistir, a frase mentirosa é substituída. O bot já anunciou "seu pedido foi registrado com o número ORC-2024-0005" sem ter gravado nada, uma vez.
• Pergunta de preço obriga consulta. Se o cliente perguntou preço, estoque ou prazo e o modelo respondeu sem consultar, a rodada é refeita com uso de ferramenta forçado.
• Dado obrigatório é recusado, não lembrado. Registrar orçamento sem os dados do cliente é rejeitado pelo servidor, com a lista do que falta, porque o prompt esquece e a recusa não.

Rajada de mensagens vira uma resposta só

Cliente não escreve parágrafo: manda "E aí!", "é o Marcos", "quero deck" em três mensagens seguidas. Sem tratamento, o bot cumprimenta três vezes.

Há uma janela de agrupamento configurável: cada mensagem é gravada na hora, mas só a última dispara a resposta, as anteriores ficam registradas como agrupadas.

• Busca em português que remove sufixo em vez de cortar radical, cortar por prefixo casaria "madeirit" com "madeira".
• Piso de relevância: exigir mais de uma palavra casada evita responder "parafuso inox" para quem perguntou de geladeira.
• Filtro que não casa é descartado, não devolve vazio, um filtro de categoria inventado pelo modelo já escondeu três decks do catálogo.

A importação de planilha ensaia antes de gravar

Arraste o arquivo do fornecedor em XLSX ou CSV. O sistema lê o cabeçalho e adivinha qual coluna é código, nome, preço, unidade e estoque; confere linha a linha; e mostra o que vai mudar antes de mudar.

Variação suspeita de preço é apontada, é a vírgula fora do lugar que transforma R$ 9,40 em R$ 940,00. E o número brasileiro é lido como brasileiro: 1.234,56 entra como mil duzentos e trinta e quatro, não como um e vinte e três.

• Desfazer com um clique depois de gravado, a importação guarda como voltar atrás.
• Sinônimos do ramo no catálogo: as palavras que o cliente usa, não as do sistema.

Do orçamento ao pátio, com rastro

O orçamento fechado no WhatsApp vira pedido com um clique. A partir daí é fila: confirmado, em separação, pronto, saiu para entrega, concluído, com romaneio de separação para imprimir e o dia dividido entre entrega e retirada.

• Baixa de estoque na separação, não na venda, o que saiu do pátio é o que saiu do saldo.
• Devolução automática no cancelamento, para o saldo não ficar preso em pedido morto.
• Trilha própria de estoque, com o saldo depois de cada movimento, mais rica que a auditoria genérica, e a tela de Auditoria diz isso em vez de fingir que cobre tudo.
• Avisos ao cliente quando o pedido fica pronto e quando sai para entrega, sem ninguém digitar.

Financeiro que aguenta estorno

Título em parcelas, recebimento parcial, quem está devendo e o extrato do mês por forma de pagamento.

O saldo do título é derivado, nunca gravado: é a soma dos pagamentos, calculada na hora. Coluna de saldo persistida desincroniza no primeiro estorno, e aí o extrato mente para sempre.

• A sobra de centavo do parcelamento fica na primeira parcela, para a soma das parcelas fechar exatamente no total.
• Limite de crédito por cliente, com uma regra que não é a óbvia (veja "As contas", abaixo).

Um banco só, sem código de integração

O bot e o balcão são dois programas separados que abrem o mesmo arquivo SQLite, literalmente o mesmo, não uma cópia sincronizada. São 24 tabelas, dez criadas pelo bot e catorze pelo balcão. Não há fila, não há sincronismo, não há job de madrugada: o preço corrigido no balcão já é o preço da próxima cotação.

Para isso funcionar, a propriedade do schema é explícita, cada app sabe quais tabelas cria e quais apenas lê, cada criação é condicional (quem subir primeiro vence, e as definições são idênticas de propósito) e coluna nova entra por acréscimo com valor padrão, nunca obrigatória, o que quebraria a gravação do outro lado.

O bot lê a tabela de clientes, que é do balcão, dentro de uma proteção: se o balcão nunca subiu, a tabela não existe e o bot continua cotando como varejo em vez de quebrar. Na direção contrária, o balcão é proibido de editar segredo, chave de API e segredo de webhook só se mexem no painel do bot.

WhatsApp, pela Evolution API

A conversa chega por webhook. O número é pareado por QR Code no próprio painel, e a instância pode ser dedicada à madeireira ou compartilhada com outras aplicações do servidor.

Um aprendizado caro: o estado de conexão que a Evolution informa não é prova de nada. Já apareceu "conectado" com a sessão morta. A única confirmação honesta é o reconhecimento de entrega da mensagem, por isso o canal é marcado como suspeito quando a API diz que está tudo bem e nenhuma mensagem de cliente entra há horas.

Planilha do fornecedor

XLSX ou CSV, com o cabeçalho que o fornecedor mandou. O sistema adivinha as colunas, ensaia, aponta o que está estranho e só grava depois de confirmado, guardando como desfazer.

Modelo de linguagem

A interpretação e a redação usam o Gemini 2.5 Flash, com o modo de raciocínio estendido desligado, foi medido que ligá-lo não melhorou a decisão de usar ferramenta, e em atendimento latência vale mais que profundidade. O modelo enxerga doze ferramentas, e nenhuma delas calcula preço.

Custo medido: uma conversa completa de sete mensagens consumiu cerca de 36 mil tokens, algo em torno de R$ 0,06. A média corrente das conversas reais gravadas nesta instalação está em torno de R$ 0,08, porque nem toda conversa tem sete mensagens. Áudio custa à parte, numa tabela mais cara, cobrar áudio no preço de texto subestima a conta em três vezes, e por isso ele tem preço próprio na configuração.

O valor exibido é estimativa calculada com preço e câmbio editáveis no painel, não a fatura do Google. Quem fecha a conta é o provedor.

Seus dados, em arquivo aberto

Toda tabela do painel exporta em CSV, e o banco é um arquivo SQLite único, o formato de banco embarcado mais difundido que existe, legível por qualquer ferramenta comum. Não há formato proprietário no meio do caminho.