Connect Hostfully to Houfy - Complete Integration Guide

Esta guía cubre cómo conectar, qué se importa y cómo funciona la sincronización continua.

Lo que obtienes al conectar

• Todos tus anuncios activos de Hostfully importados a Houfy como anuncios que posees y controlas completamente

• Contenido del anuncio (descripciones, fotos, comodidades, dormitorios, tarifas, descuentos) poblado desde Hostfully

• Precios y disponibilidad sincronizados durante los próximos 60 días en todo momento

• Reservas de Hostfully importadas y mantenidas en sincronización a través de webhooks

• Interruptores de un clic para si los nuevos anuncios de Hostfully se importan automáticamente en el futuro

• No hay reservas dobles. Houfy bloquea las mismas fechas que Hostfully ha reservado (y viceversa)

Cómo conectar

1. Inicia sesión en tu cuenta de Houfy.

2. Ve a https://www.houfy.com/p/hostfully

3. Haz clic en Conectar con Hostfully. Serás redirigido a la página de autorización de Hostfully.

4. Inicia sesión en Hostfully (si no lo has hecho ya) y aprueba el acceso de Houfy a tu cuenta.

5. Hostfully te redirige de vuelta a Houfy.

6. Llegarás a la página de anuncios de Houfy. Los anuncios activos de Hostfully aparecerán aquí en un minuto o dos a medida que se realice la importación inicial.

Si alguna vez necesitas desconectar, puedes hacerlo desde tu página de socios de software: https://www.houfy.com/channel-managers

Qué se sincroniza en Houfy

Cuando un anuncio es importado (conexión inicial o sincronización posterior), Houfy extrae y guarda lo siguiente de Hostfully:

Contenido del anuncio

- Nombre de la propiedad, resumen y descripción completa

- Tipo de casa (apartamento, villa, condominio, cabaña, etc.) mapeado a la lista de categorías de Houfy

- Fotos. URLs originales importadas, luego re-alojadas en el CDN de Houfy para cargas de página más rápidas (manejado de forma asíncrona)

- Comodidades. Las comodidades de Hostfully mapeadas a la taxonomía de comodidades de Houfy

- Dormitorios. Número de dormitorios, tipos de cama por habitación, cantidad de baños

- Descripciones de la propiedad. Notas del vecindario, el espacio, cómo moverse, interacción con los huéspedes, reglas de la casa

- Horarios de check-in y check-out, incluyendo cualquier instrucción de check-in personalizada

Ubicación

- Calle, ciudad, estado, país, código postal

- Latitud y longitud geocodificadas

Precios y tarifas

- Tarifa base por noche (configuración de precios por propiedad)

- Multiplicadores de tarifas. Tarifas diarias de Hostfully, precios de fin de semana, ajustes estacionales

- Moneda

Tarifas y descuentos

- Tarifa de limpieza

- Tarifas por huésped adicional y tarifas por persona extra

- Tarifas por mascotas (si están configuradas en Hostfully)

- Descuentos por duración de la estancia (semanal, mensual)

- Descuentos de última hora y por reserva anticipada (si están configurados en Hostfully)

Disponibilidad

- Sincronizado para los próximos 60 días en cada actualización

- Fechas reservadas de las reservas de Hostfully

- Bloqueos de propietarios y reservas de mantenimiento

Reservas

- Todas las reservas actuales y futuras de Hostfully importadas

- Cada reserva enlaza de vuelta a su ID de reserva de Hostfully

Cómo funciona la sincronización continua

Después de la importación inicial, Houfy mantiene todo actualizado de dos maneras:

1. Sincronización completa programada (se ejecuta en un horario regular)

Houfy vuelve a sincronizar automáticamente cada anuncio conectado en un horario recurrente. Cada ejecución:

- Actualiza el contenido del anuncio (en caso de que hayas actualizado fotos, descripciones, etc., en Hostfully)

- Extrae las tarifas y disponibilidad de los próximos 60 días

- Importa cualquier nueva reserva

- Vuelve a ejecutar el proceso de importación de fotos para los anuncios cuyas fotos han cambiado

