Utilizando webhooks no VTurb
Com essa funcionalidade, você pode integrar o VTurb a outros sistemas e receber informações sobre eventos relacionados aos seus vídeos, como criação, processamento, conclusão de upload, atualização, falha ou exclusão.
Como acessar os Webhooks
- Acesse sua conta no VTurb.
- No menu lateral esquerdo, clique em Configurações.
- Na parte superior da página de Configurações, selecione a opção Webhooks.
- Clique em Novo webhook para iniciar a configuração.

Criando um novo webhook
Ao clicar em Novo webhook, será aberta uma janela para configurar a integração.

Você deverá informar:
- URL do webhook: endereço do endpoint que receberá os eventos enviados pela VTurb. Este campo é obrigatório.
- Secret de assinatura: chave de segurança gerada automaticamente pela VTurb, utilizada para ajudar o seu servidor a validar que as requisições recebidas foram realmente enviadas pela VTurb.
- Eventos de mídia: selecione quais eventos deverão ser enviados para o webhook.
Os eventos disponíveis são:
- Upload de vídeo concluído: enviado quando o upload do arquivo de vídeo é finalizado.
- Processando vídeo: enviado quando o vídeo entra na etapa de processamento.
- Falha no vídeo: enviado quando ocorre uma falha durante o processamento do vídeo.
- Vídeo excluído: enviado quando um vídeo é removido da conta.
- Vídeo criado: enviado quando um novo vídeo é criado na conta.
- Vídeo pronto: enviado quando o vídeo termina o processamento e está pronto para uso.
- Vídeo atualizado: enviado quando alguma atualização é realizada no vídeo.
Após configurar a URL e selecionar os eventos desejados, clique em Salvar.

Ao finalizar a configuração, ele aparece assim em seu painel:

Gerenciando seus Webhooks
Depois de adicionar um webhook, ele será exibido na página de Webhooks da sua conta.
Nessa tela, você pode acompanhar algumas informações da integração, como:
- Status
- Atividade
- Tempo de resposta
- Taxa de erro (15 dias)
Também estão disponíveis algumas ações para gerenciar e testar o webhook.

Enviando um evento de teste
Na coluna Ações, clique no ícone de seta para utilizar a opção Enviar evento de teste.
Essa opção também pode ser acessada pelo menu de três pontos do webhook.

Outras ações disponíveis
Ao clicar nos três pontos, você terá acesso às seguintes opções:
- Editar
- Ver logs
- Enviar evento de teste
- Pausar
- Remover

Pronto!
Agora você já sabe como acessar, configurar e gerenciar Webhooks no VTurb.
Utilize os Webhooks para receber os eventos selecionados da sua conta e integrar essas informações ao seu endpoint. 🚀
Atualizado em: 25/09/2026
Obrigado!
