Pular para o conteúdo

Receber eventos de webhook

Um diretor da imobiliária configura um endpoint HTTPS em Integrações → Webhooks e seleciona explicitamente os tipos de evento necessários para o parceiro. A Morus publica um evento somente quando a empresa possui uma assinatura ativa para aquele tipo.

Cada entrega é um POST HTTP com corpo JSON e os seguintes headers:

Header Finalidade
Webhook-Id Identificador estável do evento usado na deduplicação
Webhook-Type Tipo do evento correspondente ao corpo
Webhook-Timestamp Horário Unix em segundos incluído no conteúdo da assinatura
Webhook-Attempt Número da tentativa automática ou manual atual
Webhook-Signature Assinatura HMAC-SHA256 no formato v1=<hex>

Retorne qualquer status 2xx em até 10 segundos. Depois de validar e aceitar o evento de forma durável, processe tarefas demoradas de forma assíncrona.

{
"id": "evt_0123456789abcdef0123456789abcdef",
"type": "rental_insurance.created",
"occurredAt": "2026-09-15T15:30:00Z",
"apiVersion": "v1",
"data": {
"id": 812,
"externalId": "RI-2026-0042",
"status": "under_review"
}
}

Consulte o catálogo de eventos gerado para conhecer todos os eventos e conteúdos.