ByDomuDevelopers

finder.submitted

Búsqueda enviada desde la web

Objeto · finderIncluye · contactAl instante

Cuándo se emite

Alguien usó el buscador guiado (POST /v1/finder). finder trae el id del contacto y las propiedades que encajaron.

Al instante, cuando pasa en ByDomu: desde la app, la API, Noa, una automatización o una integración. actor.kind dice quién fue: USER, NOA, SYSTEM, API, AUTOMATION o INTEGRATION.

Suscríbete con

  • finder.submittedSolo este evento
  • finder.*Todos los de Buscador de la web
  • *Todo el catálogo

Campos que trae

rutas para filtrar y plantillas
finder.contactIdContacto
finder.preferencesLo que busca
contact.idIdentificador del contacto
contact.codeCódigo del contacto
contact.firstNameNombre
contact.lastNameApellido
contact.emailCorreo
contact.phoneTeléfono
contact.sourceOrigen
contact.statusEstado
contact.typeTipo de contacto
contact.scorePuntaje
contact.ownerIdResponsable
contact.preferredCityCiudad de interés
contact.preferredTypeTipo de inmueble que busca
contact.budgetPresupuesto
contact.tagsEtiquetas

Hasta 5 intentos (0 s, 5 s, 30 s, 2 min y 10 min) ante error de red, 429 o 5xx. Responde 2xx en 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"
    }
  }
}
Pídelo con tus datos de pruebaGET /v1/webhooks/sample/finder.submitted
Probar