# Conectar Channex

Channex es un channel manager que usan muchos PMS y anfitriones. El portal del huésped lee tus reservas de Channex y crea un enlace al portal para cada huésped.

## 1. Crea una clave de API de Channex

1. Inicia sesión en Channex (`https://app.channex.io`, o tu dirección de Channex de marca blanca).
2. Abre tu perfil de usuario y ve a **API keys**.
3. Crea una nueva clave llamada *Guest portal* y cópiala.

## 2. Conéctalo en tu panel

1. Abre **Settings → Channels → Channex**.
2. Pega la **API key**.
3. **Base URL**: deja `https://app.channex.io` salvo que hagas pruebas en `https://staging.channex.io`. Solo se aceptan direcciones de Channex.
4. Marca **Enabled**, pulsa **Save** y luego **Test**.

![Settings → Channels](/site/img/docs/d-settings-channels.webp "Settings → Channels")

## 3. Vincula tus alojamientos

**Show listings** muestra tus alojamientos de Channex con sus IDs (UUID). **Add selected as properties** (también se importan las fotos; la primera se usa como portada; **Import photos** en la tarjeta las obtiene para alojamientos vinculados antes) crea un alojamiento por cada uno marcado, con nombre, dirección, localidad, país y zona horaria de Channex, lo vincula e importa sus reservas. Para un alojamiento que ya creaste a mano, desmárcalo y pega en su lugar el ID en **Settings → Properties → Settings → Channex property ID**.

## 4. Importa

Haz clic en **Import now**; después, las reservas se importan cada 30 minutos, incluidas modificaciones y cancelaciones.

### Actualizaciones instantáneas (webhook)

![Actualizaciones instantáneas en la tarjeta del canal](/site/img/docs/d-channels-instant.webp "Actualizaciones instantáneas en la tarjeta del canal")


1. En **Settings → Channels → Channex**, haz clic en **Set up instant updates** y luego en **Register in Channex**. El portal del huésped crea el webhook de reservas en tu cuenta de Channex (uno para la cuenta, o uno por alojamiento vinculado si tu plan de Channex solo permite webhooks por alojamiento).
2. Las reservas nuevas, modificadas y canceladas llegan entonces en segundos; la tarjeta muestra la última llamada. La importación periódica sigue funcionando como red de seguridad.

La dirección es secreta. **New address** la sustituye y actualiza automáticamente el webhook en Channex.

## 5. Confirma las revisiones de reservas (opcional)

Channex espera que el sistema que gestiona tus reservas **confirme** (acknowledge) cada revisión de reserva de su feed; las revisiones no confirmadas se reenvían y Channex te avisa por email. Marca **Acknowledge booking revisions** en la tarjeta de Channex cuando el portal del huésped sea el único sistema que lee esta cuenta de Channex. Si otro sistema (otro PMS, o codeb-demo) ya las confirma, déjalo desactivado: el portal del huésped lee entonces las reservas directamente y no se pierde nada.

## 6. Escribe a los huéspedes

Para reservas de Booking.com, Airbnb y Expedia puedes escribir al huésped en el chat del propio canal: la sección **Messages** de la reserva muestra la conversación, **Send portal link via …** envía el enlace de la guía de la estancia y **Settings → Email → Also send it through the booking channel's chat** lo hace automáticamente antes de la llegada.

- Debe estar instalada la app **Messages** de Channex (app.channex.io → Applications).
- Las reservas de Expedia Partner Solutions / afiliados no admiten mensajes.
- Las reservas importadas antes de que existiera la mensajería se vinculan en la siguiente importación.

## Preguntas frecuentes

### ¿Cambia el portal del huésped algo en Channex?

No. La conexión lee las reservas (y, si lo activas, confirma las revisiones de reservas) y envía los mensajes a huéspedes que escribas. La disponibilidad y los precios se siguen gestionando en Channex.

### Uso Channex a través de mi PMS, ¿puedo conectarlo igualmente?

Sí, siempre que puedas crear una clave de API de Channex con acceso a los alojamientos. Pregunta a tu proveedor de PMS si solo tienes un acceso de marca blanca.