O que é Evento?

O que é um evento

Evento é a representação de uma ocorrência reconhecida por um sistema, como a confirmação de um pagamento ou a conclusão de um upload. Ele descreve algo que aconteceu e pode fornecer informações para que outras partes da aplicação reajam à mudança.

Em uma integração, você pode receber um evento de pagamento confirmado e usar essa informação para liberar uma matrícula. A confirmação pertence ao sistema de pagamentos, enquanto a liberação da matrícula é uma ação posterior da automação que recebeu o aviso.

A ocorrência, a mensagem e a reação

A mensagem transporta a descrição do evento até outro componente. Ela pode chegar por webhook ou por uma fila, e a reação depende do que o sistema de destino foi programado para fazer com aquele tipo de ocorrência.

Essas partes podem ter resultados diferentes. O pagamento pode estar confirmado na origem enquanto a mensagem ainda está em uma tentativa de entrega, ou a mensagem pode ter chegado e a liberação da matrícula ter falhado depois.

Como identificar o que aconteceu

Uma mensagem de evento costuma informar o tipo da ocorrência, sua origem e o objeto relacionado. Alguns contratos também incluem um identificador do evento e o horário da ocorrência, permitindo distinguir duas mudanças do mesmo pagamento.

O código do pagamento identifica o objeto, enquanto o identificador do evento pode distinguir sua confirmação de um reembolso posterior. Usar apenas o código do pagamento para descartar repetições poderia eliminar o reembolso como se fosse uma segunda entrega da confirmação.

A especificação CloudEvents padroniza atributos para descrever eventos, mas nem toda integração adota esse formato. Você precisa consultar o contrato da origem para saber quais campos identificam a ocorrência e qual combinação deve ser usada na deduplicação.

Um aviso do passado pode chegar depois de uma mudança nova

O horário de recebimento pode ser diferente do horário da ocorrência. Uma tentativa de entrega atrasada pode chegar quando o objeto já passou por outra mudança, e o conteúdo do evento pode retratar o estado anterior.

Também pode haver mais de uma entrega da mesma ocorrência, dependendo do serviço e de sua política de repetição. A documentação da Stripe, por exemplo, orienta a tratar eventos duplicados e não depender da ordem de entrega dos webhooks.

No exemplo da matrícula, receber uma confirmação antiga depois de um reembolso exige verificar qual comportamento o processo prevê. Consultar o estado atual na origem pode ser apropriado para sincronizar o acesso, enquanto manter o histórico de ocorrências exige preservar a sequência e o significado de cada evento.

Evento e comando têm intenções diferentes

Um comando solicita uma ação, como liberar uma matrícula. Um evento informa uma ocorrência, como pagamento confirmado, e pode ser observado por mais de uma integração, cada uma com uma reação própria.

Ao investigar uma matrícula ausente, confira separadamente a ocorrência na cobrança, as tentativas de entrega e a execução no destino. A ausência no histórico da automação ainda exige verificar filtros, disponibilidade e retenção dos registros antes de concluir que a mensagem se perdeu.

Aplicação na formação

n8n Experts

Eventos comunicam ocorrências que podem iniciar ou orientar a execução de automações.

Conhecer a formação →