Mandar eventos para outras ferramentas com webhooks

Webhook é uma mensagem que o RecReview manda para um endereço web seu, no instante em que algo acontece — uma entrega, uma aprovação, uma versão nova. Aponte para Make, Zapier, n8n ou seu próprio serviço e o resto das suas ferramentas fica sabendo na hora.

Este artigo é para quem monta a integração. Se você só quer que o RecReview mova uma tarefa ou mande um e-mail quando algo acontece, o que você procura são as automações.

Antes de começar: webhooks exigem o plano Pro ou Studio, e você precisa ser dono ou admin do workspace.

Configurar

1. Clique no seu avatar, no canto superior direito, e escolha Configurações do Workspace.
2. Abra a aba Automações e desça até a seção de webhooks, no fim.
3. Ache o evento que interessa e clique em Configurar.
4. Cole o endereço web que deve receber a mensagem.
5. Se quiser, preencha o Secret (opcional, para assinatura HMAC) para o seu lado provar que a requisição veio do RecReview.
6. Clique em Salvar.
7. Com o webhook ativo, use o botão de envio na linha dele para disparar um teste.

O teste responde Webhook enviado! com o código de resposta, ou Falha no envio com o erro.

Uma URL por evento, por workspace. Salvar de novo substitui a URL anterior.

Os eventos

O que chega

Toda requisição tem o mesmo formato: o nome do evento, quando aconteceu e um objeto data com os detalhes.

{
  "event": "video.delivery",
  "timestamp": "2026-09-02T14:03:11.000Z",
  "data": { "project_name": "...", "client_name": "...", "video_title": "...", "version_number": 3 }
}

A mensagem de entrega leva também stats (versões, horas apontadas, dias em aberto, comentários resolvidos e totais), assets com os links de download, review e miniatura, o resumo da IA, quem entregou e quando, e a tarefa vinculada.

Baixar o vídeo pela integração

Dentro de assets há dois links de download, e eles servem a coisas diferentes:

• download_url — o link para PESSOAS. É o que você encaminha por mensagem ou e-mail: quem abre passa pelas mesmas regras de acesso de sempre. Se o seu workspace separa gestor e revisor, um programa que tente baixar por aqui, sem entrar como ninguém, vai receber uma recusa — e é para ser assim.
• automation_download_url — o link para PROGRAMAS. É por ele que a sua integração baixa o arquivo direto, sem precisar entrar como uma pessoa. Use este nos passos automáticos: subir para um drive, arquivar, publicar.

O link de automação vale por 7 dias e só serve para aquele vídeo. Ele deixa de funcionar assim que você troca ou desliga o compartilhamento do vídeo — é assim que se corta o acesso.

Atenção: essas mensagens incluem dados do cliente, como nome e telefone, e o link de automação baixa o arquivo sem pedir nada a mais. Mande só para um serviço que você controla, e não repasse o automation_download_url para o cliente nem para fora da sua automação.

Verificar a requisição

Toda requisição carrega estes cabeçalhos:

• X-Webhook-Signature — sha256= seguido de um HMAC-SHA256 do corpo da requisição, com a sua chave.
• X-Webhook-Event — o nome do evento.
• X-Webhook-Timestamp — o mesmo timestamp do payload.

Calcule a mesma assinatura sobre o corpo cru e compare com o cabeçalho. Preencha o secret ao salvar o webhook: sem ele não há com o que comparar, e não dá para confirmar o remetente.

Falhas e retentativas

Se o seu endereço não responder, o RecReview reenvia a mensagem algumas vezes antes de desistir. Se o seu lado responder com um erro dizendo que recusou a mensagem, aí é definitivo — corrija e dispare o evento de novo. O RecReview não guarda histórico de entregas para você consultar, então mantenha o seu próprio registro.

O endereço precisa ser alcançável na internet pública: endereço local ou interno não funciona.