Manuel / Intégrations

Channex (channel manager)

Mis à jour le 2026-04-29

Channex est le channel manager utilisé par BedFlow pour synchroniser Booking.com, Airbnb, Expedia, OpenGDS, HRS, Check24 et Weekendesk. Sans Channex, vous devriez maintenir manuellement la disponibilité et les prix sur chaque OTA.

Canaux pris en charge (via Channex)

| Canal | Code | Région / type | Commission par défaut | |---|---|---|---| | Booking.com | BDC | Mondial | 18% | | Airbnb | ABB | Mondial | 15% | | Expedia (Hotels.com / Vrbo inclus) | EXP | Mondial | 20% | | OpenGDS | GDS | UE + sous-canaux (VIPIO, Charmant Hotel) | 22% | | HRS | HRS | DACH affaires / voyageurs business | 15% (typique) | | Check24 | CCK | Métamoteur Allemagne | 10% (typique) | | Weekendesk | WKD | BE/NL/FR week-end & courts séjours | 17% (typique) |

Chaque canal est activable par établissement (RateRule + mapping de chambres dans Connections). La source de référence des métadonnées de canal se trouve dans App\Enums\Channel.

Que fait Channex pour BedFlow ?

  • Push de la disponibilité : si une chambre est bloquée dans BedFlow → quelques secondes plus tard, elle l'est aussi sur Booking.com
  • Push des prix : les modifications tarifaires partent automatiquement vers tous les OTA
  • Import des réservations : les nouvelles réservations OTA arrivent via webhook → BedFlow crée automatiquement une Booking + un Debtor

Mise en place

  1. Créez un compte Channex (staging.channex.io pour les tests, app.channex.io pour la production)
  2. Connectez vos OTA existantes dans Channex (credentials extranet Booking.com, Airbnb, etc.)
  3. Dans BedFlow : Settings → Intégrations → Channex — saisissez la clé API + le property ID
  4. Allez dans Types de chambres — pour chaque chambre, renseignez le Channex Room Type ID et, par canal, le Rate Plan ID
  5. Activez Channex via le toggle sur la page Connections
  6. Cliquez sur Channex Sync en haut à droite pour effectuer une première synchronisation complète

Événements automatiques

  • Réservation créée → PushRoomAvailabilityJob par chambre concernée
  • Cellule basculée dans la Vue chambres → même job
  • Tarif modifié → SyncRoomPricesJob
  • Tous les jours à 06:00 : synchro complète des prix pour toutes les chambres (365 jours à l'avance)
  • Tous les jours à 06:30 : scrape des prix concurrents (informatif)

Rate limiting

Channex applique une limite de taux :

  • Staging : 1 requête / 7 secondes
  • Production : 1 requête / seconde

Le ChannexService de BedFlow régule automatiquement. Les jobs s'exécutent séquentiellement via le worker --queue=channex (pas en parallèle).

Webhooks (entrants)

Channex envoie des webhooks vers /api/channex/webhook pour :

  • booking.new — nouvelle réservation OTA
  • booking.modified — réservation OTA modifiée
  • booking.cancelled — réservation OTA annulée

Validation de la signature via shared secret dans les settings.

Tests staging

4 commandes artisan permettent de valider :

php artisan channex:test          # check credentials
php artisan channex:sync-rooms    # push room types
php artisan channex:sync-prices   # push prices (365 days)
php artisan channex:sync-availability  # push availability (365 days)
← Retour à la catégorie