# Avisos de incidencias de los huéspedes

¿Se ha roto algo durante una estancia? Con los avisos de incidencias activados, los huéspedes te lo comunican en el portal del huésped: sin formularios aparte y sin buscar un número de teléfono. La reserva, la propiedad y las fechas se rellenan automáticamente.

## 1. Actívalo

1. Abre **Settings → Issue reports**.
2. Marca **Guests can report issues**.
3. Opcional: introduce la dirección de email que recibe los avisos (por ejemplo, tu equipo de mantenimiento). Si lo dejas vacío, se usa la dirección de notificaciones del anfitrión de **Settings → Email**.
4. **Save**.

Los avisos de incidencias están desactivados hasta que los actives. Puedes volver a desactivarlos en cualquier momento; los avisos ya recibidos se quedan en el panel.

## 2. Qué ve el huésped

En cuanto la guía de la estancia se desbloquea (check-in y pagos completados) y hasta un día después del check-out, el portal del huésped muestra **Report an issue** en *¿Necesitas algo?* y en el botón de ayuda. El huésped indica:

- **Type of issue** (tipo de problema): aire acondicionado o calefacción, fontanería, agua caliente, electricidad, wifi o TV, electrodoméstico, puerta, cerradura o llave, limpieza, plagas, ruido, algo que falta u otro.
- **Qué ha pasado** y, opcionalmente, el número de apartamento o de puerta.
- **Fotos**: hasta 4, hechas con la cámara del móvil.
- **Cuánta urgencia tiene**: urgente, pronto o no urgente (para después de la estancia).
- **Mejor momento para la visita**: mañana, tarde o tarde-noche.
- **Si tu equipo puede entrar** cuando el huésped no está (llaves en la caja de llaves) o si el huésped espera.
- Número de **teléfono o WhatsApp**.

Después de enviarlo, el huésped ve su aviso y su estado (*Recibido*, *En reparación*, *Resuelto*) en el mismo lugar.

## 3. Gestiona los avisos

Recibes una notificación push (**Settings → Notifications → A guest reported an issue**) y un email; los avisos urgentes van marcados como *URGENT*. Todos los avisos están en **Issues**, en el menú superior, con el número de avisos abiertos en la pestaña.

Abre un aviso para ver la descripción, las fotos, los datos de contacto (llamada o WhatsApp con un toque), el mejor momento y el permiso de entrada. Márcalo como **In progress** o **Resolved** y añade notas internas para tu equipo: el huésped nunca las ve. El aviso también aparece en la actividad de la reserva.

Las fotos de los huéspedes se guardan de forma privada con la reserva y solo las ven los usuarios de tu cuenta que han iniciado sesión.

## Para desarrolladores

Cada aviso nuevo dispara el evento de webhook `issue.reported` (consulta **Settings → Webhooks**). `GET /api/v1/issues` lista los avisos y `PATCH /api/v1/issues/{id}` cambia el estado o añade una nota.

## Preguntas frecuentes

### ¿Pueden los huéspedes avisar antes de la llegada?

No. El botón aparece en cuanto la guía de la estancia se desbloquea y desaparece un día después del check-out.

### ¿Lo necesito si ya uso una herramienta de formularios?

No, es opcional. La ventaja es que el aviso queda vinculado automáticamente a la reserva y a la propiedad, y el huésped ve el estado.