Estratégia de Fallback

Em caso de indisponibilidade do serviço de webhook, é recomendado implementar um mecanismo de fallback para garantir que sua aplicação ainda consiga recuperar o resultado do processo dentro do tempo de resposta esperado.

Como funciona

O webhook é o mecanismo principal de entrega de resultados. No entanto, você deve tratar os seguintes sinais como gatilhos adicionais para buscar ativamente o resultado via GET /client/v1/process/{processId}:

Sinal	Canal	O que fornece
Callback onFinish	SDK Web / WebMobile	Sinal de fim de jornada — sem resultado
Redirecionamento callbackUri	Todos os outros canais	Apenas redirecionamento de URL — sem resultado

aviso

Nem onFinish nem callbackUri entregam o resultado do processo diretamente. Eles são apenas sinais de fim de jornada. Seu back-end é responsável por correlacionar o id recebido (ou o redirecionamento) com o processId previamente armazenado, e então chamar o GetProcess para recuperar o resultado real.

Fluxo recomendado

Após receber um sinal de fim de jornada, seu back-end deve chamar GET /client/v1/process/{processId} e validar o resultado na seguinte ordem:

1. Confirmar state = PROCESS_STATE_FINISHED
2. Avaliar o campo result e aplicar suas regras de negócio

Isso garante que a indisponibilidade temporária do webhook não resulte em perda de resultados de processos.