Conecta Smoobu a Famulor: crea un agente de reservas por voz con IA

Cualquiera que gestione alquileres vacacionales a través de Smoobu conoce la rutina: las llamadas llegan a todas horas, ya sean solicitudes de disponibilidad, reservas de última hora o preguntas sobre el estado de las reservas existentes. Un agente de voz con IA que se comunique directamente con la API de Smoobu cierra esa brecha. Comprueba la disponibilidad en tiempo real, crea reservas, responde preguntas sobre estancias confirmadas y envía mensajes a los huéspedes bajo demanda, todo en una misma llamada y sin necesidad de que haya nadie al otro lado del teléfono.

Esta guía muestra cómo poner en marcha un agente de voz para Smoobu en menos de una hora utilizando la plataforma de IA de voz sin código de Famulor. Aprenderás qué endpoints de Smoobu son importantes, cómo configurar las herramientas durante la llamada en el panel de control de Famulor y cómo instruir al agente en el prompt del sistema para que utilice dichas herramientas en el momento preciso. El mismo agente funcionará después tanto en llamadas telefónicas como en chat web y WhatsApp con la misma configuración.

Qué es Smoobu y por qué es el ancla perfecta para una IA de voz

Smoobu es un sistema de gestión de propiedades con sede en Berlín para alquileres de corta estancia, hoteles boutique y apartamentos turísticos. Sincroniza las reservas de Airbnb, Booking.com, Vrbo y tu propia página web de reservas directas en un calendario unificado. Lo que hace que Smoobu sea especialmente atractivo para la IA de voz es su API REST totalmente documentada con autenticación mediante OAuth y clave API, un límite de 1.000 solicitudes por minuto y endpoints que se ajustan perfectamente a las preguntas que los clientes hacen realmente por teléfono.

Las intenciones típicas de los clientes que un agente de voz puede resolver a través de la API de Smoobu son: comprobar la disponibilidad para un rango de fechas, obtener un precio, crear una reserva, consultar el estado de una reserva existente o enviar un mensaje al huésped. Cada una de estas acciones se corresponde con un endpoint documentado de Smoobu, exactamente el caso de uso para el que se diseñó la arquitectura de herramientas durante la llamada de Famulor.

Cómo funcionan las herramientas durante la llamada en Famulor

Famulor distingue entre conocimiento estático (PDF, URL, FAQ) y herramientas dinámicas durante la llamada. Estas herramientas son llamadas HTTP que el agente de IA ejecuta en tiempo real durante la conversación. El agente extrae los parámetros que necesita de la llamada, accede al endpoint configurado, espera la respuesta JSON y responde al cliente utilizando los datos en vivo.

Concretamente, una herramienta durante la llamada se crea a través de la API en POST /api/user/tools o, lo que es más habitual, directamente en el panel de control de Famulor en Mid Call Tools. Para cada herramienta, defines:

• nombre: identificador en snake_case (por ejemplo, check_smoobu_availability) al que el agente hace referencia internamente.

• descripción: hasta 255 caracteres que describen cuándo debe usar el modelo esta herramienta (por ejemplo, "cuando el cliente pregunta por la disponibilidad para un rango de fechas").

• endpoint: URL de Smoobu como https://login.smoobu.com/booking/checkApartmentAvailability.

• método: GET, POST, PUT, PATCH o DELETE.

• cabeceras: aquí es donde residen Api-Key: YOUR_KEY y Content-Type: application/json.

• esquema: matriz de parámetros que la IA extrae de la conversación. Cada elemento tiene un nombre, un tipo (string/number/boolean) y una descripción que ayuda al modelo a identificar el valor.

• tiempo de espera: de 1 a 30 segundos, el valor predeterminado es 10; 8 segundos es una opción cómoda para Smoobu.

Las descripciones del esquema no son un adorno. Son la única señal que utiliza el modelo para traducir una frase del cliente como "del 14 al 17 de mayo para cuatro personas" en campos estructurados. Escríbelas con precisión.

Las cinco herramientas durante la llamada que necesita tu agente de voz para Smoobu

En la práctica, cinco herramientas cubren el 90 por ciento de las intenciones de los clientes. La siguiente tabla las resume:

Complementos opcionales: cancel_smoobu_reservation para cancelaciones y get_smoobu_rates para consultar precios de temporada. Siguen el mismo patrón de esquema.

