Voltar ao blog

Webhooks para render de vídeo: conclusão confiável

Crie handlers rápidos e idempotentes com polling de fallback.

6 de set. de 2026RenderingVideo TeamRenderingVideo Team
Webhooks para render de vídeo: conclusão confiável

Webhooks para render de vídeo: conclusão confiável

Webhooks notificam o fim do render assíncrono sem consultas constantes. Informe webhook_url ao iniciar o render, não apenas ao criar a tarefa.

Princípios principais

  • Usar uma URL HTTPS acessível publicamente.
  • Validar, registrar o status e responder rápido.
  • Neutralizar eventos duplicados com task ID e estado terminal.
  • Confirmar pela API antes de ações irreversíveis.

Fluxo recomendado

  1. Buscar o job local pelo task ID remoto.
  2. Detectar estado terminal já processado.
  3. Salvar status e resultado em uma transação.
  4. Mover downloads e notificações para uma fila.

Dica de produção

Como ainda não existe assinatura de webhook, use um caminho difícil de adivinhar e reconcilie jobs abertos por polling.

Saiba mais