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
- Clique no seu avatar, no canto superior direito, e escolha Configurações do Workspace.
- Abra a aba Automações e desça até a seção de webhooks, no fim.
- Ache o evento que interessa e clique em Configurar.
- Cole o endereço web que deve receber a mensagem.
- Se quiser, preencha o Secret (opcional, para assinatura HMAC) para o seu lado provar que a requisição veio do RecReview.
- Clique em Salvar.
- 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
| Evento | Dispara quando |
|---|---|
video.delivery |
Um vídeo é enviado para revisão do cliente |
video.delivery_approved |
O cliente aprova o vídeo final |
video.uploaded |
Uma nova versão é enviada |
video.comment_added |
Um comentário é adicionado |
gallery.delivery |
Uma galeria de fotos é enviada para revisão do cliente |
gallery.delivery_approved |
O cliente aprova a galeria de fotos |
gallery.comment_added |
Um comentário é adicionado a uma foto da galeria |
plan.delivery |
Um plano de produção é enviado para o cliente |
script.delivery |
Um roteiro é enviado para o cliente |
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.
Atenção: essas mensagens incluem dados do cliente, como nome e telefone. Mande só para um serviço que você controla.
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.