Paso 1: obtén la clave API de Smoobu

Inicia sesión en Smoobu y ve a Ajustes → API. Genera una clave API personal; esta clave está vinculada a tu cuenta. Los escenarios multiinquilino utilizan OAuth 2 como socio de Smoobu; para un anfitrión individual, la clave personal es suficiente. Anota también los ID de tus apartamentos desde el panel de Smoobu, ya que el endpoint de disponibilidad los espera como una matriz.

Smoobu permite 1.000 solicitudes por minuto, mucho más de lo que utilizará incluso un agente de voz muy activo. Vigila las cabeceras X-RateLimit-* devueltas si también ejecutas campañas salientes paralelas con la misma clave.

Paso 2: crea tu primera herramienta "check_smoobu_availability"

En el panel de control de Famulor, abre Mid Call Tools y haz clic en "New Tool". Rellena:

• Nombre: check_smoobu_availability

• Descripción: "Comprueba la disponibilidad en Smoobu para las fechas y apartamentos solicitados. Solo llamar después de que el cliente haya indicado la fecha de llegada, la fecha de salida y el número de huéspedes."

• Endpoint: https://login.smoobu.com/booking/checkApartmentAvailability

• Método: POST

• Cabeceras: Api-Key: YOUR_SMOOBU_KEY, Content-Type: application/json

• Esquema:

  • arrival_date (string) - "Fecha de llegada en formato aaaa-mm-dd, extraída de la voz del cliente"

  • departure_date (string) - "Fecha de salida en formato aaaa-mm-dd"

  • guests (number) - "Número de personas que se alojan"

Guarda y listo. Durante la llamada, el modelo ensambla la carga útil JSON a partir de los valores proporcionados por el cliente. Famulor asigna los nombres del esquema a los campos exactos de Smoobu (arrivalDate, departureDate, guests); también puedes usar los nombres en camelCase de Smoobu directamente en la definición de tu herramienta.

Paso 3: añade las herramientas de reserva y consulta

La herramienta más importante es create_smoobu_booking. Smoobu requiere campos como arrivalDate, departureDate, apartmentId y channelId, además de datos de contacto para cualquier reserva seria. Asegúrate de que la descripción indique explícitamente al modelo que llame a esta herramienta solo después de que se hayan confirmado todos los campos obligatorios; de lo contrario, el modelo tiende a actuar con optimismo.

Ejemplo de descripción: "Crea una reserva en Smoobu. Solo llamar después de que check_smoobu_availability haya tenido éxito Y el cliente haya proporcionado nombre, apellidos, correo electrónico, teléfono y el ID del apartamento elegido. Repite los datos al cliente y obtén una confirmación explícita antes de invocarla."

La segunda herramienta imprescindible es get_smoobu_booking para preguntas sobre reservas existentes. Cuando un cliente dice "Ya he reservado pero no encuentro mi número de reserva", el agente puede realizar una búsqueda por correo electrónico o por código de reserva y responder con los datos en tiempo real.

Paso 4: escribe un prompt del sistema que active la herramienta correcta

Aquí es donde la mayoría de los equipos fallan. El prompt del sistema debe indicar al modelo con precisión cuándo se dispara una herramienta; de lo contrario, el modelo decide por instinto y llama demasiado pronto, demasiado tarde o nunca. Una estructura fiable:

1. Identidad y tono. "Eres Hannah, asistente virtual de Black Forest Holiday Apartments. Habla de forma breve, amable y en un español sencillo."

2. Reglas de dominio. ¿Qué apartamentos? ¿Qué reglas estacionales? ¿Qué contexto de preguntas frecuentes hay en la base de conocimientos?

3. Reglas de uso de herramientas. Explica cada una:

   • "Cuando el cliente pregunte por disponibilidad o precio, llama a check_smoobu_availability tan pronto como se conozcan la llegada, la salida y el número de huéspedes."

   • "Cuando el cliente quiera reservar en firme, reúne todos los campos obligatorios (nombre, apellidos, correo, teléfono, apartamento objetivo), repítelos, obtén una confirmación explícita y luego llama a create_smoobu_booking."

   • "Cuando el cliente mencione una reserva existente y proporcione un ID, llama a get_smoobu_booking y lee los campos relevantes."

   • "Cuando el cliente quiera confirmación por correo o WhatsApp, tras una reserva exitosa llama a send_smoobu_message."

