Manual de Usuario

FinanzasAI transforma el registro y el análisis de tus finanzas en un proceso automático y asistido por inteligencia artificial. Esta guía te muestra cómo aprovechar cada función de tu suscripción Premium.

Abrir la aplicación Escribir a soporte

En esta página

1. Manual de Usuario
   1. La suscripción Premium
   2. Funciones en detalle
      1. Copiloto Financiero IA
      2. Escáner de Recibos (Vision OCR)
   3. Ingesta Automática de Transacciones
      1. Paso 1 — Obtén tu token de ingesta
      2. Paso 2 — Configuración para Gmail (Nequi / Bre-B)
      3. Paso 3 — Configuración para Android con Tasker (Daviplata por SMS)
   4. Privacidad por Diseño
   5. Soporte

La suscripción Premium

FinanzasAI es una herramienta profesional, sin publicidad y centrada en la privacidad. La suscripción de $5 USD al mes (aproximadamente $20.000 COP) sostiene la infraestructura segura y el acceso a los modelos de lenguaje de última generación (Anthropic Claude y OpenAI GPT) que dan vida a las funciones inteligentes.

Una sola membresía habilita todo lo siguiente:

Todas las funciones anteriores están disponibles en la versión actual.

Funciones en detalle

Copiloto Financiero IA

Personaliza el carácter de tu asesor en Preferencias → Copiloto Inteligente. Cada perfil ajusta el tono y el enfoque del análisis:

Escáner de Recibos (Vision OCR)

Sube o fotografía cualquier recibo desde el chat del agente. El sistema procesa la imagen con visión multimodal y rellena automáticamente los campos de la transacción —comercio, monto, fecha y cuenta— para que confirmes con un solo toque.

Ingesta Automática de Transacciones

Conecta tus bancos para que cada alerta de compra o consignación se registre por sí sola en tu perfil activo. El flujo es el siguiente:

Gmail (Apps Script)  ─┐
                      ├──►  POST https://api.finanzasai.me/api/ingest/notification
Tasker (SMS)         ─┘        { token, text, source, message_id }
                                        │
                                        ▼
                  Resuelve tu usuario por el token  →  NLP  →  registra la transacción

Autenticación por token. Se genera un token de ingesta único por usuario; nunca expones tu contraseña ni tu sesión. Si se filtra, lo rotas con un clic.

Sin duplicados. Cada notificación incluye un message_id que evita registros repetidos.

Pre-procesamiento inteligente. El webhook normaliza el texto bancario, identifica la cuenta por alias (por ejemplo, Bre-B → cuenta «Nequi»), extrae el beneficiario y crea la transacción.

Paso 1 — Obtén tu token de ingesta

1. En la aplicación, abre Preferencias → Captura automática.
2. Copia tu token de ingesta personal.
3. Para invalidar el token actual en cualquier momento, usa Rotar token.

Paso 2 — Configuración para Gmail (Nequi / Bre-B)

Si tus notificaciones bancarias llegan a Gmail:

1. Entra a Google Apps Script e inicia sesión.
2. Crea un Nuevo proyecto.
3. Reemplaza el código por defecto con el siguiente bloque y sustituye TU_TOKEN por el token del Paso 1:

// Reenvía notificaciones de Nequi/Bre-B a FinanzasAI. Activador: cada 5 minutos.
const WEBHOOK_URL = 'https://api.finanzasai.me/api/ingest/notification';
const TOKEN       = 'TU_TOKEN';                 // ← coloca aquí tu token de ingesta
const SENDER      = 'notificaciones@nequi.com.co';
const LABEL_DONE  = 'finanzasai-procesado';     // se crea automáticamente

function procesarNotificaciones() {
  const query = 'from:' + SENDER + ' is:unread newer_than:2h -label:' + LABEL_DONE;
  const threads = GmailApp.search(query);
  if (!threads.length) return;

  let label = GmailApp.getUserLabelByName(LABEL_DONE) || GmailApp.createLabel(LABEL_DONE);

  threads.forEach(thread => {
    thread.getMessages().forEach(msg => {
      if (!msg.isUnread()) return;
      const subject = msg.getSubject() || '';
      const body    = (msg.getPlainBody() || '').substring(0, 300).replace(/\s+/g, ' ').trim();
      const payload = JSON.stringify({
        token:      TOKEN,
        text:       subject + '. ' + body,
        source:     'bre-b',
        message_id: 'gmail-' + msg.getId()
      });
      try {
        UrlFetchApp.fetch(WEBHOOK_URL, {
          method: 'post', contentType: 'application/json',
          payload: payload, muteHttpExceptions: true
        });
        msg.markRead();
        thread.addLabel(label);
      } catch (e) {
        Logger.log('Error de reenvío: ' + e.toString());
      }
    });
  });
}

1. Guarda el proyecto.
2. Abre Activadores (icono de reloj en la barra lateral) y selecciona Añadir activador.
3. Configura procesarNotificaciones para que se ejecute de forma periódica, cada 5 minutos.

Paso 3 — Configuración para Android con Tasker (Daviplata por SMS)

Si tus notificaciones llegan por SMS:

1. Abre Tasker en tu dispositivo.
2. Crea un Perfil de tipo Event → Phone → Received Text.
3. En Sender, indica el remitente del banco (por ejemplo, 85533).
4. Asocia una Tarea con una acción Net → HTTP Request:
   • Method: POST
   • URL: https://api.finanzasai.me/api/ingest/notification
   • Headers: Content-Type: application/json
   • Body:

     {
       "token": "TU_TOKEN",
       "text": "%SMSRB",
       "source": "daviplata",
       "message_id": "tasker-%TIMEMS"
     }
     

5. Guarda y activa el perfil.

Privacidad por Diseño

Tus datos financieros no se comercializan. Este compromiso se traduce en decisiones concretas:

• Sin publicidad. Tu suscripción financia directamente la infraestructura; no hay terceros anunciantes.
• Modo privacidad. Oculta todos los montos en pantalla con un atajo, ideal para usar la aplicación en lugares públicos.
• Control de analítica. Respetamos la señal Do Not Track del navegador y puedes desactivar por completo la analítica no sensible desde tus preferencias.

Para conocer el detalle técnico, consulta la página de Seguridad y Privacidad.

Soporte

¿Tienes dudas sobre tu suscripción, la ingesta automática o el uso general de la aplicación?

Escribir a soporte@finanzasai.me Guía técnica (SUPPORT.md)

Atendemos las solicitudes en un plazo aproximado de 24 horas hábiles.