Saltar al contenido principal

Introducción a la API de Ozzie

La API de Ozzie es una API REST de inteligencia financiera que te permite añadir un asistente financiero personal a cualquier producto. Con una sola integración, tu producto obtiene seguimiento de gastos, planes financieros personalizados, metas, tareas semanales accionables y un coach de IA — todo en inglés, portugués o español.

Lo que puedes construir​

  • Apps fintech — Incorpora coaching financiero con IA, seguimiento de gastos y planes personalizados a tu producto existente
  • Bots de WhatsApp — Permite que los usuarios envíen gastos por mensaje de texto o foto de comprobante, sin necesidad de descargar una app
  • Dashboards de analytics — Accede a datos estructurados de transacciones, insights de gastos y progreso de metas para construir visualizaciones ricas
  • Coaches financieros embebidos — Proporciona un chat de IA que entiende el contexto financiero completo de cada usuario

Conceptos clave​

ConceptoDescripción
UsuarioUn perfil financiero vinculado a tu sistema via external_user_id
Intake financieroSnapshot mensual de ingresos y gastos — base del plan
TransaccionesGastos e ingresos individuales, extraídos por IA de texto, imagen, PDF o hoja de cálculo
MetaObjetivo financiero activo (ahorro o pago de deuda)
Money MovesTareas semanales accionables (Actuar, Aprender, Reflexionar)
PlanHoja de ruta financiera personalizada con cronograma, asignaciones y métricas
ChatCoach de IA que responde en el idioma del usuario con contexto financiero completo

Principios de diseño de la API​

  • REST con envelopes JSON — todas las respuestas usan { "object": "tipo", "data": {...} }
  • Paginación por cursor — las listas usan cursor, limit, has_more y next_cursor
  • Formato de error consistente — { "error": { "code": "CODIGO", "message": "..." } }
  • Multi-idioma — define language en el usuario y todas las respuestas de IA usan ese idioma

Enlaces rápidos​