4. Reglas de escalada. Cuándo pasar la llamada a un humano: normalmente para quejas, solicitudes especiales o cualquier petición explícita de hablar con alguien.

Esta guía explícita sobre las herramientas es la diferencia entre un agente que reserva de forma fiable y uno que alucina. Utiliza las mismas frases de activación por herramienta para que el modelo reconozca el patrón de forma consistente.

Paso 5: multicanal: teléfono, chat web, WhatsApp

Uno de los puntos fuertes de Famulor: el mismo agente con las mismas herramientas durante la llamada funciona en todos los canales. Un cliente que no puede localizarte por teléfono envía un WhatsApp; el agente responde con la misma lógica y reserva en el mismo calendario de Smoobu. El widget de chat web en tu sitio de reservas directas utiliza las mismas herramientas, convirtiendo cada visita a la página en una reserva real en lugar de un laberinto de formularios de contacto.

Puedes ajustar el comportamiento por canal: respuestas más cortas por teléfono, respuestas ricas en listas en el chat, enlaces de confirmación en WhatsApp. Famulor gestiona la lógica de enrutamiento; tú solo ajustas el tono por canal, la integración con Smoobu permanece idéntica. Para obtener información sobre la arquitectura multicanal, consulta el artículo sobre el constructor de flujos omnicanal.

Ejemplo: llamada de 90 segundos, una reserva confirmada

Así es como se ve una llamada real en un alquiler vacacional rural típico:

Cliente: Hola, ¿tienen algo del 22 al 25 de mayo para dos adultos y un niño?
Agente: Un momento, déjeme comprobarlo. (llama a check_smoobu_availability con llegada 2026-05-22, salida 2026-05-25, huéspedes 3)
Agente: Tengo dos apartamentos disponibles: Studio Talblick por 348 euros y Bergwiese por 420 euros, ambos con limpieza final incluida.
Cliente: Nos quedaremos con el estudio.
Agente: Perfecto. ¿Podría darme su nombre y apellidos, un correo electrónico y un número de teléfono? (recopila datos)
Agente: Para confirmar: familia Berger, del 22 al 25 de mayo, Studio Talblick por 348 euros, correo b@example.com. ¿Lo reservo en firme?
Cliente: Sí, por favor.
Agente: (llama a create_smoobu_booking, ID 9241 devuelto) Reservado, número de confirmación 9241. ¿Le envío la confirmación por correo y WhatsApp?
Cliente: Ambos, por favor.
Agente: (llama a send_smoobu_message) Hecho, el correo llegará en los próximos minutos.

90 segundos, una reserva confirmada, un cliente feliz, sin necesidad de nadie al teléfono. La misma experiencia funciona a las 10 de la noche de un domingo.

Lo que cuesta la configuración

El acceso a la API de Smoobu está incluido en los planes profesionales de Smoobu, sin costes adicionales de API. Por parte de Famulor, pagas una cuota mensual de plataforma más un precio por minuto de llamada dependiendo de la voz y el modelo; las tarifas son transparentes en la página de precios de Famulor. Para un anfitrión que realiza entre 50 y 200 llamadas al mes, el coste mensual total se sitúa muy por debajo del coste por hora de un recepcionista a tiempo parcial. Una reserva directa confirmada a través de tu propio número también evita la comisión del 15-20 por ciento que cobran las OTA como Airbnb o Booking.com.

Seguridad, RGPD y mejores prácticas

Tres cosas no son negociables en el contexto de un anfitrión en la UE:

Protección de la clave API. La clave de Smoobu pertenece a la cabecera de Famulor y a ningún otro lugar. Famulor aloja la configuración de la herramienta en la UE, la clave está cifrada en reposo y nunca aparece en las transcripciones de las llamadas. Rota la clave cada 6-12 meses.

Confirmación antes de reservar. Integra la confirmación explícita en la lógica de la conversación. "¿Lo reservo en firme?" no es opcional; si te lo saltas, al final el modelo convertirá un "solo estaba preguntando" en una reserva real.

