Webhook
Um webhook é um mecanismo de notificação automática que permite a um sistema enviar dados em tempo real para outro sistema assim que um evento específico ocorre. No contexto da verificação documental, os webhooks informam instantaneamente a aplicação cliente do resultado de uma verificação sem necessidade de consultar o servidor continuamente.
Ao contrário do modelo clássico de pedido-resposta (polling), em que a aplicação cliente deve consultar regularmente o servidor para verificar se um processamento está concluído, o webhook inverte esta lógica: é o servidor que «empurra» a informação para a aplicação assim que está disponível. Tecnicamente, o cliente fornece um URL de callback para o qual o servidor envia um pedido HTTP POST contendo os dados do evento em formato JSON.
Num fluxo de trabalho de verificação KYC, os webhooks desempenham um papel crucial nos processos assíncronos. Quando um documento requer uma análise aprofundada (verificação avançada de autenticidade, revisão manual por um analista, consulta a bases de dados externas), o resultado não é imediato. O webhook notifica a aplicação assim que a verificação está completa, permitindo ao sistema atualizar o estado do dossiê e informar o utilizador final sem demora.
Os webhooks do CheckFile cobrem todo o ciclo de vida de uma verificação: submissão recebida, extração concluída, análise de autenticidade finalizada, decisão final (aceite/rejeitado/revisão necessária). Cada notificação é assinada criptograficamente para garantir a sua autenticidade e prevenir ataques por injeção. O sistema gere automaticamente as tentativas de reenvio em caso de falha de entrega, com backoff exponencial.
Exemplos concretos
- 1.Um neobanco configura um webhook para ser notificado assim que uma verificação de identidade é concluída: se o documento é validado, a conta é automaticamente ativada; se rejeitado, é enviado um email ao cliente a solicitar um novo comprovativo.
- 2.Uma seguradora utiliza webhooks para acionar automaticamente a etapa seguinte do seu fluxo de subscrição assim que os documentos de identidade e de morada são verificados, sem intervenção humana.
- 3.Uma plataforma de crowdfunding imobiliário recebe uma notificação webhook por cada verificação de comprovativo de investidor, permitindo atualizar em tempo real o painel de conformidade da equipa jurídica.