Contabilidade pelo WhatsApp: de fotos de recibos a um controle de despesas confiável

Em um fluxo correto da Cloud API, a Meta envia um evento de webhook assinado com um identificador de mídia. O serviço que recebe verifica a assinatura, obtém da Meta uma URL de mídia de curta duração, baixa a imagem com um token de acesso e associa o remetente à conta correta. Depois, a imagem pode ser armazenada de forma privada e enviada para OCR ou um modelo de visão.

Após a extração, o serviço salva campos como estabelecimento, data, subtotal, tributo, total, moeda e categoria sugerida. Só então deve enviar uma confirmação como «Registrado: $42.10 · Refeições». Se o processamento falhar, a resposta deve informar isso claramente e pedir uma imagem melhor, em vez de inventar um resultado bem-sucedido.

Uma conversa segue a ordem cronológica, mas a contabilidade precisa de estrutura. Você precisa filtrar um mês, corrigir um estabelecimento, comparar o total com uma linha do banco e exportar colunas consistentes. Confirmações de entrega e horários das mensagens não substituem datas de compra e campos tributários.

Guarde o identificador da mensagem original como registro de procedência e proteção contra duplicatas, depois trabalhe com o registro estruturado da despesa. Isso também evita que uma nova tentativa do webhook registre a mesma foto duas vezes. O livro mensal continua utilizável mesmo se o celular for trocado ou a conversa for arquivada.

Envie um recibo por imagem. Coloque-o sobre uma superfície plana e contrastante, inclua o cabeçalho e os totais e espere a câmera focar. Recibos longos podem exigir duas imagens sobrepostas; se o sistema aceitar apenas uma imagem por despesa, use a que mostre o estabelecimento e os totais e acrescente o documento detalhado pelo aplicativo web.

Encaminhar uma imagem já muito compactada pode reduzir a precisão do OCR. Use a foto original sempre que possível. Para notas digitais, um envio pela web pode preservar mais detalhes do que uma captura de tela do PDF.

O webhook deve recusar solicitações não assinadas, e os downloads de mídia devem usar a API autenticada da Meta. A associação da conta deve usar o número verificado do remetente, com um vínculo exclusivo para impedir que um número abasteça silenciosamente dois negócios. As imagens armazenadas devem ser privadas e acessíveis apenas ao usuário proprietário ou a uma função de servidor rigorosamente controlada.

As credenciais devem ficar em variáveis de ambiente, nunca no código do navegador ou como segredo no repositório. Se o token do WhatsApp, o ID do telefone, o segredo do aplicativo ou o token de verificação estiver ausente, a integração deve permanecer desligada e informar que não está configurada. Uma demonstração comercial é válida em uma página pública, mas nunca deve ser confundida com atividade real de entrada ou saída.

Imagens de recibos são imperfeitas. A impressão térmica apaga, várias moedas usam o mesmo símbolo e um recibo de restaurante pode mostrar diversos totais. Reserve uma revisão semanal para categorias com baixa confiança, datas ausentes, compras pessoais misturadas e qualquer total que não coincida com o banco.

Um canal de captura conveniente facilita essa revisão porque menos documentos ficam faltando. Ele não transforma um modelo em contador. O dono do negócio ou o profissional contábil continua responsável pela categoria e pelo tratamento tributário finais.