Contabilità via WhatsApp: dalle foto delle ricevute a un registro spese affidabile

In un flusso Cloud API corretto, Meta invia un evento webhook firmato contenente un identificativo del contenuto multimediale. Il servizio ricevente verifica la firma, ottiene da Meta un URL multimediale di breve durata, scarica l'immagine con un token di accesso e associa il mittente all'account giusto. L'immagine può quindi essere archiviata in modo privato e passata a un OCR o a un modello visivo.

Dopo l'estrazione, il servizio salva campi come esercente, data, subtotale, imposta, totale, valuta e categoria suggerita. Solo a quel punto dovrebbe inviare una conferma come «Registrato: $42.10 · Pasti». Se l'elaborazione non riesce, la risposta deve dirlo chiaramente e chiedere un'immagine migliore, senza inventare un esito positivo.

Una chat è cronologica, mentre la contabilità richiede struttura. Devi poter filtrare un mese, correggere un esercente, confrontare il totale con un movimento bancario ed esportare colonne coerenti. Le conferme di consegna e gli orari dei messaggi non sostituiscono le date di acquisto e i campi fiscali.

Conserva l'identificativo del messaggio originale come prova di provenienza e protezione dai duplicati, poi lavora sul record strutturato della spesa. In questo modo, anche un nuovo tentativo del webhook non registrerà due volte la stessa foto. Il registro mensile resta utilizzabile anche se cambi telefono o archivi una chat.

Invia una ricevuta per immagine. Appoggiala su una superficie piana a contrasto, includi intestazione e totali e attendi che la fotocamera metta a fuoco. Le ricevute lunghe possono richiedere due immagini sovrapposte; se il sistema accetta una sola immagine per spesa, usa quella che mostra esercente e totali e aggiungi il documento dettagliato tramite l'app web.

Inoltrare un'immagine già molto compressa può ridurre la precisione dell'OCR. Quando possibile, usa la foto originale. Per le fatture digitali, il caricamento web può mantenere più dettagli rispetto a uno screenshot del PDF.

Il webhook deve rifiutare le richieste non firmate e i download multimediali devono usare l'API autenticata di Meta. L'abbinamento dell'account deve basarsi sul numero verificato del mittente, con una corrispondenza univoca affinché un numero non alimenti silenziosamente due attività. Le immagini archiviate devono restare private e accessibili solo al proprietario o a un ruolo server strettamente controllato.

Le credenziali devono essere variabili d'ambiente, mai codice del browser o segreti nel repository. Se mancano il token WhatsApp, l'ID del telefono, il segreto dell'applicazione o il token di verifica, l'integrazione deve restare disattivata e indicare che non è configurata. Una demo commerciale va bene su una pagina pubblica, ma non deve mai essere confusa con attività reale in entrata o in uscita.

Le immagini delle ricevute sono imperfette. La stampa termica sbiadisce, più valute condividono lo stesso simbolo e una ricevuta del ristorante può mostrare diversi totali. Riserva un controllo settimanale alle categorie con bassa affidabilità, alle date mancanti, agli acquisti personali misti e a ogni totale che non coincide con la banca.

Un canale di acquisizione comodo facilita il controllo perché mancano meno documenti. Non trasforma un modello in un commercialista. Il titolare o il professionista contabile resta responsabile della categoria e del trattamento fiscale finali.