Inicio

Configure sua integração para receber eventos automaticamente e mantenha sua aplicação atualizada em tempo real.

Os webhooks são o mecanismo que a Even3 utiliza para avisar automaticamente sistemas externos sempre que determinadas ações acontecem no seu evento.

Em vez de consultar a API repetidamente para descobrir se algo mudou, sua aplicação recebe uma notificação em tempo real assim que inscrições, vendas, check-ins ou submissões de trabalho são atualizados.

Com isso, é possível construir integrações mais eficientes, reduzir consultas desnecessárias e manter diferentes sistemas sincronizados sem esforço manual.

Os webhooks são recomendados para integrações que precisam:

• receber notificações em tempo real;
• sincronizar participantes com CRM, ERP ou planilhas automaticamente;
• liberar acessos, conteúdos ou comunicações após a confirmação de uma inscrição;
• acompanhar vendas, cancelamentos e reembolsos do evento;
• acompanhar o fluxo de submissão e avaliação de trabalhos;
• reduzir a necessidade de consultas constantes à API;
• implementar arquiteturas orientadas a eventos.

Esse modelo é indicado para a maioria das integrações em produção.

De forma simplificada, o fluxo acontece assim:

Uma ação acontece no seu evento na Even3
↓
A Even3 identifica os webhooks configurados
↓
A notificação é enviada para a URL da sua aplicação
↓
Seu sistema recebe o evento
↓
O evento é processado
↓
Sua integração atualiza os dados

Cada notificação carrega as informações do recurso que originou a ação, além de um identificador único do disparo e o nome do gatilho correspondente.

Uma implementação típica costuma seguir esta jornada:

Criar o webhook
↓
Definir o token de segurança
↓
Configurar o endpoint da aplicação
↓
Selecionar os gatilhos monitorados
↓
Receber as notificações
↓
Implementar idempotência
↓
Acompanhar entregas e tratar falhas

Durante a implementação, alguns pontos merecem atenção:

• os eventos são enviados para uma URL definida por você na configuração da integração;
• uma única ação pode disparar mais de um gatilho, uma inscrição paga, por exemplo, gera notificação de venda e de inscrição;
• o envio para a fila e a entrega ao seu sistema são etapas distintas: a primeira registra a ação, a segunda depende da fila de processamento;
• respostas fora da faixa 2xx, ou sem retorno dentro do tempo esperado, geram novas tentativas de entrega;
• webhooks que ficam dias seguidos sem nenhuma entrega bem-sucedida são desativados automaticamente;
• a implementação precisa ser idempotente para evitar processamentos duplicados;
• regras de firewall ou proteção de borda podem bloquear as requisições enviadas pela Even3.

Para começar a receber eventos, é necessário informar a URL da sua aplicação que ficará responsável por receber as notificações enviadas pela Even3. Essa URL deve estar preparada para receber requisições POST e tratar corretamente o conteúdo enviado.

A configuração pode ser feita pela interface da plataforma ou, em alguns fluxos, por meio da própria API. Além disso, é importante definir com atenção quais eventos cada webhook deverá receber, para que sua integração trabalhe apenas com o que realmente faz sentido para a sua operação.

Quanto mais objetiva for essa configuração, mais simples, organizada e eficiente tende a ser a manutenção da integração no dia a dia. Veja abaixo todo o processo dentro da Even3:

Defina seu token de segurança - crie uma chave (token) para ser utilizada no seu header e trazer mais segurança aos dados. Escolha seus gatilhos - escolha os gatilhos desejados e onde será feito o POST contendo as informações do evento.

Ao trabalhar com webhooks, alguns cuidados ajudam a tornar o recebimento dos eventos mais previsível, seguro e eficiente:

1. Utilize webhooks sempre que possível em vez de consultas periódicas.
2. Implemente processamento idempotente.
3. Monitore os logs da integração.
4. Garanta que a aplicação responda adequadamente às notificações.
5. Valide periodicamente os eventos configurados.
6. Monitore filas interrompidas e penalizações.

Se você está começando uma integração baseada em eventos, recomendamos seguir esta sequência:

1. Criar o token de segurança da integração.
2. Cadastrar a URL que vai receber as notificações.
3. Selecionar os gatilhos monitorados.
4. Receber e validar os eventos no endpoint.
5. Implementar idempotência.
6. Configurar o monitoramento e o tratamento de falhas.