Saltar a la navegación
IntegracionesGuías de configuraciónProgramación

Hostaway

Comprueba si tus alquileres están disponibles en las fechas de quien llama, con precios por noche y estancias mínimas.

Con la herramienta de webhook de abajo, tu recepcionista puede consultar el calendario de un alojamiento de Hostaway para las fechas sobre las que pregunta quien llama e indicarle si la cabaña o unidad está disponible, el precio por noche y la estancia mínima. La API pública de Hostaway emite un token de acceso que dura 24 meses, así que la herramienta llama directamente a Hostaway.

Tu recepcionista no puede crear reservas ni consultar las existentes. Comprueba el calendario y recoge la solicitud de reserva, y tu equipo confirma la estancia desde el resumen posterior a la llamada.

Antes de empezar

1

Crea una clave de API

En el panel de Hostaway, abre Settings → Hostaway API y crea una nueva clave de API. Llámala Reception.ai y elige Hostaway Public API como partner. Copia la clave: Hostaway solo la muestra una vez. Anota tu Account ID, que también aparece en Settings.

2

Obtén un token de acceso

Intercambia la clave por un token de acceso en un terminal, sustituyendo ACCOUNT_ID y API_KEY:

curl -X POST 'https://api.hostaway.com/v1/accessTokens' \
  -H 'Content-type: application/x-www-form-urlencoded' \
  -d 'grant_type=client_credentials&client_id=ACCOUNT_ID&client_secret=API_KEY&scope=general'

Copia el valor de access_token de la respuesta. Es válido durante 24 meses.

El token de acceso puede leer y modificar todo lo que hay en tu cuenta de Hostaway, incluidos los datos de huéspedes y los códigos de puerta. No lo pegues en documentos compartidos ni herramientas online. Si se filtra, revócalo y elimina la clave de API en Hostaway.

3

Busca los ID de tus alojamientos

Enumera tus alojamientos con el token, sustituyendo YOUR_TOKEN:

curl 'https://api.hostaway.com/v1/listings?limit=100' \
  -H 'Authorization: Bearer YOUR_TOKEN'

Cada alojamiento de la respuesta tiene un id y un name. Anota el ID de cada alojamiento que deba consultar tu recepcionista.

Crea la herramienta

Ve a Integrations, selecciona Add integration y elige Webhook Tool.

CampoValor
Nombrecheck_hostaway_calendar
Descripción”Comprueba si uno de nuestros alquileres está disponible para las fechas de quien llama, así como el precio por noche y la estancia mínima. Úsala antes de decirle que un alquiler está disponible.”
MétodoGET
URLhttps://api.hostaway.com/v1/listings/{listing_id}/calendar
Encabezados de solicitudAuthorization: Bearer seguido de tu token de acceso, con Type establecido en Secret
Parámetros de rutalisting_id (cadena, obligatorio): “Usa 11111 para Cedar Cabin y 22222 para Lakeside Cabin.”
Parámetros de consultastartDate (cadena, obligatorio): “La fecha de llegada, como AAAA-MM-DD.”
endDate (cadena, obligatorio): “La última noche de la estancia, como AAAA-MM-DD.”
includeResources (cadena, valor fijo): 0
Asignar a agentesReceptionist

Sustituye los nombres e ID de las cabañas por los tuyos y añade una línea por alojamiento. Selecciona Enable.

Hostaway devuelve una entrada por noche. Una noche está disponible cuando status es available. Cada noche también tiene su price y minimumStay.

Mantén includeResources fijo en 0. Con 1, Hostaway añade las reservas de cada noche, incluidos los nombres, números de teléfono y correos electrónicos de huéspedes, a lo que ve tu recepcionista.

Pruébalo

Prueba tu recepcionista pidiendo una cabaña en fechas que sabes que están reservadas y después en fechas que sabes que están disponibles. Compara las respuestas con tu calendario de Hostaway.

Añade un procedimiento para solicitudes de estancia: pide el alojamiento, las fechas de llegada y salida y el número de huéspedes, consulta el calendario y luego solicita el nombre, número de teléfono y correo electrónico de quien llama para tu equipo. Añade una regla para que tu recepcionista nunca prometa que una estancia está reservada.

Limitaciones

  • Tu recepcionista no puede crear, modificar ni cancelar reservas. Tu equipo confirma cada estancia.
  • Consulta un alojamiento cada vez. Para sugerir otra cabaña, consulta cada una por turno.
  • Los precios por noche no incluyen gastos de limpieza, impuestos ni descuentos, así que tu recepcionista debe indicarlos solo como orientación.
  • La herramienta no consulta reservas existentes. Los registros de reservas y alojamientos de Hostaway incluyen códigos de puerta y contraseñas de Wi‑Fi, por lo que esta guía no los pone al alcance de tu recepcionista. La aplicación Hostaway de Zapier devuelve los mismos registros y no tiene acciones de reserva ni disponibilidad.
  • Tu token de acceso deja de funcionar después de 24 meses. Crea uno nuevo y actualiza el encabezado antes de entonces.

Solución de problemas

ProblemaQué comprobar
401 o 403 de HostawayEl valor del encabezado debe ser Bearer, un espacio y el token de acceso, no la clave de API. Comprueba que no haya caducado.
Se consulta la cabaña equivocadaComprueba que los ID de alojamiento de la descripción de listing_id coincidan con tus alojamientos.
Una noche reservada aparece como disponibleComprueba el calendario en Hostaway. Las noches bloqueadas y reservadas tienen un status distinto de available.
La recepcionista ofrece una estancia demasiado cortaIndícale en la descripción de la herramienta que compruebe minimumStay en la noche de llegada.