Manual / Migração

Fase paralela com webhooks

Atualizado em 2026-04-26

O que é a fase paralela?

Entre a sua migração e a sua troca definitiva recomendamos 2-4 semanas de fase paralela: o MyTourist continua a ser o seu sistema primário, o BedFlow corre em shadow com os mesmos dados. As novas reservas que entram no MT aparecem também em tempo real no BedFlow.

Vantagem: pode testar o BedFlow com dados reais sem risco — se algo não funcionar, ainda tem o MT. Apenas quando estiver 100% confortável é que coloca o BedFlow definitivamente em produção.

Como funciona tecnicamente?

A API-key por si só não basta para sync em direto. Uma API-key permite-nos ler os seus dados MT — uma única vez ou a pedido — mas o MT não nos liga quando algo muda. Para isso precisa de webhooks.

Um webhook é um URL que define no MyTourist. Em cada acontecimento (nova reserva, pagamento, check-in, fatura) o MT envia um pedido POST para esse URL. Recebemos isso e atualizamos imediatamente os seus dados BedFlow.

Passo 1 — Encontre o seu URL de webhook único

Após a migração, no passo 6 do assistente vê um URL único para a sua property, por exemplo:

https://bedflow.eu/webhooks/mytourist/aB3kP9xQ2mL7nR5tY8wE1zU4vH6cI0sD9fG2jK4o

A string longa no final é um token que garante que apenas a sua conta MT pode escrever na sua property BedFlow. Clique no botão Copiar — vai precisar deste URL imediatamente no MyTourist.

💡 Perdeu? Abra o admin do BedFlow → Properties → a sua property → campo Webhook URL.

Passo 2 — Cole no MyTourist

No MyTourist:

  1. Definições → Webhooks
  2. Clique em + Adicionar webhook
  3. URL: cole o seu URL de webhook BedFlow
  4. Eventos — assinale todos os seguintes:
    • booking.created
    • booking.updated
    • booking.cancelled
    • booking.checkin
    • booking.checkout
    • invoice.created
    • invoice.paid
    • invoice.cancelled
    • payment.received
  5. Estado: ativo
  6. Clique em Guardar.

Passo 3 — Teste

No MyTourist: crie uma reserva de teste (por ex. para si próprio, 1 noite, hoje→amanhã). Aguarde 5 segundos e depois vá ao admin do BedFlow → Reservas. A reserva deve estar lá.

Não está visível? Verifique:

  • No MT → Webhooks → o seu webhook → separador Logs — vê uma resposta 200 de bedflow.eu?
  • Sem 200? Dê ao support uma resposta de ticket (gratuita porque não é uma pergunta mas sim um possível bug no nosso webhook-handler).

O que faz o BedFlow com os eventos?

| Evento MT | Ação BedFlow | |---|---| | booking.created | Criar nova reserva, fazer match do devedor, atualizar calendário | | booking.updated | Ajustar reserva existente, sync de preço/data | | booking.cancelled | Estado → cancelled, quarto fica disponível novamente | | booking.checkin/out | Atualizar estado, despoletar tarefa de housekeeping | | invoice.created | Fatura no BedFlow com download de PDF | | invoice.paid | Estado → paid, registar pagamento | | payment.received | Log de pagamento no separador financeiro |

Switch-over: de paralelo para BedFlow total

Quando decidir mudar a 100%:

  1. Aponte o seu booking-widget no seu site para o URL do widget BedFlow.
  2. Apague o webhook no MyTourist (definições → webhooks → apagar).
  3. Coloque o MyTourist em modo read-only ou cancele a subscrição.
  4. O BedFlow passa agora a ser a única fonte.

Recomendamos manter o MT por 30 dias como rede de segurança, mas isso fica ao seu critério.

Dúvidas ou problemas?

  • O webhook não funciona → ticket de bug, fix gratuito
  • Não tem certeza de como configurar → reserve 30 min de screen-share (€45)
  • Quer ajuda para fazer o switch → support@bedflow.eu
← Voltar à categoria