Saltar al contenido principal
Tu asistente reconoce a los huéspedes, responde preguntas sobre su estancia y comparte los datos del check-in desde tu cuenta de Hostaway. La conexión solo lee: en Hostaway no se crea, cambia ni cancela nada. Por ejemplo, a las 22 h llama un huésped: «Estoy frente a la puerta, ¿cuál es el código?». El asistente encuentra la reserva, comprueba que está confirmada y que la estancia empieza mañana o ya está en curso, y lee el código despacio.

Conectar tu cuenta

  1. En Hostaway, abre Settings → Hostaway API y elige Create. Pon el nombre que quieras y selecciona el socio Hostaway Public API. Hostaway muestra el Account ID y la API Key una sola vez: copia ambos antes de cerrar la ventana.
  2. Abre Agent Tools → Marketplace → Hostaway. Introduce el ID de la cuenta y la clave de API.
  3. Elige Agregar. La conexión se comprueba antes de guardarla, y la cuenta necesita al menos un alojamiento. Después asigna la conexión a tu asistente.
Las claves de Hostaway siempre dan acceso completo a la cuenta y no se pueden limitar a solo lectura. Esta conexión solo lee, pero mantén la clave en privado y revócala en Hostaway si se filtra.
Para cambiar la cuenta o la clave más adelante, elimina la herramienta y vuelve a conectarla.

Qué puede hacer el asistente

Activado por defecto:
  • Información del alojamiento: dirección, horarios de entrada y salida en hora local, normas de la casa, capacidad y servicios. El Wi-Fi, los códigos de la puerta y los datos de contacto del propietario no forman parte de ella.
  • Buscar reserva: encuentra la reserva en curso o próxima de un huésped con su apellido y su código de reserva (código de confirmación de Airbnb o Booking.com, código de otro canal o número de reserva de Hostaway).
  • Detalles de la reserva: estado, fechas, horarios de entrada y salida de la reserva propia de quien llama.
  • Compartir el Wi-Fi y Compartir los códigos de la puerta: consulta más abajo.
Opcional, elígelo en Editar:
  • Disponibilidad y precio: comprueba si un alojamiento está libre en unas fechas y da el precio. Es un presupuesto, no una reserva.
Las normas de la casa se leen a cualquier persona que llame. Guarda las contraseñas del Wi-Fi y los códigos de la caja de llaves en los campos de Wi-Fi y de código de la puerta de Hostaway, no en las normas.

Reconocer a quien llama

Antes del saludo, Famulor compara el número de quien llama con las estancias en curso o que empiezan en los próximos 30 días. Con una sola coincidencia, el asistente conoce el nombre, el alojamiento, las fechas, los horarios de entrada y el estado de la reserva como variables que empiezan por hostaway_, y puede saludar al huésped por su nombre. Consulta Variables. Si el número corresponde a varias estancias, lo comparten varios huéspedes o no está en Hostaway, el asistente pide el apellido y el código de reserva y usa Buscar reserva. Los números ocultos funcionan igual. Durante la conversación, Detalles de la reserva también encuentra la estancia por el número de quien llama.

Códigos de la puerta y Wi-Fi

El asistente comparte estos datos solo para reservas confirmadas, desde el día anterior a la llegada hasta el día de salida, en la zona horaria del alojamiento. Las consultas, las estancias del propietario y las reservas canceladas nunca los reciben. Un huésped que llama antes oye a partir de qué día están disponibles.
  • El Wi-Fi está disponible cuando el número de quien llama coincide exactamente con una estancia, o tras el apellido y el código de reserva.
  • El código de la puerta, la entrega de llaves y las instrucciones de llegada exigen además el apellido y el código de reserva. Tras tres intentos erróneos en una conversación, el asistente deja de comprobar. Cada comprobación fallida recibe la misma respuesta, así nadie averigua si existe una reserva.
Puedes desactivar cualquiera de los dos en Editar con las herramientas Compartir los códigos de la puerta y Compartir el Wi-Fi. Ambas están activadas por defecto.

Qué no cambia en Hostaway

No se crea, cambia ni cancela nada, y no se envía ningún mensaje a un huésped. El asistente lee reservas, alojamientos y precios.

Probar con seguridad

Crea en Hostaway una reserva de prueba y pídesela al asistente con el apellido y el código de reserva (Buscar reserva). Una conversación real lee códigos reales: usa un alojamiento de prueba o una reserva para la que esté permitido.

Canales

Por teléfono, el asistente trabaja con el número desde el que se le llama. En el chat web no hay número, así que pide el apellido y el código de reserva. WhatsApp y SMS reconocen a los huéspedes por su número de teléfono. En el correo se usa la dirección del remitente verificada.

Automatizaciones

Conecta Hostaway en Automatizaciones → Conexiones, o importa su conexión de Agent Tools. Cada herramienta está disponible como acción: Información del alojamiento, Buscar reserva, Detalles de la reserva, Compartir el Wi-Fi, Compartir los códigos de la puerta y Disponibilidad y precio. Una automatización iniciada por una llamada o una conversación de texto (SMS, WhatsApp) conoce el número de la otra persona por esa propia llamada. Las demás ejecuciones (webhook, programación) no tienen a nadie que llame: Detalles de la reserva y Compartir el Wi-Fi necesitan allí por eso una Referencia de la reserva de un paso Buscar reserva anterior.

API, MCP, CLI & SDK

POST /api/v1/tools/integrations/hostaway · MCP connect_integration · CLI famulor connect-integration hostaway. client.api.connectIntegration necesita famulor-sdk 0.2.12 o posterior. Actualiza la CLI con npm install --global famulor antes de usar connect-integration.

Límites

  • Hostaway limita las solicitudes por cuenta y por dirección IP. El límite se comparte con tus otras integraciones de Hostaway, así que mucha actividad en otro sitio puede ralentizar al asistente.
  • Las cuentas con más de 300 estancias en los próximos 30 días pueden no ser reconocidas antes del saludo. A partir de 500 estancias, el número de quien llama tampoco basta durante la conversación. El asistente pide entonces el apellido y el código de reserva.
  • Los precios están en la moneda del alojamiento.
  • Las claves y los tokens de Hostaway caducan a los 24 meses. Crea una clave nueva y vuelve a conectar la cuenta cuando la conexión deje de funcionar.
Documentación de la API de Hostaway