FlowModels

Gerenciar os usuários finais da sua aplicação

Publicado em 11. novembro 2026

Quando sua aplicação atende muitas pessoas, você quer conseguir separar consumo, arquivos e memórias por pessoa. É para isso que existem os usuários finais: sua aplicação envia em cada requisição um identificador próprio, e o FlowModels associa tudo a esse identificador. Em Usuários finais, você vê quais usuários finais existem e o que consumiram e, se necessário, pode excluir os dados deles por completo.

Como um usuário final surge

Sua aplicação envia no campo external_identifier um identificador próprio e estável, por exemplo seu número de cliente cliente-1042. Um identificador puramente numérico também deve ser enviado como string. Na primeira chamada com um identificador novo, o FlowModels cria o usuário final automaticamente. Como alternativa, sua aplicação pode criá-lo antes com POST /v1/end-users.

Não use endereços de e-mail ou nomes como identificador, e sim um ID neutro do seu sistema. Assim, os dados pessoais ficam com você.

A lista de usuários finais

No dashboard, abra o item Usuários finais. Para cada usuário final, você vê:

  • Identificador: o seu próprio identificador e, abaixo dele, o ID público que a API atribuiu a esse usuário final
  • Criado: quando o usuário final apareceu pela primeira vez
  • Pedidos e Custo no mês em curso
  • Ficheiros e Memórias armazenados para esse usuário final

A lista de usuários finais com identificador, data de criação, chamadas e custos no mês em curso, arquivos e memórias

Com Procurar por identificador, você encontra rapidamente um usuário final específico. O consumo de um usuário final em um período mais longo é analisado em Consumo, com o filtro Todos os usuários finais.

Detalhes de um usuário final

Clique em Ver detalhes à direita da linha. Na janela, você vê os Ficheiros enviados com nome, tamanho e data, as Execuções de eliminação anteriores e a área Eliminar utilizador final.

Excluir um usuário final

Quando uma pessoa pede a exclusão dos dados dela ou encerra a conta na sua aplicação, é aqui que você a exclui:

  1. Abra os detalhes do usuário final.
  2. Na área Eliminar utilizador final, digite para confirmar o identificador do usuário final exatamente como aparece no topo.
  3. Clique em Eliminar utilizador final.

Excluímos então todos os dados associados a esse usuário final, por exemplo arquivos e memórias. As linhas de consumo relevantes para o faturamento são mantidas de forma pseudonimizada, para que seu faturamento continue correto. A operação é irreversível.

A exclusão ocorre em segundo plano. Em Execuções de eliminação, você acompanha o andamento com Iniciada, Estado, Motivo, Objetos pendentes e Conclusão. Os estados possíveis são Criada, Em curso, Concluída, Parcialmente concluída e Falhou. Uma execução concluída remove o usuário final da lista, mas a prova da exclusão continua visível.

Quando algo não funciona

  • “O identificador introduzido não coincide.”: atenção a maiúsculas e minúsculas, hífens e sublinhados.
  • Ainda sem utilizadores finais: a lista só é preenchida quando sua aplicação faz requisições com um identificador de usuário final. Requisições sem identificador não são associadas a nenhum usuário final.
  • Parcialmente concluída ou Falhou: parte dos dados ainda não pôde ser removida. Nesse caso, fale com o suporte e informe o identificador do usuário final.

Este artigo foi útil?

Voltar para Webhooks, usuários finais e MCP