Consultas y reseñas
Cómo llegan al equipo anfitrión la pregunta y la reseña de un huésped, cómo las trabaja el equipo en el panel y los límites que mantienen limpios los formularios.
Para el paquete Full Stack
Cómo llegan al anfitrión
| En el sitio web | En el panel |
|---|---|
| El formulario de contacto | Una consulta, con el nombre, el correo electrónico, el teléfono opcional y el mensaje del huésped |
| El diálogo de preguntas de la página de un alojamiento | Una consulta sobre ese alojamiento, con las fechas y el número de huéspedes por los que se preguntó |
| Una reseña de una reserva completada | Una reseña, publicada de inmediato en la página del alojamiento |
- Cada una avisa en directo a todos los administradores que pueden ver consultas o reseñas, y aterriza en la página Consultas o Reseñas del panel.
- El huésped ve una confirmación en la página en la que está. El mensaje de una pregunta va de 10 a 4000 caracteres y el comentario de una reseña de 10 a 2000, y el sitio web comprueba ambos antes de enviar, con los mismos límites que aplica la API.
- No se envía nada por correo electrónico, ni al huésped ni al anfitrión: la plantilla no tiene servicio de correo. El equipo responde desde su propio buzón, y un desarrollador puede añadir un remitente junto a la notificación.
Consultas
| Estado | Significado |
|---|---|
| Nueva | Recién recibida. Cada consulta empieza aquí. |
| Respondida | El equipo ha respondido. |
| Cerrada | Terminada, sea cual sea el resultado. |
- La página Consultas filtra por estado con los recuentos, y busca por referencia (
I001y así sucesivamente), nombre, correo electrónico o alojamiento, veinte por página, junto a la consulta seleccionada: su alojamiento, las fechas y los huéspedes por los que se preguntó, los datos del huésped y lo que escribió. - El panel de detalle cambia el estado y guarda una nota interna, que el huésped nunca ve.
- Las consultas no se pueden eliminar: cierra las que ya hayas terminado.
Reseñas
- Un huésped reseña un alojamiento desde la página de su propia reserva una vez completada la reserva, una vez por reserva, con una valoración de 1 a 5 en medias estrellas y un comentario de 10 a 2000 caracteres.
- Una reseña se publica en la página del alojamiento en cuanto se escribe, y la media del alojamiento la sigue.
- La página Reseñas las lista de ocho en ocho, con los recuentos de reseñas publicadas y ocultas, una búsqueda por huésped o comentario, y filtros por estado, alojamiento, la valoración más baja y lo recientes que son (7, 30, 90 o 365 días). Publicar y Ocultar cambian al instante la media pública del alojamiento.
- Las reseñas no se pueden eliminar: oculta las que no deban mostrarse.
Mantener limpios los formularios
- Cada dirección puede enviar cinco preguntas y cinco reseñas en diez minutos; la siguiente se rechaza con un mensaje que pide esperar. Los recuentos viven en la memoria de la API.
- Un campo oculto atrapa a los bots: una pregunta que lo rellena recibe la respuesta habitual y no se guarda en ningún sitio.
- Cada pregunta lleva un token de un solo uso, así que un doble clic o un reenvío guarda una consulta, no dos.
- Detrás de un proxy inverso, define
TRUST_PROXY=1en el.envde la API, o cada visitante comparte la cuota del proxy.
Quién puede hacer qué
| Permiso | Permite |
|---|---|
inquiries.view | Leer las consultas y recibir avisos de las nuevas |
inquiries.edit | Cambiar el estado y la nota de una consulta |
reviews.view | Leer reseñas y recibir avisos de las nuevas |
reviews.moderate | Publicar y ocultar reseñas |
Los dos roles de la carga inicial, Super Admin y Manager, tienen los cuatro.
Las rutas que hay detrás
POST /api/inquiries es público: name, email, message (de 10 a 4000 caracteres) y client_token, y opcionalmente phone, stay_slug, check_in, check_out y guests. Una reseña es POST /api/bookings/:reference/review con el token o el correo electrónico de la reserva, rating y comment, y las reseñas publicadas de un alojamiento son GET /api/stays/:slug/reviews. El panel lee y actualiza las consultas con GET y PATCH /api/inquiries/:id (status, admin_notes), y las reseñas con GET /api/reviews/manage y PATCH /api/reviews/manage/:id (status: published o hidden).