Saltar al contenido principal

Changelog

Todos los cambios notables en la API de Ozzie están documentados aquí. La API de Ozzie sigue el Versionado Semántico. Los cambios que rompen compatibilidad siempre resultan en un incremento de versión mayor y se anuncian con una guía de migración.

v1.0.0 — 5 de mayo de 2025​

Lanzamiento público inicial de la API de Ozzie.

Nuevos endpoints​

Usuarios​

  • POST /v1/users — Crear un nuevo usuario bajo tu cliente de la API
  • GET /v1/users/{user_id} — Obtener un usuario por ID
  • GET /v1/users — Listar usuarios con búsqueda opcional por external_user_id

Intake Financiero​

  • POST /v1/users/{user_id}/financial-intake — Enviar o actualizar el snapshot financiero mensual de un usuario
  • GET /v1/users/{user_id}/financial-intake — Obtener el intake actual del usuario

Transacciones​

  • POST /v1/users/{user_id}/transactions — Enviar una transacción como texto, imagen (foto de recibo), PDF o hoja de cálculo — Ozzie analiza y categoriza todos los formatos automáticamente
  • GET /v1/users/{user_id}/transactions — Listar transacciones con filtros por rango de fechas, categoría y tipo de fuente
  • GET /v1/users/{user_id}/transactions/{transaction_id} — Obtener una única transacción

Metas​

  • POST /v1/users/{user_id}/goals — Crear o reemplazar la meta activa del usuario
  • GET /v1/users/{user_id}/goals — Obtener la meta actual del usuario

Plan​

  • POST /v1/users/{user_id}/plan — Calcular o actualizar el plan financiero del usuario (requiere intake)
  • POST /v1/users/{user_id}/plan/personalize — Ajustar el tono y las recomendaciones del plan basándose en un perfil de personalidad

Money Moves​

  • POST /v1/users/{user_id}/money-moves/generate — Generar el siguiente ciclo de money move (requiere plan)
  • GET /v1/users/{user_id}/money-moves — Listar ciclos con filtro de estado y paginación por cursor
  • GET /v1/users/{user_id}/money-moves/{move_id} — Obtener un único ciclo
  • PATCH /v1/users/{user_id}/money-moves/{move_id} — Marcar un ciclo como completado o saltado

Chat​

  • POST /v1/users/{user_id}/chat/messages — Enviar un mensaje al coach financiero de IA — las respuestas incluyen los campos reply, emotion, topic e intent

Webhooks​

  • POST /api/webhooks/evolution — Webhook de WhatsApp entrante vía Evolution API — soporta tipos de mensaje conversation (texto) e imageMessage (foto de recibo)

Funcionalidades​

Análisis de transacciones por IA​

El endpoint POST /transactions acepta cuatro formatos de entrada:

Tipo de fuenteEntradas aceptadas
"text"Descripciones en lenguaje natural (ej: "gasté $45 en el supermercado")
"image"Fotos de recibos en formato JPEG, PNG o WebP
"pdf"Estados de cuenta bancarios o facturas en PDF
"spreadsheet"Archivos CSV o XLSX con filas de transacciones

Soporte multilingüe​

Todo el contenido generado por IA se devuelve en el idioma configurado del usuario. Idiomas soportados en el lanzamiento:

IdiomaCódigo
Inglésen
Portugués (Brasileño)pt
Españoles

Planes personalizados por personalidad​

POST /plan/personalize soporta cuatro perfiles de personalidad:

PerfilDescripción
optimizerOrientado por datos; motivado por eficiencia y retornos máximos
plannerDetallista; prefiere hojas de ruta estructuradas y previsibilidad
avoiderAnsioso con las finanzas; responde a la tranquilización y pequeñas victorias
spenderOrientado por estilo de vida; necesita estrategias que no parezcan privación

Acceso por tiers​

La API de Ozzie está disponible en tres tiers:

TierLímite de tasaFuncionalidades
Free100 solicitudes/minUsuarios, Intake, Transacciones (solo texto), Chat
Pro1.000 solicitudes/minTodas las funciones Free + análisis de imagen/PDF/hoja de cálculo, Money Moves, Metas, Personalización de plan
EnterprisePersonalizadoTodas las funciones Pro + SLA, soporte dedicado, límites personalizados, SSO

Contacta a commercial@ozzieapp.com para hacer upgrade o discutir precios Enterprise.

Limitaciones conocidas en el lanzamiento​

  • El chat no retiene historial de conversación entre turnos. Cada mensaje se procesa independientemente con el contexto financiero completo del usuario, pero sin memoria de mensajes de chat anteriores.
  • El webhook de WhatsApp aún no soporta adjuntos de PDF o hoja de cálculo enviados vía WhatsApp. Usa POST /transactions directamente para subidas de documentos.
  • La generación de planes es síncrona y típicamente toma 2–5 segundos.

Próximos lanzamientos​

  • v1.1.0 — Historial de conversación: el endpoint de chat soportará un parámetro thread_id opcional que habilita conversaciones persistentes y multi-turno
  • v1.1.0 — Soporte para mensajes de audio de WhatsApp (registro de transacciones por voz)
  • v1.2.0 — Endpoint GET /users/{user_id}/insights que devuelve resúmenes financieros mensuales generados por IA
  • v1.3.0 — Respuestas de chat en streaming vía Server-Sent Events

Suscríbete al boletín para desarrolladores de Ozzie para ser notificado cuando se lancen nuevas funciones.