| Objetivo | Conectar los anuncios de Airbnb a Cloudbeds PMS mediante la API de Airbnb y configurar la integración. |
| Dirigido a | Titulares, gerentes generales y administradores de establecimientos responsables de la distribución. |
| Cuándo usar esta guía | Cuando configures una conexión completa mediante la API de Airbnb y necesites autorizar la conexión, mapear los anuncios y configurarlos. |
| Requisitos | Un anuncio de Airbnb activo y publicado; acceso a la cuenta del titular del anuncio, con una foto de perfil; y coincidencia en la configuración de las habitaciones, la moneda y la zona horaria del establecimiento. |
| Resultado esperado | La conexión con Airbnb queda autorizada, los anuncios están mapeados, la configuración de las habitaciones está completa y puedes verificar las tarifas y la disponibilidad. |
| Limitaciones | Los Precios inteligentes no son compatibles con la conexión; la Reserva inmediata se activa automáticamente; y algunos tipos de anuncios de Airbnb tienen limitaciones en la sincronización de la disponibilidad. |
Usa esta guía para conectar tus anuncios de Airbnb a Cloudbeds PMS mediante la API de Airbnb. Autorizarás la cuenta del titular del anuncio de Airbnb, mapearás los anuncios con las habitaciones, revisarás la configuración de las habitaciones y verificarás la conexión.
Si usas un Channel Manager de terceros y solo necesitas algunas herramientas de comunicación con los huéspedes, sigue las instrucciones para la conexión personalizada que se enlazan a continuación.
Antes de conectar la API de Airbnb
Antes de iniciar la conexión, revisa los siguientes requisitos y limitaciones para evitar problemas de sincronización.
Requisitos de conexión
- El estado de tu anuncio en Airbnb debe ser «Publicado». La sincronización no funcionará si el anuncio está inactivo o no está publicado.
- La configuración de las habitaciones, la configuración de la moneda y la zona horaria estándar del establecimiento deben coincidir en Cloudbeds PMS y Airbnb.
- Antes de iniciar el proceso estándar de conexión completa:
- Para una conexión completa mediante Cloudbeds PMS: Asegúrate de que Airbnb no esté conectado a otro Channel Manager. En Airbnb, ve a Cuenta > Privacidad y uso compartido > Aplicaciones conectadas y haz clic en Eliminar acceso si es necesario.
- Para una conexión personalizada mediante un Channel Manager de terceros: Si usas SiteMinder, iHotelier, SynXis u otro proveedor y solo necesitas herramientas específicas de Cloudbeds para comunicarte con los huéspedes, consulta Mensajería con huéspedes y reseñas de Airbnb y Expedia con Channel Managers de terceros.
- Vuelve a crear en Cloudbeds PMS los bloqueos de disponibilidad existentes en Airbnb antes de establecer la conexión. Los bloqueos manuales de Airbnb se eliminan al iniciar la conexión.
Limitaciones importantes
- Los Precios inteligentes no son compatibles con la conexión mediante la API.
- La Reserva inmediata se activa automáticamente después de establecer la conexión.
- Airbnb no puede actualizar la disponibilidad de los siguientes tipos de anuncios: automóvil (car), condohotel (condohotel), dormitorio compartido (dorm), unidad independiente anexa (in_law), otro (other), espacio de estacionamiento (parkingspace), posada (pousada), tiempo compartido (timeshare), casa de vacaciones (vacation_home) y casa rodante (van house). Cloudbeds PMS puede recibir reservas, pero la funcionalidad es limitada.
Recursos adicionales
- Consulta la Guía de inicio de Airbnb para obtener ayuda con los primeros pasos.
- Revisa las Preguntas frecuentes sobre la API de Airbnb para obtener más información sobre la conexión.
Conecta la API de Airbnb a Cloudbeds PMS
Sigue los cuatro pasos que se indican a continuación para autorizar tu cuenta de Airbnb, mapear tus anuncios, configurar las habitaciones y revisar los ajustes de la tarifa base.
Empieza por activar el canal Airbnb API en Cloudbeds PMS y autorizar el acceso a tu cuenta de titular del anuncio de Airbnb.
Antes de autorizar tu cuenta
- Inicia sesión como titular del anuncio de Airbnb. Los coanfitriones y los equipos de anfitriones no pueden conectar el canal.
- La cuenta del anfitrión principal debe tener una foto de perfil antes de autorizar a un proveedor de conectividad.
- Si no sabes con certeza quién es el anfitrión principal, consulta ¿Qué es un anfitrión principal?
- Ve a Cuenta
> Configuración
> Distribución
.
- Abre la pestaña Descubrir, busca Airbnb API y selecciona la tarjeta del canal.
- Haz clic en Activar canal.
- En Tipo de conexión, selecciona el tipo de conexión que prefieras.
¿No sabes qué conexión elegir?
Seleccionar el tipo de conexión correcto ayuda a garantizar que los datos de los huéspedes se transfieran según tus necesidades. Consulta Mensajería con huéspedes y reseñas con Channel Managers de terceros para obtener orientación.
-
Lee la guía de configuración, desactiva los bloqueadores de ventanas emergentes del navegador y haz clic en AUTORIZAR.
Si tienes varias cuentas de Airbnb, te recomendamos abrir Airbnb.com en otra pestaña del navegador y cerrar sesión antes de iniciar la autorización.
Autoriza a Cloudbeds para gestionar tus anuncios de Airbnb
- Inicia sesión con las credenciales del titular del anuncio de Airbnb, no con una cuenta de coanfitrión.
Aparecerá una ventana emergente titulada Autoriza tu cuenta de Airbnb (API). Asegúrate de que tu navegador permita las ventanas emergentes.
Si se producen errores de autorización, cierra sesión en todas las cuentas de Airbnb de tus navegadores e inténtalo de nuevo.
- Acepta los Términos y condiciones de Airbnb.
- Haz clic en Permitir para autorizar a Cloudbeds PMS.
Debería aparecer un mensaje de confirmación cuando la autorización se complete correctamente.
Confirma la conexión
Después de autorizar la cuenta, la interfaz de Cloudbeds PMS se actualiza:
- El estado del canal cambia a Listo para el mapeado.
- Tu ID de usuario único (ID del hotel en Airbnb) aparece en la sección Inicio de sesión del canal.
Para cambiar la cuenta de Airbnb vinculada a Cloudbeds o actualizar tus credenciales, haz clic en Volver a autorizar. Se abrirá la ventana de autorización para que puedas iniciar sesión con otra cuenta de Airbnb.
Después de la autorización, mapea tus habitaciones o tipos de habitación de Cloudbeds con los anuncios correspondientes de Airbnb.
- Mapea los tipos de habitación de Cloudbeds PMS con los anuncios correspondientes de Airbnb.
Usa únicamente un mapeado uno a uno. No mapees un tipo de habitación con varios anuncios ni viceversa.
Los requisitos de mapeado dependen de tu configuración de Airbnb. Sigue las instrucciones que correspondan a tu configuración:
- Si gestionas varios establecimientos con un solo inicio de sesión de Cloudbeds, es posible que veas una advertencia. Puedes ignorar esta advertencia y continuar.
- Si usas una cuenta de Airbnb para varios establecimientos de Cloudbeds PMS, puedes conectarlos siempre que mapees cada establecimiento con los anuncios que le correspondan, para evitar problemas de sincronización.
Si se produce un error de mapeado, consulta Solución de problemas de la API de Airbnb. Si el problema persiste, contacta al equipo de Soporte de Cloudbeds.
Después de mapear tus anuncios, Cloudbeds PMS te lleva a Configuración de habitaciones, donde puedes revisar y configurar los precios, los impuestos, los descuentos y otros ajustes de los anuncios.
Para obtener información detallada sobre cada campo disponible, consulta API de Airbnb: Configuración de habitaciones.
- Haz clic en Configurar junto a cada habitación.
- Revisa las opciones disponibles de Precio, impuestos, reglas de precios y descuentos. Haz clic en Ver/Editar.
- Revisa la Configuración de precios.
Si usas las Tarifas avanzadas en canales, puedes seleccionar qué plan de tarifas de Cloudbeds se utiliza para la tarifa estándar de Airbnb.
- Revisa la configuración de Impuestos.
- Revisa las Reglas de precios y descuentos disponibles.
Promoción para anuncios nuevos
Si tu anuncio de Airbnb cumple los requisitos y tiene menos de 3 reservas confirmadas, puedes activar la Promoción para anuncios nuevos para aplicar automáticamente un descuento del 20 % a las primeras 3 reservas.
Cómo funciona la Promoción para anuncios nuevos
- La promoción busca aumentar la visibilidad de los anuncios nuevos y se sincroniza directamente con Airbnb.
- El descuento se elimina automáticamente después de la tercera reserva o a los 30 días del lanzamiento, lo que ocurra primero.
Descuentos para huéspedes con buenas calificaciones y para reservas desde la aplicación móvil
En Reglas de precios y descuentos, pueden aparecer dos descuentos adicionales de Airbnb debajo de Promoción para anuncios nuevos. Puedes activar o desactivar cada descuento de forma independiente para cada tipo de habitación de Airbnb.
- Descuento para huéspedes con buenas calificaciones: Ofrece un descuento del 15 % a los huéspedes de Airbnb con una calificación de 4,8 o superior y al menos 3 reseñas.
- Descuento exclusivo para reservas desde la aplicación móvil: Ofrece un descuento del 10 % para las reservas realizadas mediante la aplicación móvil de Airbnb.
Para configurar estos descuentos, activa o desactiva el interruptor correspondiente para cada tipo de habitación y guarda la Configuración de habitaciones. Tus selecciones se envían a Airbnb junto con los demás ajustes de las habitaciones. Puedes activar uno de los descuentos, ambos o ninguno.
Información importante sobre los descuentos de Airbnb
- Airbnb determina los porcentajes de descuento. No se pueden personalizar en Cloudbeds PMS.
- Las fechas excluidas de los descuentos y la cantidad de fechas excluidas utilizadas o disponibles no se muestran ni se pueden editar en Cloudbeds PMS. Las fechas excluidas que ya hayas configurado en Airbnb se conservan al guardar la Configuración de habitaciones.
- Airbnb valida los requisitos del anuncio al guardar la configuración. Por ejemplo, un anuncio sin fotos puede generar el error «Tu anuncio necesita fotos antes de poder activarlo». Resuelve el problema del anuncio antes de volver a guardar.
Configuración adicional
También puedes configurar las Tareas de check-out para seleccionar las tareas que los huéspedes deben completar antes de hacer el check-out.
Cuando la configuración de las habitaciones se completa correctamente, la página Mapeado de habitaciones muestra Configuración completada.
Si es necesario, configura un ajuste de la tarifa base para modificar las tarifas enviadas a Airbnb mediante un porcentaje o un importe fijo.
Para obtener más información sobre cómo funcionan los ajustes, consulta Ajuste de la tarifa base o cómo enviar tarifas diferentes a los canales.
Una vez completado este paso, el mapeado de tus anuncios habrá finalizado. Puedes volver a la página de mapeado en cualquier momento para actualizar el mapeado de habitaciones, la configuración de habitaciones o los ajustes de la tarifa base.
En la página Configuración de habitaciones, verifica que tus anuncios estén mapeados correctamente y que no queden errores ni ajustes pendientes.
Después de conectar: Verifica y gestiona la integración
Una vez que hayas completado la conexión mediante la API de Airbnb, verifica que tus anuncios reciban las tarifas, la disponibilidad y la configuración correctas. Completa las siguientes comprobaciones antes de empezar a usar la integración para recibir nuevas reservas.
- Verifica las tarifas y la disponibilidad. Abre el calendario de tu anuncio de Airbnb y simula una reserva como huésped para confirmar que las tarifas y la disponibilidad sean las esperadas.
- Revisa los impuestos, las tasas y las comisiones. Si corresponde, añade impuestos, tasas o comisiones a Fuente de la reserva: Airbnb API en Cloudbeds PMS.
- Desactiva la conexión anterior de Airbnb mediante iCal. Si antes usabas iCal, sigue las instrucciones para desactivar Airbnb iCal y evitar actualizaciones contradictorias.
- Vuelve a importar las reservas anteriores de iCal. Vuelve a importar todas las reservas que antes estaban conectadas mediante iCal.
- Gestiona las tarifas, la disponibilidad y las restricciones en Cloudbeds PMS. Después de establecer la conexión, los anfitriones no pueden editar estos campos directamente en Airbnb, ya que Cloudbeds PMS los gestiona.
- Evita los cambios desde cuentas de coanfitriones. Es posible que los coanfitriones sigan viendo campos editables en Airbnb, pero no deben modificarlos. Las modificaciones directas pueden causar discrepancias en las tarifas o la disponibilidad y generar overbookings.
- Activa la mensajería de Airbnb si corresponde. Si usas Cloudbeds Guest Experience, sigue las instrucciones de Mensajería de Cloudbeds Guest Experience: Todo lo que debes saber para configurar la mensajería de Airbnb.
Actualización de privacidad de los números de teléfono de los huéspedes de Airbnb (octubre de 2026)
A partir de la semana del 26 de octubre de 2026, Airbnb limita los números de teléfono de los huéspedes que comparte mediante las reservas de la API, para proteger la información personal y reducir los riesgos de phishing.
- Números de teléfono temporales: Airbnb proporciona un número temporal para las reservas aceptadas a partir del 26 de octubre de 2026 cuando el anuncio está en Estados Unidos o Canadá, tanto el anfitrión como el huésped tienen números de teléfono y ambos residen en el mismo país.
- Sin número de teléfono: Para todas las demás reservas, incluidas las aceptadas antes del 26 de octubre de 2026, Airbnb no proporciona el número de teléfono del huésped ni un número temporal mediante la API.
Si el número de teléfono de un huésped no está disponible en Cloudbeds PMS, usa las herramientas de mensajería disponibles de Airbnb para comunicarte con él. Para obtener más información, consulta Cómo funcionan los números de teléfono temporales - Centro de asistencia de Airbnb.
Después de completar estas comprobaciones, tu conexión mediante la API de Airbnb estará lista para el uso habitual. Sigue gestionando las tarifas, la disponibilidad y las restricciones compatibles con la integración en Cloudbeds PMS para mantener tus anuncios sincronizados.
Siguiente paso operativo
Para entender cómo funciona la conexión después de configurarla, incluido el comportamiento de la sincronización y las dudas habituales, revisa las Preguntas frecuentes sobre la API de Airbnb.
Comentarios
El artículo está cerrado para comentarios.