finance-telegram-bot
Aplicación personal de seguimiento y conciliación financiera bancaria para Banco BCI (Chile), conectada con Gmail, Google Sheets y Telegram.
Ficha de Información de la Aplicación / App Information Sheet
finance-telegram-bot🎯 Propósito de la Aplicación / Application Purpose
Descripción en Español:
El propósito fundamental de finance-telegram-bot es automatizar la conciliación y el registro contable de las finanzas personales del usuario. La aplicación se conecta de forma segura y privada a la cuenta de Gmail del usuario para monitorear exclusivamente los correos electrónicos de notificación de transacciones emitidos por Banco BCI (Chile) (compras con tarjetas de débito/crédito, pagos en cuotas, suscripciones en dólares, pagos automáticos PAC y transferencias bancarias).
Al detectar un nuevo correo bancario, la aplicación extrae con precisión el monto, el comercio o destinatario, la fecha y el método de pago, clasificándolo en una categoría de gasto (ej. Alimentación, Transporte, Salud, etc.) y guardándolo automáticamente en la hoja de cálculo privada del usuario en Google Sheets. Además, notifica al usuario vía Telegram con un resumen interactivo y control de presupuestos mensuales.
English Description (For Google Verification Team):
The primary purpose of finance-telegram-bot is to provide automated personal financial reconciliation and expense tracking. The application securely connects to the user's Gmail account to monitor official transaction notification emails from Banco BCI (Chile) (such as debit/credit purchases, installments, automatic payments, and bank transfers).
When a transaction email is received, finance-telegram-bot parses the amount, merchant, date, and payment instrument, categorizes the expense, and automatically appends a new row to the user's private Google Sheets spreadsheet while sending an instant interactive summary notification to the user's private Telegram chat.
Uso Específico de Permisos de Google (Google Scopes)
Detalle de cada alcance solicitado y su justificación técnica para el funcionamiento de finance-telegram-bot.
Lectura y Marcado de Notificaciones Bancarias
Justificación: finance-telegram-bot utiliza este permiso para buscar y leer exclusivamente los correos electrónicos provenientes de remitentes oficiales de Banco BCI (como notificaciones@bci.cl y contacto@bci.cl).
Tras extraer el monto y comercio para registrarlo en la hoja de cálculo, la aplicación marca el correo como leído para evitar registros duplicados.
✓ Privacidad Garantizada: La app NO lee correos personales, NO lee mensajes de otros remitentes y NO almacena el contenido de los mensajes en servidores de terceros.
Registro Contable en Google Sheets
Justificación: Permite a finance-telegram-bot escribir y actualizar las filas en la hoja de cálculo privada del usuario (denominada Finanzas_Personales, en las hojas Movimientos y Presupuestos_Mensuales).
Esto proporciona al usuario un libro de contabilidad personal en la nube siempre actualizado con fecha, comercio, categoría, monto y detalle de cuotas.
✓ Solo escribe y modifica la planilla financiera creada para el usuario.
Creación y Gestión de la Planilla en Drive
Justificación: Permite a la aplicación verificar si la hoja de cálculo Finanzas_Personales existe en el Google Drive del usuario y crearla en caso de ser la primera ejecución.
Garantiza que el archivo pertenezca 100% al usuario y resida dentro de su propio espacio de almacenamiento.
✓ Acceso limitado únicamente al archivo creado por la app, sin acceso al resto de Google Drive.
Flujo de Funcionamiento / End-to-End Workflow
Ciclo completo de automatización desde la compra bancaria hasta la conciliación.
Compra o Transacción
El usuario realiza un pago con tarjeta BCI, una compra en cuotas o una transferencia electrónica.
Aviso en Gmail
Banco BCI envía la confirmación de la transacción al correo de Gmail del usuario.
Procesamiento
finance-telegram-bot extrae el comercio, monto y cuotas, asignando la categoría financiera.
Sincronización & Alerta
Se añade la fila a Google Sheets y se envía una alerta interactiva a Telegram para control de saldo.
Características Principales de finance-telegram-bot
Funcionalidades de control financiero personal, privado y seguro.
Detección de Cuotas & USD
Reconoce compras en cuotas y cargos internacionales en dólares con conversión a CLP en tiempo real.
Detección Antifraude
Avisa inmediatamente ante cobros duplicados en menos de 15 minutos o picos de consumo inusuales.
Límites de Presupuesto
Control visual por categoría con barras de progreso y alertas automáticas al 80% y 100% del presupuesto.
Lectura de Boletas con IA
Permite enviar fotos de comprobantes físicos para extraer automáticamente el total y comercio.
Consultas en Lenguaje Natural
Responde preguntas financieras directas como "¿Cuánto he gastado en Uber este mes?" en Telegram.
Soberanía y Privacidad
Los datos residen exclusivamente en la base de datos privada del usuario y en su Google Sheet personal.