Assessor Financeiro Tool icon

Assessor Financeiro Tool

Tool do Meu Assessor Financeiro para uso com AI Agents

Listar Transações

AI-generated

Summary

Lista transações do usuário, enviando os filtros configurados para a API do Assessor Financeiro. Use o telefone do usuário para identificar a conta; filtros opcionais podem restringir por tipo, texto, período, conta, categoria, status, cartão ou natureza PF/PJ.

Inputs

  • Telefone (required) — Telefone do usuário, normalmente mapeado de dados do workflow, por exemplo ={{ $json.phone }}.
  • Filtro por Tipo — Filtra por despesa, receita ou transferencia.
  • Busca — Busca em descrição, notas, categoria e subcategoria, com stemming em português. Quando há várias palavras, todas precisam corresponder.
  • Limite — Quantidade máxima de transações; padrão 10.
  • Data Início — Filtra transações a partir desta data (YYYY-MM-DD).
  • Data Fim — Filtra transações até esta data (YYYY-MM-DD).
  • Conta Bancária — Filtra pelo nome da conta, como Nubank ou Inter.
  • Categoria — Filtra pelo nome exato da categoria. Use para filtrar por categoria sem busca textual.
  • Status — Filtra por confirmed ou pending.
  • Cartão — Filtra pelo nome ou apelido do cartão.
  • Natureza (PF/PJ) — Filtra por pf (pessoal) ou pj (empresa).
  • Descrição da Tool — Descrição opcional para orientar o AI Agent sobre quando deve usar esta tool.

Output shape

A single response object per input item, containing the API response with the listed transactions and any other fields returned by the service.

The node sends the list_transactions action with the phone and only non-empty filters; zero-valued fields are omitted. With Continue On Fail enabled, an item that errors returns an { "error": ... } object.

Links

Discussion