Integração com Cloudbeds
A HiLucy possui uma integração profunda e nativa com o Cloudbeds — um dos principais Sistemas de Gestão de Propriedades para hotéis e aluguéis por temporada.
O Que é Sincronizado
| Dados | Direção | Frequência | |-------|---------|------------| | Reservas | Cloudbeds → HiLucy | A cada 15 minutos (cron) | | Detalhes do hóspede | Cloudbeds → HiLucy | A cada sincronização de reserva | | Atribuição de quartos/unidades | Cloudbeds → HiLucy | A cada sincronização de reserva | | Status de check-in/checkout | Cloudbeds → HiLucy | Em tempo real via webhook |
Etapas de Configuração
1. Conectar via OAuth
No painel administrativo da HiLucy:
- Acesse Configurações → Integrações → Cloudbeds
- Clique em Conectar Cloudbeds
- Faça login na sua conta Cloudbeds e autorize a HiLucy
A conexão OAuth atualiza os tokens automaticamente, então você nunca precisa reconectar.
2. Mapear Suas Propriedades
Após conectar, mapeie suas propriedades do Cloudbeds para os listings da HiLucy. Cada ID de propriedade do Cloudbeds é vinculado a um listing da HiLucy.
3. Sincronização Inicial
A HiLucy executa uma sincronização completa inicial de todas as reservas. Isso normalmente leva de 2 a 5 minutos, dependendo do volume de reservas.
4. Verificar
Confira a página de Reservas no painel administrativo. Você deve ver todas as suas reservas do Cloudbeds com:
- Nomes dos hóspedes e informações de contato
- Datas e atribuições de quartos
- Status da reserva
Sistema Dual-Write
A HiLucy utiliza uma arquitetura de dual-write para máxima confiabilidade:
- As reservas são gravadas tanto na tabela de sincronização legada quanto nas novas tabelas normalizadas
- Isso garante compatibilidade retroativa enquanto habilita novos recursos
- O sistema resolve conflitos automaticamente
Monitoramento
A sincronização roda a cada 15 minutos via cron do WordPress. Ela só gera logs quando há alterações (synced > 0, updated > 0 ou errors > 0), mantendo seu log de debug limpo.
Solução de Problemas
Reservas não estão sincronizando?
- Verifique se a conexão OAuth ainda está ativa em Configurações
- Confirme se o mapeamento de propriedades está correto
- Verifique o log de debug do WordPress para erros de sincronização
Informações de contato do hóspede ausentes?
Algumas reservas via OTA (ex.: Booking.com) não compartilham e-mail/telefone do hóspede. Esses hóspedes serão sincronizados sem informações de contato até que as forneçam diretamente.