# Connecter Channex

Channex est un channel manager utilisé par de nombreux PMS et hôtes. Le portail voyageurs lit vos réservations Channex et crée un lien vers le portail pour chaque voyageur.

## 1. Créer une clé API Channex

1. Connectez-vous à Channex (`https://app.channex.io`, ou votre adresse Channex en marque blanche).
2. Ouvrez votre profil utilisateur et allez dans **API keys**.
3. Créez une nouvelle clé nommée *Guest portal* et copiez-la.

## 2. Connecter depuis votre tableau de bord

1. Ouvrez **Settings → Channels → Channex** (Paramètres → Canaux).
2. Collez la **clé API** (API key).
3. **Base URL** : laissez `https://app.channex.io`, sauf si vous testez sur `https://staging.channex.io`. Seules les adresses Channex sont acceptées.
4. Cochez **Enabled**, puis **Save** et **Test**.

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

## 3. Relier vos logements

**Show listings** liste vos logements Channex avec leurs identifiants (UUID). **Add selected as properties** (les photos sont également importées — la première devient la photo de couverture ; **Import photos** dans la carte les récupère pour les logements reliés auparavant) crée un logement pour chaque élément coché — avec le nom, l'adresse, la ville, le pays et le fuseau horaire issus de Channex —, le relie et importe ses réservations. Pour un logement que vous avez déjà créé manuellement, décochez-le et collez plutôt l'identifiant dans **Settings → Properties → Settings → Channex property ID**.

## 4. Importer

Cliquez sur **Import now** ; ensuite, les réservations sont importées toutes les 30 minutes, modifications et annulations comprises.

### Mises à jour instantanées (webhook)

![Mises à jour instantanées dans la carte du canal](/site/img/docs/d-channels-instant.webp "Mises à jour instantanées dans la carte du canal")


1. Dans **Settings → Channels → Channex**, cliquez sur **Set up instant updates**, puis sur **Register in Channex**. Le portail voyageurs crée le webhook de réservation dans votre compte Channex (un pour le compte, ou un par logement relié si votre offre Channex n'autorise que les webhooks par logement).
2. Les réservations nouvelles, modifiées et annulées arrivent alors en quelques secondes ; la carte affiche le dernier appel. L'import régulier continue de tourner comme filet de sécurité.

L'adresse est secrète. **New address** la remplace et met à jour automatiquement le webhook dans Channex.

## 5. Accuser réception des révisions de réservation (facultatif)

Channex attend du système qui gère vos réservations qu'il **accuse réception** de chaque révision de réservation de son flux ; les révisions non confirmées sont renvoyées et Channex vous avertit par e-mail. Cochez **Acknowledge booking revisions** dans la carte Channex lorsque le portail voyageurs est le seul système à lire ce compte Channex. Si un autre système (un autre PMS, ou codeb-demo) en accuse déjà réception, laissez l'option désactivée — le portail voyageurs lit alors directement les réservations et rien n'est perdu.

## 6. Écrire aux voyageurs

Pour les réservations Booking.com, Airbnb et Expedia, vous pouvez écrire au voyageur dans la messagerie du canal : la section **Messages** de la réservation affiche la conversation, **Send portal link via …** envoie le lien du guide de séjour, et **Settings → Email → Also send it through the booking channel's chat** le fait automatiquement avant l'arrivée.

- L'application **Messages** de Channex doit être installée (app.channex.io → Applications).
- Les réservations Expedia Partner Solutions / affiliées ne prennent pas en charge les messages.
- Les réservations importées avant la disponibilité de la messagerie sont reliées lors de l'import suivant.

## Questions fréquentes

### Le portail voyageurs modifie-t-il quelque chose dans Channex ?

Non. La connexion lit les réservations (et, si vous l'activez, accuse réception des révisions de réservation) et envoie les messages que vous rédigez aux voyageurs. Les disponibilités et les tarifs restent gérés dans Channex.

### J'utilise Channex via mon PMS — puis-je quand même le connecter ?

Oui, à condition de pouvoir créer une clé API Channex ayant accès aux logements. Renseignez-vous auprès de votre fournisseur de PMS si vous n'avez qu'un accès en marque blanche.