# Como configurar webhooks e acompanhar entregas

> Crie um endpoint HTTPS, escolha os eventos, guarde o segredo de assinatura e use o histórico para investigar ou repetir entregas.

- Canonical: https://moviie.ai/help/pt-br/integracoes/configurar-webhooks
- Language: pt-BR
- Category: Integrações e migração
- Published: 2026-07-30
- Updated: 2026-07-30

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:

**Nome** para identificar o destino.

**URL HTTPS** que receberá as requisições.

**Descrição**, se quiser registrar o uso.

**Autenticação**, quando o seu receptor exigir um token adicional.

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