> This is a page from the ElevenLabs documentation. For an index of the documentation, fetch https://elevenlabs.io/docs/llms.txt. # Hostaway Con la [herramienta de webhook](/docs/es/reception-ai/integrations/webhooks) 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. > **Note** > > 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](/docs/es/reception-ai/features/notifications). ## Antes de empezar ### 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**. ### Obtén un token de acceso Intercambia la clave por un token de acceso en un terminal, sustituyendo `ACCOUNT_ID` y `API_KEY`: ```bash 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. > **Warning** > > 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. ### Busca los ID de tus alojamientos Enumera tus alojamientos con el token, sustituyendo `YOUR_TOKEN`: ```bash 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**. | Campo | Valor | | ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Nombre** | `check_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étodo** | GET | | **URL** | `https://api.hostaway.com/v1/listings/{listing_id}/calendar` | | **Encabezados de solicitud** | `Authorization`: `Bearer ` seguido de tu token de acceso, con **Type** establecido en **Secret** | | **Parámetros de ruta** | `listing_id` (cadena, obligatorio): "Usa `11111` para Cedar Cabin y `22222` para Lakeside Cabin." | | **Parámetros de consulta** | `startDate` (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 agentes** | **Receptionist** | 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`. > **Warning** > > 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](/docs/es/reception-ai/receptionist/testing) 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. > **Tip** > > Añade un [procedimiento](/docs/es/reception-ai/receptionist/rules-and-procedures) 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 | Problema | Qué comprobar | | ---------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- | | 401 o 403 de Hostaway | El 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 equivocada | Comprueba que los ID de alojamiento de la descripción de `listing_id` coincidan con tus alojamientos. | | Una noche reservada aparece como disponible | Comprueba el calendario en Hostaway. Las noches bloqueadas y reservadas tienen un `status` distinto de `available`. | | La recepcionista ofrece una estancia demasiado corta | Indícale en la descripción de la herramienta que compruebe `minimumStay` en la noche de llegada. |