Qué claves necesita y dónde van

Una clave (también llamada clave API, token o credencial) es un código largo que permite que un sistema hable con otro en su nombre. Usted la crea en el otro sistema y la pega en Hotelmente.

Una clave es como una tarjeta de acceso para software: abre solo las puertas que usted permite, y puede anularla en cualquier momento sin cambiar su contraseña.

Una clave: su clave API de Cloudbeds. Con ella, Hotelmente AI trae sus reservas, tarifas y pagos y empieza a trabajar.

Todo lo demás es opcional y se puede agregar después, de uno en uno.

Obligatoria:
- Clave API de Cloudbeds. Dónde: el paso Conectar en el inicio de Hotelmente y, después, Hotelmente AI → Configuración AI → Su sistema de gestión.

Opcionales, todas visibles en Hotelmente AI → Configuración AI:
- Facebook Page + Instagram: un token que usted genera en el Graph API Explorer de Facebook. Hotelmente lo convierte en un token de página que no vence y completa los ID de su página y de Instagram.
- Google Analytics y Search Console: ninguna clave. Usted agrega el correo de Hotelmente a sus cuentas de Google, solo con permiso de lectura. Las páginas Analítica web y Posicionamiento web muestran el correo y los pasos.
- Google Places y SerpApi (datos de la competencia): los pone Hotelmente, así que aparecen en Incluido con Hotelmente. No hay nada que pegar.

Los feriados, los tipos de cambio y la moneda en que se muestran los montos no necesitan clave, solo preferencias.

Hotelmente PAY usa la misma conexión con Cloudbeds y, además, las credenciales que su banco le entrega para pagos en línea. Con BAC son un número de comercio (afiliado), una clave de API, un secreto de API, un secreto de firma del webhook y el ambiente (pruebas o producción), y en algunos países un ID de terminal y un número de comercio aparte para USD.

Dónde: Hotelmente PAY → Configuración PAY → Credenciales del banco. Solo un propietario del hotel puede verlas o cambiarlas. La guía Credenciales del banco para Hotelmente PAY explica qué pedirle a BAC.

Hotelmente FACTURA usa la misma conexión con Cloudbeds y, además, su acceso a la autoridad tributaria (o al proveedor certificado que exige su país). Según el país es un usuario y contraseña de API, un certificado digital o llave criptográfica con su PIN, y sus rangos de numeración autorizados.

Dónde: Hotelmente FACTURA → Configuración FACTURA, en tres paneles: Qué factura FACTURA, Numeración y ambiente, y Credenciales para el envío. Solo un propietario puede cambiarlos. La guía Credenciales de la autoridad tributaria explica cada país.

Hotelmente maneja estos servicios con sus propias cuentas de empresa. Usted nunca crea, paga ni pega estas claves:
- El motor de IA que redacta resúmenes, análisis, respuestas y publicaciones.
- Google Places, para competencia, calificaciones y reseñas recientes.
- Precios de la competencia desde Google Hotels.
- El servicio de correo de Hotelmente para códigos de acceso y correos de su cuenta.
- Los pagos con tarjeta y PayPal de su suscripción a Hotelmente.
- La app del Marketplace de Cloudbeds detrás de Conectar con Cloudbeds.
- La cuenta de servicio de Google de Hotelmente, que lee su Google Analytics y su Search Console cuando usted agrega su correo.
- La app de Meta de Hotelmente, que convierte el token de Facebook que usted pega en un token de página que no vence.

En Configuración AI, los que correspondan aparecen en Incluido con Hotelmente. Nadie de Hotelmente le pedirá nunca claves de estos servicios.

• Clave API de Cloudbeds → inicio de Hotelmente (paso Conectar) y, después, Hotelmente AI → Configuración AI → Su sistema de gestión → Reemplazar clave.
• Tipos de cambio, moneda de los montos y feriados → Hotelmente AI → Configuración AI.
• Facebook e Instagram → Configuración AI → Facebook Page + Instagram.
• Google Analytics → la página Analítica web muestra el correo que debe agregar y el campo para su ID de propiedad.
• Search Console → la página Posicionamiento web muestra el correo que debe agregar y el campo para la dirección de su sitio.
• Credenciales de BAC → Hotelmente PAY → Configuración PAY → Credenciales del banco.
• Credenciales tributarias → Hotelmente FACTURA → Configuración FACTURA → Credenciales para el envío.

