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.
Recursos agregam eventos. Se o que você cobra é uma quantidade que a sua aplicação informa e que sobe e desce ao longo do tempo — usuários ativos, filiais, dispositivos —, use Licenças: cada leitura substitui a anterior em vez de somar.

​
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
  • Licenças — cobre quantidades reportadas em vez de eventos acumulados