Gatilhos de Participantes

Visão geral Gatilhos Estrutura FAQ Solicite ajuda

Introdução · Webhook Even3 / Participantes

Gatilhos de participante

Receba notificações automáticas sobre inscrições e check-ins de participantes no seu evento e em suas atividades.

Webhook de participantes

O Webhook é uma ferramenta que permite que sistemas externos sejam notificados automaticamente quando determinadas ações ocorrem na plataforma Even3.

Ao configurar uma URL para recebimento, a Even3 enviará uma requisição HTTP POST com os dados relevantes do evento no momento em que uma ação ocorrer.

Para utilizar os gatilhos de participante, o organizador deverá cadastrar uma ou mais URLs de destino e selecionar quais ações deseja monitorar. Esta página contempla somente ações relacionadas a inscrições e check-ins de participantes.

Dica: o ideal é configurar uma URL específica para cada ação. Porém, também é possível utilizar uma única URL para todos os gatilhos. Com os dados enviados pela Even3 no corpo do POST, é possível identificar a qual ação a notificação se refere.

Descrição de cada ação

Gatilhos de participante

Abaixo estão os gatilhos disponíveis para acompanhar o ciclo de inscrição e presença de participantes no evento e nas atividades.

Nome do gatilho	Quando é disparado	Momento do envio para fila	Observação
Participante com inscrição pendente no evento	Ao iniciar o processo de inscrição sem concluir, como antes do pagamento.	Este gatilho pode levar até 30 minutos para ser enviado. O objetivo é aguardar a confirmação do status da inscrição, evitando notificações desnecessárias.*	Este prazo considera o prazo do checkout padrão, que é de 15 minutos.
Participante com inscrição confirmada no evento	Quando a inscrição do participante é confirmada no evento.	Assim que a inscrição for confirmada.	Independe de pagamento: a inscrição pode ser gratuita, paga ou realizada manualmente pela organização.
Participante com inscrição cancelada no evento	Quando a inscrição do participante é cancelada.	Assim que a inscrição é cancelada.	É disparado quando o participante sai do status Confirmado para Não inscrito, manualmente pela organização ou automaticamente após o cancelamento de uma venda.
Participante com inscrição pendente em uma atividade	Quando o participante escolhe uma atividade, mas a inscrição nela ainda não foi confirmada.	Este gatilho pode levar até 30 minutos para ser enviado. O objetivo é aguardar a confirmação do status da inscrição, evitando notificações desnecessárias.	Os 30 minutos consideram o prazo do checkout padrão, que é de 15 minutos.
Participante com inscrição confirmada em uma atividade	Quando a inscrição na atividade é aprovada.	Assim que o status muda para Confirmado.	A inscrição pode ser gratuita ou paga e pode envolver aprovação manual pelo organizador ou aprovação automática.
Participante com inscrição cancelada em uma atividade	Quando a inscrição na atividade é cancelada.	Assim que o status muda para Não inscrita.	É disparado quando a pessoa estava inscrita na atividade e deixa de estar.
Participante realizou check-in no evento	Quando o participante realiza o check-in no evento principal.	Assim que o check-in é confirmado.	Pode ocorrer por leitura de QR Code, API ou manualmente na área de credenciamento.
Participante realizou check-in na atividade	Quando o participante realiza check-in em uma atividade específica.	Assim que o check-in é confirmado.	Pode ocorrer por leitura de QR Code, API ou manualmente na área de credenciamento.

* Exemplo: se o participante gera um Pix e paga em alguns minutos, enviar a notificação imediatamente resultaria em um status Pendente seguido de Confirmado. O atraso garante mais precisão nas notificações.

Payload

Estrutura da notificação

Todo envio terá a informação de qual ação ele se refere. No exemplo abaixo, a ação é Participante com inscrição confirmada no evento.

Toda ação enviada terá um identificador único para cada disparo.

Identificação da ação

{
"id": "14B063E9-7290-4642-AC42-672542204765",
"created": 1680626522,
"type": {
"id": 2,
"name": "Participante com inscrição confirmada no evento"
}
}

Exemplo completo: participante com inscrição confirmada no evento

Dados do participante, inscrição e evento

{
"pessoa": {
"id": 111111,
"nome": "Fulano De tal",
"email": "fulano@gmail.com",
"nacionalidade": "Brasileira",
"cpf": "",
"passaporte": "",
"nome_para_cracha": "",
"celular": "",
"telefone_fixo": "",
"formacao_academica": null,
"area_conhecimento": null,
"subarea_conhecimento": null,
"genero": "M",
"instituicao": "Não Respondeu",
"foto": " ",
"data_nascimento": null,
"cargo_instituicao": null,
"endereco.rua": "",
"endereco.numero": "",
"endereco.bairro": "",
"endereco.cep": "",
"endereco.cidade": null,
"endereco.estado": null,
"endereco.pais": "Brasil",
"cultura": "pt",
"personalizado": []
},
"inscricao": {
"id": 12345,
"codigo": "12345",
"titulo": "Entrada Teste",
"data_inscricao": "2023-02-09T13:26:00"
},
"evento": {
"id": 1111,
"url": "teste-1111",
"titulo": "Evento Teste",
"data": "2023-02-19T00:00:00"
}
}

Dúvidas frequentes

FAQ - Gatilhos de participante

Qual a diferença entre inscrição e venda?

Inscrição: ato de se cadastrar no evento, independentemente do pagamento.

Venda: ato de adquirir um ingresso pago, gerando uma transação financeira. Eventos gratuitos não geram gatilhos de venda, apenas gatilhos de inscrição.

Quero apenas saber se a pessoa está inscrita. Qual gatilho devo usar?

Se você precisa apenas identificar participantes inscritos, sem considerar se houve pagamento, o gatilho de inscrição confirmada é suficiente. Isso vale tanto para a inscrição no evento quanto para inscrições em atividades específicas.

Em que situações uma inscrição fica pendente?

Uma inscrição fica pendente quando:

o participante finaliza o checkout, mas não conclui o pagamento;
a inscrição é gerada via link direto, mas o pagamento não é realizado;
o ingresso é emitido, mas o status depende de aprovação ou outro gatilho posterior.

O que acontece se uma venda for cancelada?

Por padrão, cancelar uma venda também cancela a inscrição vinculada. Nesse cenário, além do gatilho financeiro correspondente, será disparado o gatilho Participante com inscrição cancelada no evento.

Existem casos em que a inscrição não está relacionada a uma venda?

Sim. Alguns exemplos são:

participantes cadastrados manualmente pelo organizador;
inscrições em eventos gratuitos;
acesso direto ao login do evento, sem passar pelo checkout.

Por que preciso tratar notificações repetidas?

Em caso de falha ou timeout, a Even3 pode reenviar a mesma notificação conforme a política de reenvio. Por isso, sua aplicação deve utilizar o identificador único de cada disparo para evitar processar a mesma ação mais de uma vez.