Considere a seguinte jornada de uma integração: A escola envia um contrato para um aluno, e somente após a finalização desse documento com as assinaturas solicitadas, poderá dar seguimento na matrícula e nos demais processos da escola.
1- Cenário sem webhook: I- O sistema da escola gera o documento de matrícula e envia para o aluno. II - De tempo em tempo o sistema da escola consulta do status do documento no TAE para saber se o documento já foi assinado. obs: A consulta é unitária, então se enviar 1000 matrículas, e estiver conferindo o status de 2 em 2 minutos, o sistema integrador realizaria 1000 requisições a cada dois minutos nas apis do TAE para conferir se o status do documento mudou. III - Quando o status do documento mudar o sistema seguiria com os processos da escola.
2- Cenário com webhook: I- O administrador da empresa indica que gostaria de receber notificações de callback (webhook) para documentos finalizados. II- O sistema da escola gera o documento de matrícula e envia para o aluno. III - Quando o documento for finalizado, o TAE envia uma notificação para o sistema integrador informando que aquele documento foi finalizado e o sistema segue com seus processos da escola.
Vantagens de utilizar o webhook * Receber notificações os eventos que escolher * Receber notificações em tempo real * Remove a necessidade de realizar um processamento em loop, prejudicial a ambos os sistema. * Obtem informações detalhadas e personalizadas sobre cada notificação * Possibilita receber notificações para todos os documentos ou apenas documentos específicos * Interface amigável para gerir webhooks, configurando quais eventos deseja ser notificado
|