Webhooks

Um webhook informa outra ferramenta que algo aconteceu na sua conta Reigniter. Quando o evento acontece, Reigniter envia uma mensagem JSON assinada para o endereço que você escolher. Esse endereço pode ser o gatilho de webhook de uma automação, outra ferramenta de fluxo de trabalho ou seu próprio servidor.

Adicione uma assinatura, e todo evento é enviado para seu endereço como assinado JSON.

Eventos

Evento	Rótulo no app	Enviado quando
video.completed	Vídeo concluído	Um vídeo de renderização termina. A mensagem carrega um link de download que funciona por 7 dias.
video.failed	Vídeo falhou	Uma renderização de vídeo falha.
training.completed	O aprendiz terminou um módulo	Um aprendiz nomeado chega ao final de um módulo, com sua pontuação e se passou.
training.overdue	Aprendizismo atrasado	Um aluno não terminou até a data prevista.

A lista completa está em Webhooks. Dentro de Automações você não precisa de webhook: os gatilhos Reigniter (Vídeo finalizado, Aprendiz aprovado e os outros) se registram sozinhos.

Adicione um webhook

1. Conectores abertos > webhooks.

2. Selecione Adicionar.

3. Escolha o evento.

4. Cole o endereço que deve recebê-lo. Deve ser um endereço público na web. Endereços em uma rede privada são recusados.

5. Selecione Adicionar.

6. Copie o segredo da assinatura e guarde em um lugar seguro. Ele é mostrado apenas uma vez. Depois, selecione Feito.

Verifique se funciona

Selecione o botão de teste no webhook para enviar uma mensagem de teste assinada. Verifique se ela chegou ao seu endereço.

Verifique cada mensagem

Toda mensagem é assinada com seu segredo de assinatura. Sua ferramenta de recepção deve verificar a assinatura antes de confiar na mensagem, assim ninguém mais pode enviar eventos falsos para ela. Como verificar a assinatura está coberto no guia de webhooks API.

Cada mensagem também carrega um ID de entrega que permanece o mesmo quando uma entrega é tentada novamente. Use-o para ignorar duplicados.

Pausa, retomar ou excluir

Cada webhook na lista possui botões para:

• Pausa. Aparece pausado e não recebe nada até você retomar.
• Apague.

Quando as entregas falham

• Reigniter tenta uma entrega falhada algumas vezes.
• O webhook mostra quantas entregas consecutivas falharam, por exemplo, 3 falharam. Uma entrega bem-sucedida reinicia a contagem.
• Após várias falhas seguidas, o webhook é pausado automaticamente. Corrija o endereço e depois retome-o.
• Um webhook falhado nunca afeta seus renders.

Faça vídeos com outra ferramenta

Webhooks enviam eventos para fora de Reigniter. Para fazer vídeos de outra ferramenta, use uma chave API. Veja Construir uma automação ou o API quickstart.