Entrega e novas tentativas

A entrega ocorre pelo menos uma vez. Falhas de conexão, estouros de tempo ou respostas fora da faixa 2xx podem gerar novas tentativas automáticas. Por isso, o mesmo evento pode chegar mais de uma vez.

Deduplicar antes de processar

Use Webhook-Id como chave de deduplicação. Armazene o ID e o resultado do processamento de forma atômica com sua alteração de negócio. Retorne 2xx quando receber novamente um ID já processado.

Preservar a ordem quando necessário

Eventos da mesma garantia mantêm a ordem de publicação. Eventos de garantias diferentes podem chegar de forma independente.

Como a entrega ocorre pelo menos uma vez, ainda podem existir duplicidades. O consumidor não deve depender do número da tentativa nem da ordem de chegada entre garantias diferentes.

Responder rapidamente

Valide a assinatura, registre o evento de forma durável e responda em até 10 segundos. Conclua o restante do processamento fora da requisição.

Consultar e reenviar entregas

A aba Integrações → Webhooks da Morus mantém as tentativas de entrega por 30 dias. Diretores da imobiliária e usuários internos autorizados da Morus podem consultar o histórico e solicitar um reenvio manual depois que as tentativas automáticas terminarem.

O reenvio manual preserva a URL e o corpo originais e assina a requisição com o segredo atual da configuração de webhook. Ele cria outro registro no histórico e continua sujeito a entregas duplicadas.