Cada opción de configuración del menú muestra un contador como (3/5): los datos obligatorios ingresados sobre el total. Datos de la cuenta y Usuarios y equipo están en la parte Configuración del menú; Datos de la propiedad está bajo el nombre de su propiedad, arriba a la derecha.

• Paso 1: Conecte Cloudbeds (obligatorio). Espere la primera sincronización.
• Paso 2: Conecte Facebook Page + Instagram en Configuración AI, si quiere publicar y ver los resultados de sus publicaciones.
• Paso 3: Dé a Hotelmente acceso de solo lectura a Google Analytics (página Analítica web) y a Search Console (página Posicionamiento web).
• Paso 4: Para Hotelmente PAY y Hotelmente FACTURA, complete por adelantado Configuración PAY y Configuración FACTURA. Una guía arriba de cada página muestra lo que falta. Consulte con tiempo a BAC y a su contador: sus trámites son los que más tardan.

• Cifradas en reposo (AES-256-GCM), en el espacio propio de su hotel con una clave derivada solo para su hotel.
• Nunca se devuelven a ningún navegador, ni siquiera al suyo. Las pantallas solo muestran que hay una clave guardada y sus últimos 4 caracteres. Los secretos de FACTURA no muestran nada.
• Nunca se escriben en los registros: Hotelmente elimina claves, contraseñas y tokens de cada línea de registro.
• Solo las usan los servidores de Hotelmente, para llamar al servicio al que pertenecen.
• Para cambiar un secreto, escriba el nuevo. Si deja el campo vacío, se mantiene el guardado.

• Solo propietarios: la conexión con Cloudbeds (probar, reemplazar, desconectar), las credenciales del banco de PAY y, en Configuración FACTURA, las credenciales, la numeración y qué factura FACTURA.
• Propietarios y gerentes: las demás conexiones, como Facebook Page + Instagram, Google Analytics, Search Console, feriados y moneda.
• Solo lectura: ven el estado, no cambian nada.

Si alguien sin permiso lo intenta, Hotelmente responde: Solo un propietario de este hotel puede hacer eso. Los roles se asignan en Configuración → Usuarios y equipo.

Sí.
- Cloudbeds: Reemplazar clave prueba primero la nueva; la actual se mantiene hasta que la nueva funcione. Desconectar borra la clave guardada.
- Otras conexiones (Configuración AI): abra la fila, escriba el valor nuevo y haga clic en Guardar y probar, o en Desconectar para borrar las claves guardadas de ese servicio.
- PAY: Quitar en Credenciales del banco (Configuración PAY). FACTURA: Eliminar credenciales en Credenciales para el envío (Configuración FACTURA).

Para mayor seguridad, anule también la clave anterior en el sistema que la emitió (Cloudbeds, Meta, su banco o su autoridad tributaria).

No la envíe. Péguela usted mismo en el campo correcto de Hotelmente: es el único lugar donde se necesita, y ahí se guarda cifrada.

Nunca envíe claves, contraseñas ni certificados por correo, WhatsApp o chat, ni a Hotelmente ni a nadie. Si una clave se compartió por error, anúlela en el sistema que la emitió y cree una nueva.

Cada fila de conexión en Configuración AI muestra un estado y el resultado de la última prueba con su fecha:
- Conectado: la última prueba pasó.
- Error: la última prueba falló. Abra la fila para ver el mensaje.
- No conectado: aún no hay nada guardado.
- Hotelmente lo está configurando: Hotelmente termina su parte; usted no tiene que hacer nada.

Haga clic en Guardar y probar (o Probar para Cloudbeds) cuando quiera. Una prueba solo lee; nunca cambia nada. En el menú, el contador junto a cada opción de configuración, como (2/4), se pone verde cuando está todo lo obligatorio.

• Sitio web: que agregue un botón Reservar ahora que abra su motor de reservas de Cloudbeds.
• Google: que agregue el correo de Hotelmente, solo con lectura, a su Google Analytics y su Search Console, si los administra.
• Facebook: que le haga administrador con control total de la página de Facebook, si la creó esa persona.

Usted pega los valores en Hotelmente; esa persona no necesita acceso a Hotelmente.