# Eventos

Evento é a entidade central da plataforma. Tudo que acontece na sua operação — uma transação, uma autenticação, um marco logístico — chega à plataforma na forma de um evento.

Ao modelar suas ocorrências como eventos, você ganha um ponto único e padronizado para ingestão de dados, independentemente do domínio de negócio. Isso permite:

* **analisar dados em tempo real**: acompanhe o que está acontecendo na sua operação assim que os eventos chegam;
* **criar métricas customizadas**: agregue valores, calcule taxas e acompanhe tendências diretamente dos eventos recebidos;
* **configurar monitoramentos**: defina regras para detectar anomalias, riscos ou quedas de performance;
* **evoluir sem acoplamento**: adicione novos campos e tipos de evento sem quebrar integrações existentes.

<div class="event-illustration">
  <div class="event-card">
    <div class="event-card-header">Tipo de Evento</div>
    <pre class="event-card-body"><span class="ei-key">type</span>:     <span class="ei-pink">"transaction"</span>
<span class="ei-key">fields</span>:
  <span class="ei-key">amount</span>:   <span class="ei-type">number</span>
  <span class="ei-key">status</span>:   <span class="ei-type">string</span>
  <span class="ei-key">currency</span>: <span class="ei-type">string</span></pre>
    <div class="event-card-label">schema</div>
  </div>
  <div class="event-illustration-arrow">
    <svg width="32" height="14" viewBox="0 0 32 14" fill="none" xmlns="http://www.w3.org/2000/svg"><line x1="0" y1="7" x2="26" y2="7" stroke="#E3007E" stroke-width="1.5"/><polyline points="20,2 27,7 20,12" stroke="#E3007E" stroke-width="1.5" fill="none" stroke-linejoin="round"/></svg>
    valida
  </div>
  <div class="event-card">
    <div class="event-card-header">Evento</div>
    <pre class="event-card-body"><span class="ei-key">type</span>:     <span class="ei-pink">"transaction"</span>
<span class="ei-key">id</span>:       <span class="ei-str">"evt_8f3a"</span>
<span class="ei-key">amount</span>:   <span class="ei-num">99.90</span>
<span class="ei-key">status</span>:   <span class="ei-str">"approved"</span>
<span class="ei-key">currency</span>: <span class="ei-str">"BRL"</span></pre>
    <div class="event-card-label">ocorrência</div>
  </div>
</div>

## Como eventos se organizam

Cada evento pertence a um **tipo de evento**, que define o contrato de dados esperado — quais campos existem, seus tipos e obrigatoriedade. Esses tipos podem representar contextos diferentes de negócio, como transação financeira (`transaction`), autenticação de usuário (`user_authentication`) e marcos logísticos de entrega (`logistics_delivery_event`).

Você define os tipos de evento conforme a realidade da sua operação e envia as ocorrências para o endpoint `POST /events`. A plataforma valida, processa e disponibiliza os dados para análise, métricas e monitoramentos.

## Índice

- [Tipos de evento](/pt/events/event_types/index.html.md)
- [Campos](/pt/events/event_fields/index.html.md)
- [Eventos](/pt/events/events/index.html.md)