Pular para o conteúdo principal

Changelog

Todas as mudanças notáveis na API Ozzie são documentadas aqui. A API Ozzie segue o Versionamento Semântico. Mudanças quebradas sempre resultam em um incremento de versão major e são anunciadas com um guia de migração.

v1.0.0 — 5 de maio de 2025​

Lançamento público inicial da API Ozzie.

Novos endpoints​

Usuários​

  • POST /v1/users — Criar um novo usuário sob seu cliente da API
  • GET /v1/users/{user_id} — Buscar um usuário por ID
  • GET /v1/users — Listar usuários com busca opcional por external_user_id

Intake Financeiro​

  • POST /v1/users/{user_id}/financial-intake — Enviar ou atualizar o snapshot financeiro mensal de um usuário
  • GET /v1/users/{user_id}/financial-intake — Buscar o intake atual do usuário

Transações​

  • POST /v1/users/{user_id}/transactions — Enviar uma transação como texto, imagem (foto de recibo), PDF ou planilha — o Ozzie analisa e categoriza todos os formatos automaticamente
  • GET /v1/users/{user_id}/transactions — Listar transações com filtros por intervalo de datas, categoria e tipo de fonte
  • GET /v1/users/{user_id}/transactions/{transaction_id} — Buscar uma única transação

Metas​

  • POST /v1/users/{user_id}/goals — Criar ou substituir a meta ativa do usuário
  • GET /v1/users/{user_id}/goals — Buscar a meta atual do usuário

Plano​

  • POST /v1/users/{user_id}/plan — Calcular ou atualizar o plano financeiro do usuário (requer intake)
  • POST /v1/users/{user_id}/plan/personalize — Ajustar o tom e as recomendações do plano com base em um perfil de personalidade

Money Moves​

  • POST /v1/users/{user_id}/money-moves/generate — Gerar o próximo ciclo de money move (requer plano)
  • GET /v1/users/{user_id}/money-moves — Listar ciclos com filtro de status e paginação por cursor
  • GET /v1/users/{user_id}/money-moves/{move_id} — Buscar um único ciclo
  • PATCH /v1/users/{user_id}/money-moves/{move_id} — Marcar um ciclo como concluído ou ignorado

Chat​

  • POST /v1/users/{user_id}/chat/messages — Enviar uma mensagem ao coach financeiro de IA — respostas incluem campos reply, emotion, topic e intent

Webhooks​

  • POST /api/webhooks/evolution — Webhook WhatsApp inbound via Evolution API — suporta tipos de mensagem conversation (texto) e imageMessage (foto de recibo)

Funcionalidades​

Análise de transações por IA​

O endpoint POST /transactions aceita quatro formatos de entrada:

Tipo de fonteEntradas aceitas
"text"Descrições em linguagem natural (ex: "gastei R$45 no supermercado")
"image"Fotos de recibos em formato JPEG, PNG ou WebP
"pdf"Extratos bancários ou faturas em PDF
"spreadsheet"Arquivos CSV ou XLSX com linhas de transações

Suporte multilíngue​

Todo conteúdo gerado por IA é retornado no idioma configurado do usuário. Idiomas suportados no lançamento:

IdiomaCódigo
Inglêsen
Português (Brasileiro)pt
Espanholes

Planos personalizados por personalidade​

POST /plan/personalize suporta quatro perfis de personalidade:

PerfilDescrição
optimizerOrientado por dados; motivado por eficiência e retornos máximos
plannerDetalhista; prefere roteiros estruturados e previsibilidade
avoiderAnsioso com finanças; responde a reasseguramento e pequenas vitórias
spenderOrientado por estilo de vida; precisa de estratégias que não pareçam privação

Acesso por tiers​

A API Ozzie está disponível em três tiers:

TierLimite de taxaFuncionalidades
Free100 requisições/minUsuários, Intake, Transações (somente texto), Chat
Pro1.000 requisições/minTodos os recursos Free + análise de imagem/PDF/planilha, Money Moves, Metas, Personalização de plano
EnterprisePersonalizadoTodos os recursos Pro + SLA, suporte dedicado, limites personalizados, SSO

Entre em contato com commercial@ozzieapp.com para fazer upgrade ou discutir preços Enterprise.

Limitações conhecidas no lançamento​

  • O chat não retém histórico de conversa entre turnos. Cada mensagem é processada independentemente com o contexto financeiro completo do usuário, mas sem memória de mensagens de chat anteriores.
  • O webhook do WhatsApp ainda não suporta anexos de PDF ou planilha enviados via WhatsApp. Use POST /transactions diretamente para uploads de documentos.
  • A geração de plano é síncrona e normalmente leva 2–5 segundos.
  • Os tipos de personalidade de POST /plan/personalize estão limitados aos quatro perfis listados acima.

Próximos lançamentos​

  • v1.1.0 — Histórico de conversa: o endpoint de chat suportará um parâmetro thread_id opcional que habilita conversas persistentes e multi-turno
  • v1.1.0 — Suporte a mensagens de áudio do WhatsApp (registro de transações por voz)
  • v1.2.0 — Endpoint GET /users/{user_id}/insights retornando resumos financeiros mensais gerados por IA
  • v1.3.0 — Respostas de chat em streaming via Server-Sent Events

Assine a newsletter para desenvolvedores da Ozzie para ser notificado quando novos recursos forem lançados.