Manual / Integrações

Channex (channel manager)

Atualizado em 2026-08-17

O Channex é o channel manager que o BedFlow utiliza para sincronizar Booking.com, Airbnb, Expedia, OpenGDS, HRS, Check24 e Weekendesk. Sem o Channex teria de manter manualmente disponibilidades e preços em cada OTA.

Canais suportados (via Channex)

| Canal | Código | Região / tipo | Comissão padrão | |---|---|---|---| | Booking.com | BDC | Mundial | 18% | | Airbnb | ABB | Mundial | 15% | | Expedia (incl. Hotels.com / Vrbo) | EXP | Mundial | 20% | | OpenGDS | GDS | UE + subcanais (VIPIO, Charmant Hotel) | 22% | | HRS | HRS | DACH corporate / business travellers | 15% (típico) | | Check24 | CCK | Metasearch Alemanha | 10% (típico) | | Weekendesk | WKD | BE/NL/FR fim de semana e escapadinhas | 17% (típico) |

Cada canal é opt-in por propriedade (RateRule + mapeamento de quartos em Connections). A fonte da verdade para metadados de canais está em App\Enums\Channel.

O que faz o Channex pelo BedFlow?

  • Push de disponibilidade: se um quarto for bloqueado no BedFlow → em poucos segundos também no Booking.com
  • Push de preços: alterações de tarifas são enviadas automaticamente para todas as OTA's
  • Importação de bookings: novas reservas OTA chegam via webhook → o BedFlow cria automaticamente uma Booking + Debtor

Setup

  1. Crie uma conta Channex (staging.channex.io para testes, app.channex.io para produção)
  2. Ligue as suas OTA's existentes no Channex (credenciais Booking.com extranet, Airbnb, etc.)
  3. No BedFlow: separador Settings → Integrações → Channex — preencha API key + property ID
  4. Vá a Tipos de quarto — por quarto preenche o Channex Room Type ID e por canal o Rate Plan ID
  5. Ative o Channex pelo interruptor na página Connections
  6. Clique em Sincronizar canais em cima à direita para correr uma primeira sincronização completa

Eventos automáticos

  • Reserva criada → PushRoomAvailabilityJob por cada quarto envolvido
  • Célula alternada na Visão geral dos quartos → mesmo job
  • Tarifa alterada → SyncRoomPricesJob
  • Diariamente às 06:00: sync de preços completo para todos os quartos (365 dias para a frente)
  • Diariamente às 06:30: scrape de preços dos concorrentes (informativo)

Rate limiting

O Channex tem um rate limit:

  • Staging: 1 request / 7 segundos
  • Produção: 1 request / segundo

O ChannexService do BedFlow faz throttle automático. Os jobs correm sequencialmente através do worker --queue=channex (não em paralelo).

Webhooks (entrada)

O Channex envia webhooks para /api/channex/webhook em:

  • booking.new — nova reserva OTA
  • booking.modified — reserva OTA alterada
  • booking.cancelled — reserva OTA cancelada

Validação de assinatura através de shared secret nas settings.

Verificar a ligação por si mesmo

Dúvidas se está tudo bem configurado? Ambas as verificações estão diretamente no BedFlow, em cima à direita em Definições → Ligações:

  • Testar ligação — verifica de imediato se a ligação com o channel manager funciona e mostra quantos tipos de quarto e planos de tarifas foram encontrados para o seu alojamento. Se algo estiver errado, a notificação diz o quê.
  • Sincronizar canais — volta a enviar disponibilidade e preços para todos os canais ligados. Acompanha o progresso na barra no topo da página.

Primeiro Testar ligação, depois Sincronizar canais — se mesmo assim algo não passar, escreva para support@bedflow.eu.

← Voltar à categoria