Skip to main content
Recursos são a ponte entre eventos de uso e faturamento. Eles definem quais eventos entram no cálculo de cobrança e como esses eventos são agregados ao longo do ciclo.
Aira — Listagem de recursos

O que é um recurso

Um recurso é uma configuração que transforma eventos brutos em uma métrica de cobrança reutilizável. Ele faz duas coisas:
  1. Filtra — seleciona quais eventos participam do cálculo (por eventName, propriedades ou tags)
  2. Agrega — define como os valores dos eventos filtrados são combinados (soma, último do período ou valores únicos)
O resultado é um número único por ciclo de cobrança — a “volumetria” — que será precificado pelo plano.
Pense em recursos como queries reutilizáveis sobre os seus dados de uso. Você define a query uma vez e ela é executada automaticamente a cada ciclo de cobrança.

Como recursos se encaixam no fluxo

1

Eventos (dados brutos)

Sua aplicação envia registros de uso para a Aira.
2

Recurso (filtragem + agregação)

O recurso filtra quais eventos contam e agrega seus valores em uma métrica.
3

Plano (precificação)

O plano aplica regras de preço sobre o valor agregado pelo recurso.
4

Fatura

O resultado é um item de linha na fatura do cliente.
Um mesmo conjunto de eventos pode alimentar múltiplos recursos. Por exemplo, a partir de eventos ticket_resolved:
  • Recurso A: soma todos os tickets resolvidos (independente do agente)
  • Recurso B: soma apenas tickets resolvidos por IA (properties.agent_type = "ai")
  • Recurso C: soma apenas tickets resolvidos por humanos
Cada recurso gera uma métrica independente que pode ser precificada de forma diferente no plano.

Criar um recurso

  1. Acesse Recursos no menu lateral
  2. Clique em Novo Recurso
  3. Configure:
    • Nome — nome descritivo (ex: “Requisições de API”)
    • Tipo — Unitário ou Monetário
    • Agregação — Soma, Último do Período ou Único
    • Filtros — quais eventos incluir (por eventName e propriedades)
  4. Salve o recurso

Próximos passos

  • Filtragem e agregação — entenda as opções de filtro e os tipos de agregação em detalhes
  • Tipos de recursos — aprenda a diferença entre recursos unitários e monetários
  • Planos — veja como associar recursos a modelos de precificação