Enriquecimento de Imóvel

Visão Geral

O webhook de Enriquecimento de Imóvel é disparado pela Morada.ai quando o processo automático de enriquecimento de dados de um imóvel é concluído. Inclui informações como nome do local, descrição, pontos de interesse próximos e mídias associadas.

Este webhook é específico para parceiros que utilizam o módulo de enriquecimento de propriedades (Enri). Consulte o suporte para verificar a disponibilidade.

Payload

{
  "source": {
    "id": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
    "name": "Edifício Aurora Torre A",
    "external_id": "EMP-12345"
  },
  "enrichment": {
    "place_name": "Edifício Aurora",
    "meta": {
      "description": "Empreendimento residencial de alto padrão localizado na Zona Sul de São Paulo, próximo ao Parque do Ibirapuera. Oferece apartamentos de 2 e 3 dormitórios com varanda gourmet."
    },
    "points_of_interest": [
      { "name": "Metrô Brigadeiro" },
      { "name": "Shopping Ibirapuera" },
      { "name": "Parque do Ibirapuera" },
      { "name": "Hospital São Luiz" }
    ],
    "media": [
      {
        "url": "https://storage.morada.ai/media/foto-fachada.jpg",
        "group": "facade",
        "description": "Fachada principal do empreendimento"
      },
      {
        "url": "https://storage.morada.ai/media/foto-lazer.jpg",
        "group": "common_area",
        "description": "Área de lazer com piscina e churrasqueira"
      }
    ]
  },
  "metadata": {
    "timestamp": "2026-05-13T18:30:00.000Z",
    "eventType": "property_enrichment"
  }
}

Campos

source

Campo	Tipo	Descrição
`source.id`	string	ID interno do enriquecimento
`source.name`	string	Nome do imóvel/empreendimento
`source.external_id`	string	ID do imóvel no sistema do parceiro

enrichment

Campo	Tipo	Descrição
`enrichment.place_name`	string \| null	Nome do local identificado
`enrichment.meta.description`	string \| null	Descrição gerada automaticamente sobre o imóvel e região
`enrichment.points_of_interest`	array \| null	Lista de pontos de interesse próximos
`enrichment.points_of_interest[].name`	string	Nome do ponto de interesse
`enrichment.media`	array	Lista de mídias associadas ao imóvel
`enrichment.media[].url`	string	URL da mídia
`enrichment.media[].group`	string	Categoria da mídia (ex: `facade`, `common_area`, `floor_plan`, `interior`)
`enrichment.media[].description`	string	Descrição da mídia

metadata

Campo	Tipo	Descrição
`metadata.timestamp`	string	Data/hora do envio do webhook (ISO 8601)
`metadata.eventType`	string	Sempre `"property_enrichment"`

Exemplo de uso

app.post("/webhook/morada", (req, res) => {
  const { source, enrichment } = req.body;

  console.log(`Enriquecimento concluído: ${source.name} (${source.external_id})`);

  if (enrichment.place_name) {
    console.log(`Local: ${enrichment.place_name}`);
  }

  if (enrichment.points_of_interest) {
    const pois = enrichment.points_of_interest.map(p => p.name).join(", ");
    console.log(`Pontos de interesse: ${pois}`);
  }

  console.log(`Mídias: ${enrichment.media.length} arquivo(s)`);

  // Atualizar ficha do imóvel no seu sistema

  res.status(200).json({ received: true });
});

@app.route("/webhook/morada", methods=["POST"])
def handle_webhook():
    data = request.json
    source = data["source"]
    enrichment = data["enrichment"]

    print(f"Enriquecimento: {source['name']} ({source['external_id']})")

    if enrichment.get("points_of_interest"):
        pois = [p["name"] for p in enrichment["points_of_interest"]]
        print(f"Pontos de interesse: {', '.join(pois)}")

    print(f"Mídias: {len(enrichment['media'])} arquivo(s)")

    return jsonify({"received": True}), 200

Resposta esperada

Retorne um status HTTP 200 para confirmar o recebimento:

{
  "received": true
}

Se o seu endpoint retornar um status diferente de 2xx ou não responder dentro do timeout, a Morada.ai poderá tentar reenviar o evento. Implemente idempotência para lidar com entregas duplicadas.

Visão Geral

Deals

Leads

Notificações

Produtos

Data

Webhooks

Enriquecimento de Imóvel

Visão Geral

Payload

Campos

source

enrichment

metadata

Exemplo de uso

Resposta esperada

​Visão Geral

​Payload

​Campos

​source

​enrichment

​metadata

​Exemplo de uso

​Resposta esperada

Visão Geral

Payload

Campos

source

enrichment

metadata

Exemplo de uso

Resposta esperada