Channel Manager
Ligar canais OTA e sincronizar disponibilidade automaticamente via iCal
Channel Manager
O Channel Manager permite ligar o AlojaPT aos principais canais de distribuição de alojamento (OTA — Online Travel Agencies) e sincronizar automaticamente a disponibilidade e as reservas. Quando uma reserva entra numa plataforma, o calendário é actualizado em todas as outras, evitando overbooking.
O Channel Manager requer o plano Professional (até 2 canais) ou superior. O plano Starter não inclui esta funcionalidade.
Canais Suportados
| Canal | Tipo de Integração | Frequência de Sync |
|---|---|---|
| Airbnb | iCal | Automática — 15 minutos |
| Booking.com | iCal | Automática — 15 minutos |
| Expedia | iCal | Automática — 15 minutos |
| Rentalia | iCal | Automática — 15 minutos |
| Google Vacation Rentals | iCal | Automática — 15 minutos |
A sincronização é feita via protocolo iCal (ICS), processada automaticamente pelo sistema de filas BullMQ. Não é necessária qualquer acção manual para manter a sincronização activa.
Limites de Canais por Plano
| Plano | Máximo de canais |
|---|---|
| Starter | 0 (não disponível) |
| Professional | 2 |
| Pro | Ilimitado |
| Enterprise | Ilimitado |
Se ultrapassar o limite de canais do seu plano, não será possível adicionar novos canais até fazer upgrade ou remover um canal existente.
Como Funciona a Sincronização
A cada 15 minutos, o sistema:
- Faz download do ficheiro
.icsdo canal OTA (URL iCal configurada) - Compara os eventos com os dados locais do AlojaPT
- Cria reservas ou bloqueios para novos eventos encontrados
- Cancela reservas ou remove bloqueios para eventos eliminados no canal
Adicionar um Canal iCal
Passo 1 — Obter a URL iCal do canal OTA
Airbnb:
- Aceda à sua conta Airbnb.
- Vá a Calendário → Disponibilidade → Sincronizar calendários.
- Clique em "Exportar calendário" e copie a URL (começa com
https://www.airbnb.com/calendar/ical/...).
Booking.com:
- Aceda ao seu extranet Booking.com.
- Vá a Calendário → Sincronização de calendário.
- Seleccione "iCal" e copie o URL de exportação.
Expedia / VRBO:
- Aceda ao Expedia Partner Central.
- Vá a Calendário → iCal e copie o URL de exportação.
Passo 2 — Adicionar no AlojaPT
Aceder ao Channel Manager
No menu lateral, clique em "Channel Manager" e depois em "Adicionar canal".
Configurar o canal
Seleccione o canal da lista (Airbnb, Booking.com, etc.) e a propriedade a que se refere.
Colar a URL iCal
No campo "URL iCal do canal", cole a URL obtida no passo anterior.
Testar a ligação
Clique em "Testar ligação" — o sistema verifica se a URL é válida e apresenta o número de eventos encontrados.
Guardar
Se o teste passar, clique em "Guardar canal". A sincronização inicia automaticamente.
Exportar Calendário para Canal OTA
Para partilhar a disponibilidade do AlojaPT com um canal OTA (fluxo inverso):
Obter a URL iCal do AlojaPT
No Channel Manager, seleccione o canal e a propriedade. Copie a URL iCal do AlojaPT apresentada.
Configurar no canal OTA
Cole essa URL nas definições de calendário do canal OTA, no campo "Importar calendário externo" ou equivalente.
Cada propriedade tem uma URL iCal única e permanente. Não é necessário actualizar esta URL nos canais OTA, salvo se eliminar e recriar a propriedade.
Forçar Sincronização Manual
A sincronização automática ocorre a cada 15 minutos. Para forçar uma sincronização imediata:
- No Channel Manager, localize o canal pretendido.
- Clique no ícone de refresh (⟳) ao lado do canal.
- O sistema executa a sincronização imediatamente.
- Aguarde até 30 segundos para ver o resultado.
Desactivar e Reactivar Canal
- Na lista de canais, clique no canal pretendido.
- Clique em "Desactivar" — o canal fica em pausa mas a URL iCal continua válida.
- Para reactivar, clique em "Activar".
Erros Comuns
| Erro | Causa | Solução |
|---|---|---|
| "URL iCal inválida" | URL expirada ou incorrecta | Gere uma nova URL no canal OTA |
| "Erro de sincronização" | Canal inacessível temporariamente | Aguarde 15 min; se persistir, verifique a URL |
| "Overbooking detectado" | Reserva conflituante importada | Cancele uma das reservas conflituantes manualmente |
| "Limite de canais atingido" | Plano não permite mais canais | Faça upgrade do plano ou remova um canal existente |