RGPD y grabación. Se notifica a los clientes que la llamada está siendo grabada al inicio de la misma. Smoobu ya almacena los datos de reserva de forma conforme a la normativa de la UE, y Famulor ofrece un DPA y alojamiento en la UE. La configuración combinada cumple con los requisitos estándar sin ingeniería adicional. Los antecedentes sobre el cumplimiento de la telefonía se encuentran en la página del glosario de troncales SIP y en la sección de cumplimiento de Famulor.

Extensiones que vale la pena considerar más adelante

Una vez que el agente base funciona, tres extensiones aportan un valor enorme. Primero, campañas salientes para consultas que no llegaron a reservar: el agente llama a los interesados que rellenaron un formulario. Segundo, llamadas automáticas antes de la estancia tres días antes de la llegada con información de check-in y venta de complementos. Tercero, llamadas después de la estancia para recopilar una breve reseña e introducir las respuestas en el CRM de huéspedes.

Las tres reutilizan la misma colección de herramientas de Smoobu más lógica saliente adicional en Famulor. Un vistazo al directorio de integraciones de Famulor muestra cómo las herramientas de CRM, correo y calendario se integran para completar el stack.

Conclusión: la API más la IA de voz te dan un colega real 24/7

Smoobu gestiona la propiedad. Famulor gestiona la conversación. Conecta ambos mediante herramientas durante la llamada y tendrás un agente que responde en tiempo real, reserva en firme y mantiene los datos del PMS consistentes. La configuración lleva aproximadamente una hora; si las descripciones de tus herramientas y el prompt del sistema son claros, el resto encaja por sí solo. Famulor es la primera opción aquí porque el alojamiento en la UE, los precios transparentes por minuto, un constructor sin código y un endpoint dedicado para herramientas durante la llamada vienen de serie en lugar de tener que ensamblarlos con piezas de terceros.

Preguntas frecuentes

¿Qué planes de Smoobu admiten la API?

El acceso a la API está disponible en los planes profesionales de Smoobu. Encuentra la clave API personal en Ajustes → API. OAuth 2 está reservado para socios oficiales de Smoobu.

¿Necesito conocimientos de ingeniería para configurar esto?

No. Las herramientas durante la llamada se configuran en el panel de control de Famulor mediante un formulario, sin código. Introduces el endpoint, el método, las cabeceras y el esquema, y Famulor gestiona la llamada en tiempo de ejecución.

¿Cómo evito las reservas dobles?

Smoobu es la única fuente de verdad que sincroniza todos los canales. Mientras el agente de voz solo escriba a través de Smoobu, las reservas dobles no pueden ocurrir. La regla clave: no permitir acceso de escritura directa en paralelo desde otros sistemas.

¿Puede el agente aplicar reglas de precios estacionales?

Sí. Smoobu devuelve precios y restricciones automáticamente cuando se llama al endpoint de disponibilidad. El agente lee exactamente lo que Smoobu calculó para ese rango, incluyendo la estancia mínima y las restricciones de día de llegada.

¿Qué ocurre si la API de Smoobu tiene una breve interrupción?

Las herramientas durante la llamada de Famulor tienen un tiempo de espera configurable (1-30 segundos). Si la llamada falla, el agente puede disculparse, programar una devolución de llamada y registrar la solicitud como una tarea en tu CRM o como un correo electrónico para ti.

¿Funciona esto también para otros gestores de canales además de Smoobu?

Sí. El mismo patrón se aplica a Hostaway, Lodgify, Guesty o sistemas PMS propietarios siempre que exista una API REST. El endpoint de herramientas durante la llamada de Famulor es independiente del proveedor.

¿Qué idiomas entiende el agente de voz?

Famulor admite más de 40 idiomas con detección automática al inicio de la llamada. Los anfitriones internacionales se benefician especialmente: el agente responde en el mismo registro lingüístico que el cliente.

¿Cómo mido si la IA reserva más que un humano?

Famulor informa sobre la transcripción de cada llamada, las llamadas a herramientas, los ID de reserva y los resultados. Puedes comparar la conversión de reservas diaria con tu línea base anterior a la IA y ver el delta directamente.

¿Cuál es el límite de solicitudes de Smoobu para un agente de voz?

Smoobu permite 1.000 solicitudes por minuto por token. Incluso con 50 llamadas simultáneas y 4-5 llamadas a herramientas cada una, estarás muy por debajo del límite.