Handleiding / Integraties

Channex (channel manager)

Bijgewerkt op 2026-04-22

Channex is de channel manager die BedFlow gebruikt om Booking.com, Airbnb, Expedia en andere OTA's te syncen. Zonder Channex zou je manueel per OTA je beschikbaarheid en prijzen moeten onderhouden.

Wat doet Channex voor BedFlow?

  • Beschikbaarheid push: als een kamer wordt geblokkeerd in BedFlow → binnen enkele seconden ook bij Booking.com
  • Prijzen push: Tarieven wijzigingen gaan automatisch naar alle OTA's
  • Booking import: nieuwe OTA-boekingen komen binnen via webhook → BedFlow maakt automatisch een Booking + Debtor aan

Setup

  1. Maak een Channex account (staging.channex.io voor testen, app.channex.io voor productie)
  2. Koppel je bestaande OTA's in Channex (Booking.com extranet credentials, Airbnb, etc.)
  3. In BedFlow: Settings → Integraties → Channex tab — vul API key + property ID in
  4. Ga naar Kamertypes — per kamer vul je het Channex Room Type ID en per kanaal de Rate Plan ID in
  5. Activeer Channex via de toggle op de Connections pagina
  6. Klik Channex Sync rechtsboven om een eerste full sync te draaien

Automatische events

  • Booking aangemaakt → PushRoomAvailabilityJob per betrokken kamer
  • Cel toggled in Kameroverzicht → zelfde job
  • Tarief gewijzigd → SyncRoomPricesJob
  • Dagelijks om 06:00: volledige price sync voor alle kamers (365 dagen vooruit)
  • Dagelijks om 06:30: competitor prices scrape (informatief)

Rate limiting

Channex heeft een rate limit:

  • Staging: 1 request / 7 seconden
  • Productie: 1 request / seconde

BedFlow's ChannexService throttelt automatisch. Jobs draaien sequentieel via --queue=channex worker (niet parallel).

Webhooks (inkomend)

Channex stuurt webhooks naar /api/channex/webhook bij:

  • booking.new — nieuwe OTA-boeking
  • booking.modified — OTA-boeking gewijzigd
  • booking.cancelled — OTA-boeking geannuleerd

Signature validation via shared secret in settings.

Staging testen

Er bestaan 4 artisan commands om te valideren:

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)
← Terug naar categorie