Operações que resultam em um erro que ocorreu por conta do cliente (por exemplo: token de acesso inválido) vão retornar um código no intervalo 4xx e indicam que a requisição está, de alguma forma, inválida. Se você receber um erro 4xx, recomendamos que leia o nosso glossário de erros para ajudá-lo a solucionar o problema.

Os códigos de erros no intervalo 5xx sugerem um problema no serviço cadastrado no momento da configuração do webhook. Em caso de dúvidas, entre em contato com o responsável da sua empresa, os status utilizados seguem o padrão HTTP, já muito consolidado no mercado. Caso a dúvida persista, estamos disponíveis para lhe ajudar através do suporte.

Em caso de respostas de erro, confira algumas dicas do que você pode fazer para solucionar.

Política de reenvio

Caso a tentativa inicial de entrega do webhook falhe — seja por resposta com código HTTP diferente da faixa 2XX ou por timeout superior a 60 segundos — o sistema executará até três tentativas automáticas com os seguintes intervalos progressivos:

• 1ª retentativa: após 15 minutos
• 2ª retentativa: após 30 minutos
• 3ª retentativa: após 150 minutos

Se todas as tentativas, incluindo a original, resultarem em falha, a entrega será marcada como mal sucedida.

Além disso, se um determinado webhook acumular 3 dias consecutivos sem nenhuma entrega bem-sucedida, ele será automaticamente desativado e removido do sistema.

Estrutura

Todo o envio terá a informação de qual Ação 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.

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

Um exemplo completo para a ação “Participante com inscrição confirmada no 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"
      }

📘 FAQ – Gatilhos de Inscrição e Venda (Webhook Even3)

🔹 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 de inscrição.

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

Se você precisa apenas identificar os participantes inscritos, sem considerar se houve pagamento, o gatilho de “inscrição” é suficiente.

Isso vale tanto para a inscrição no evento quanto inscrição em atividades específicas.

🔹 O que acontece se a pessoa gerou um pagamento mas não pagou?

Você deve receber dois gatilhos:

• Participante com inscrição pendente no evento
• Venda iniciada
  
  

🔹 A pessoa se inscreveu e pagou, quais gatilhos são enviados?

Neste caso, também são dois:

• Venda aprovada
• Participante com inscrição confirmada no evento
  
  

🔹 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 eu cancelo a venda ?

Por padrão, cancelar a venda já cancela a inscrição vinculada.

 Ao cancelar serão disparados 2:

• Venda cancelada\reembolsada
• Participante com inscrição cancelada no evento
  
  

🔹 Como faço para relacionar uma venda a uma inscrição?

O payload do gatilho de confirmação de inscrição inclui o código do ingresso. Esse mesmo código estará presente no gatilho de venda, permitindo que você relacione ambos os registros.

🔹 Existem casos onde a inscrição não está relacionada a uma venda?

Sim. Exemplos:

• Participantes cadastrados manualmente pelo organizador;
• Inscrições em eventos gratuitos;
• Acesso direto ao login do evento, sem passar pelo checkout.