Inquiries (Solicitudes de Contacto)

Un Inquiry es una solicitud de contacto que un comprador envía sobre una propiedad específica. Va dirigida al agente o propietario de ese inmueble.

---

Enviar solicitud (público)

No requiere autenticación. Cualquier visitante puede enviar una solicitud.

POST /api/properties/:propertyId/inquiries
Content-Type: application/json

Body:

{
  "name": "María López",
  "email": "maria@email.com",
  "phone": "+52 55 5555 6666",
  "message": "Hola, me interesa agendar una visita para este fin de semana. ¿Tienen disponibilidad el sábado?",
  "preferredContactMethod": "whatsapp"
}

Respuesta 201:

{
  "success": true,
  "message": "Inquiry submitted successfully",
  "data": {
    "id": "uuid-inquiry",
    "propertyId": "uuid-propiedad",
    "status": "pending",
    "createdAt": "2026-05-13T14:30:00.000Z"
  }
}

---

Listar solicitudes de una propiedad

Requiere autenticación

Solo el agente o admin de la propiedad puede ver sus solicitudes.

GET /api/properties/:propertyId/inquiries
Authorization: Bearer {token}

---

Mis solicitudes (como comprador)

GET /api/my-inquiries
Authorization: Bearer {token}

---

Solicitudes recibidas (como agente)

GET /api/agent/inquiries
Authorization: Bearer {token del agente}

---

Solicitudes de la agencia

GET /api/agency/inquiries
Authorization: Bearer {token del agency_admin}

---

Detalle de solicitud

GET /api/inquiries/:id
Authorization: Bearer {token}

---

Actualizar estado de solicitud

PUT /api/inquiries/:id/status
Authorization: Bearer {token}
Content-Type: application/json

{
  "status": "contacted"
}

Estados posibles:

Estado	Descripción
pending	Solicitud nueva sin atender
contacted	El agente ya contactó al comprador
scheduled	Visita agendada
closed	Solicitud cerrada
cancelled	Solicitud cancelada