ByDomuDevelopers

finder.submitted

Busca enviada pelo site

Objeto · finderInclui · contactNa hora

Quando é emitido

Alguém usou o buscador guiado (POST /v1/finder). finder traz o id do contato e os imóveis que combinaram.

Na hora, quando acontece no ByDomu: pelo app, pela API, pela Noa, por uma automação ou uma integração. actor.kind diz quem foi: USER, NOA, SYSTEM, API, AUTOMATION ou INTEGRATION.

Assine com

  • finder.submittedSó este evento
  • finder.*Todos os de Busca do site
  • *O catálogo inteiro

Campos que traz

caminhos para filtros e modelos
finder.contactIdContato
finder.preferencesO que procura
contact.idIdentificador do contato
contact.codeCódigo do contato
contact.firstNameNome
contact.lastNameSobrenome
contact.emailE-mail
contact.phoneTelefone
contact.sourceOrigem
contact.statusStatus
contact.typeTipo de contato
contact.scorePontuação
contact.ownerIdResponsável
contact.preferredCityCidade de interesse
contact.preferredTypeTipo de imóvel que procura
contact.budgetOrçamento
contact.tagsEtiquetas

Até 5 tentativas (0 s, 5 s, 30 s, 2 min e 10 min) em erro de rede, 429 ou 5xx. Responda 2xx em menos de 10 s.

{
  "event": "FINDER_SUBMITTED",
  "id": "5f3a0c1e-7d2b-4f7e-9a51-0b6c1d2e3f40",
  "type": "finder.submitted",
  "timestamp": "2026-09-22T14:30:00.000Z",
  "organizationId": "clx1org001",
  "actor": {
    "kind": "API",
    "userId": null
  },
  "data": {
    "finder": {
      "contact": {
        "id": "clx1con009"
      },
      "properties": [
        {
          "id": "clx1prop001",
          "code": "P-0042",
          "title": "Apartamento en Chapinero Alto con balcón",
          "type": "APARTMENT",
          "transactionType": "SALE",
          "price": 450000000,
          "currency": "COP",
          "city": "Bogotá",
          "neighborhood": "Chapinero Alto",
          "bedrooms": 3,
          "bathrooms": 2,
          "area": 85,
          "matchScore": 87,
          "breakdown": [
            {
              "criterio": "presupuesto",
              "puntos": 30,
              "estado": "match"
            },
            {
              "criterio": "barrio",
              "puntos": 20,
              "estado": "match"
            },
            {
              "criterio": "habitaciones",
              "puntos": 15,
              "estado": "match"
            }
          ],
          "image": "https://cdn.bydomu.com/props/clx1prop001/1.jpg"
        }
      ],
      "total": 1,
      "source": "api"
    }
  }
}
Peça com seus dados de testeGET /v1/webhooks/sample/finder.submitted
Testar