Como configurar webhooks e acompanhar entregas

Webhooks avisam seu sistema quando algo acontece na Moviie, por exemplo quando um vídeo fica pronto ou uma sessão de reprodução termina.

Criar um endpoint

Abra Conta, selecione Webhooks e depois Criar endpoint. Você pode ir direto para Webhooks.

Preencha:

1. Nome para identificar o destino.
2. URL HTTPS que receberá as requisições.
3. Descrição, se quiser registrar o uso.
4. Autenticação, quando o seu receptor exigir um token adicional.
5. Os eventos que devem ser enviados.

Selecione pelo menos um evento e conclua a criação.

Guardar o segredo de assinatura

Depois de criar o endpoint, a Moviie mostra um segredo de assinatura uma única vez. Copie e guarde esse valor em um local protegido.

Use o segredo para verificar se cada requisição foi enviada pela Moviie. A implementação completa da validação está na documentação de webhooks.

Pausar ou alterar eventos

Abra o endpoint para:

• ativar ou pausar o envio;
• alterar nome, URL e autenticação;
• habilitar ou desabilitar grupos de eventos;
• revisar quais entregas pertencem ao endpoint.

Ao mudar a URL, confirme que o novo destino está pronto antes de salvar.

Investigar uma entrega

Use Histórico para filtrar e abrir uma entrega. Confira o evento, a resposta do seu endpoint e as tentativas realizadas.

Quando a causa já estiver corrigida, use a ação de repetir entrega disponível na página. Evite repetir antes de garantir que seu receptor trata o mesmo evento mais de uma vez sem duplicar efeitos.

Continue aprendendo

Aprofunde esta tarefa com os próximos guias:

• Como migrar vídeos com a extensão da Moviie
• Como criar e revogar chaves de API