Contabilidad por WhatsApp: de fotos de recibos a un registro de gastos fiable

En un flujo correcto de Cloud API, Meta envía un evento webhook firmado que contiene un identificador multimedia. El servicio receptor verifica la firma, obtiene de Meta una URL multimedia de corta duración, descarga la imagen con un token de acceso y asocia al remitente con la cuenta correcta. Después puede guardar la imagen de forma privada y enviarla a un sistema OCR o a un modelo de visión.

Tras la extracción, el servicio guarda campos como comercio, fecha, subtotal, impuestos, total, divisa y categoría sugerida. Solo entonces debe enviar una confirmación como «Registrado: $42.10 · Comidas». Si el proceso falla, la respuesta debe indicarlo con claridad y pedir una imagen mejor, en vez de inventar un resultado satisfactorio.

Un chat sigue un orden cronológico, pero la contabilidad necesita estructura. Debes poder filtrar un mes, corregir un comercio, comparar el total con un movimiento bancario y exportar columnas uniformes. Las confirmaciones de entrega y las marcas de tiempo de los mensajes no sustituyen a las fechas de compra ni a los campos fiscales.

Conserva el identificador del mensaje original como procedencia y protección contra duplicados, y trabaja después con el registro estructurado del gasto. Así también evitas que un webhook reintentado registre dos veces la misma foto. El libro mensual seguirá siendo útil aunque cambies de teléfono o archives el chat.

Envía un recibo por imagen. Colócalo sobre una superficie plana que contraste, incluye el encabezado y los totales, y espera a que enfoque la cámara. Los recibos largos pueden necesitar dos imágenes superpuestas; si tu sistema solo admite una por gasto, usa la que muestre el comercio y los totales y añade el documento detallado desde la aplicación web.

Reenviar una imagen ya muy comprimida puede reducir la precisión del OCR. Usa la foto original siempre que sea posible. Para facturas digitales, una carga desde la web puede conservar más detalle que una captura de pantalla de un PDF.

El webhook debe rechazar solicitudes sin firma y las descargas multimedia deben usar la API autenticada de Meta. La asociación de cuentas debe partir del número verificado del remitente, con una correspondencia única para impedir que un número alimente silenciosamente dos negocios. Las imágenes guardadas deben ser privadas y accesibles solo para su propietario o para una función de servidor estrictamente controlada.

Las credenciales deben estar en variables de entorno, nunca en el código del navegador ni como secreto en el repositorio. Si faltan el token de WhatsApp, el identificador del teléfono, el secreto de la aplicación o el token de verificación, la integración debe permanecer desactivada e indicar que no está configurada. Una demostración comercial es válida en una página pública, pero nunca debe confundirse con actividad real entrante o saliente.

Las imágenes de recibos son imperfectas. La impresión térmica se borra, varias divisas comparten símbolo y un recibo de restaurante puede mostrar varios totales. Reserva una revisión semanal para categorías con poca confianza, fechas ausentes, compras personales mezcladas y cualquier total que no coincida con el banco.

Un canal de captura cómodo facilita esa revisión porque faltan menos documentos. No convierte a un modelo en profesional contable. El propietario o quien lleve la contabilidad sigue siendo responsable de la categoría y el tratamiento fiscal finales.