Esto se ejecuta en segundo plano. No se necesita ninguna acción de tu parte, siempre que tus anuncios se hayan importado correctamente la primera vez. Si ninguno apareció, consulta Si tus anuncios no aparecen a continuación. Si realizas un cambio en Hostfully, se reflejará en Houfy en la próxima sincronización programada como máximo, y a menudo antes a través de webhooks (ver más abajo).

2. Webhooks en tiempo real

Cuando algo cambia en Hostfully, como una nueva reserva que llega, un huésped que cancela o un precio que se actualiza, Hostfully envía un webhook a Houfy. Houfy pone el evento en cola y lo procesa en segundos:

- Nuevas reservas se importan a Houfy

- Actualizaciones de reservas (cambios de fecha, número de huéspedes, estado) se reflejan en Houfy

- Las cancelaciones liberan el calendario de Houfy

- Las ediciones de anuncios desencadenan una nueva sincronización de ese anuncio

Los webhooks aseguran que las reservas del mismo día aparezcan en Houfy sin esperar a la próxima sincronización programada.

Si tus anuncios no aparecen

La primera ejecución puede regresar vacía. La razón más común es que la cuenta de Hostfully utilizada para autorizar la conexión no tiene acceso a la propiedad. Nada vuelve a intentar esto por sí solo; la sincronización programada solo actualiza anuncios que ya han llegado al menos una vez, así que si ninguno lo hizo, no hay nada que actualizar.

Para ejecutarlo de nuevo tú mismo, ve a https://www.houfy.com/channel-managers?channel=hostfully&step=2 y haz clic en Extraer Nuevos Anuncios.

Si ves un mensaje que dice que no se devolvieron propiedades para la cuenta, vuelve a conectar desde https://www.houfy.com/p/hostfully e inicia sesión en Hostfully como un propietario o usuario administrador que tenga acceso a la propiedad.

Opción de sincronización manual

Si deseas forzar una actualización ahora mismo en lugar de esperar a la próxima ejecución programada:

1. Ve a tu página de anuncios de Houfy.

2. Encuentra el anuncio importado de Hostfully que deseas actualizar.

3. Haz clic en el anuncio y selecciona Re-sincronizar desde Hostfully (en las acciones del anuncio).

Esto vuelve a ejecutar la misma lógica de importación que utiliza el trabajo programado, solo para un anuncio a demanda. Útil justo después de realizar un gran cambio en Hostfully y no querer esperar.

Preguntas frecuentes

¿Conectar Hostfully sobrescribirá los anuncios que ya creé en Houfy?

No. Los anuncios de Hostfully se importan como nuevos anuncios de Houfy. Tus anuncios existentes en Houfy permanecen intactos. Puedes elegir la opción “Mapear Anuncios Existentes” si deseas asignarlos a tus anuncios existentes.

¿Qué sucede si desconecto Hostfully más tarde?

Sus anuncios importados permanecen en Houfy. Simplemente dejan de recibir actualizaciones de Hostfully. Los precios, la disponibilidad y las nuevas reservas ya no fluyen.

¿Puedo editar un anuncio importado de Hostfully directamente en Houfy?

Puedes, pero cualquier campo que pertenezca a Hostfully se sobrescribirá en la próxima sincronización. Mejor práctica: edita el contenido del anuncio en Hostfully, edita los campos exclusivos de Houfy (como el texto de marketing específico de Houfy, descripciones sociales) en Houfy.

¿Cómo sé cuándo se realizó la última sincronización?

El estado de conexión en la página de Hostfully en Houfy muestra la marca de tiempo de la última sincronización por anuncio.

¿Qué pasa si una sincronización falla?

Houfy reintenta automáticamente. Las fallas persistentes (como un token revocado) activan una alerta por correo electrónico a la dirección asociada con tu cuenta de Houfy, instándote a reconectar.

¿Puedo sincronizar solo algunos de mis anuncios de Hostfully?

Sí. Durante la configuración puedes elegir qué anuncios importar, y puedes activar o desactivar anuncios individuales en cualquier momento.