Manual / Integrações

Channex (channel manager)

Atualizado em 2026-09-12

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

Adicionar um canal que ainda não tem mosaico

Em Definições → Integrações aparecem por defeito os canais habituais (Booking.com, Airbnb, Expedia, Vrbo, Google, OpenGDS, HRS, Check24, Weekendesk). A BedFlow chega a mais de setenta através do Channex — a lista completa está em Todas as integrações. Falta-lhe um, p. ex. Hotelbeds, Reconline ou Trip.com:

  1. Clique no topo da secção Canais em Adicionar canal.
  2. Escreva o nome e escolha o canal. Clique em Adicionar mosaico — o mosaico aparece de imediato.
  3. Abra o mosaico, introduza o seu ID de propriedade nesse canal (da extranet ou portal de parceiros deles) e clique em Guardar.
  4. Clique em Ligar no Channex, escolha o canal na lista e percorra o assistente (mapeamento dos quartos, ver Setup abaixo). Depois clique em Concluir — fechar e atualizar estado.
  5. O canal confirma a ligação do lado deles, normalmente em um a três dias úteis; o estado passa sozinho a Ativo.

Os parceiros OpenGDS (Natuurhuisje, Weekendjeweg.nl, HotelSpecials, Vipio, …) não têm mosaico próprio: ativa-os na sua conta OpenGDS e liga-os aqui pelo mosaico OpenGDS — passo a passo em Conectar OpenGDS.

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