Perguntas Frequentes sobre Integrações

Respostas para as perguntas mais comuns sobre as integrações do HiLucy com sistemas de gestão de propriedades, CRMs e serviços de terceiros.

Problemas de Conexão

Como verifico se uma integração está conectada?

Vá em Configurações -> Integrações no seu administrador WordPress. Cada integração mostra seu status de conexão. Para integrações baseadas em OAuth (Cloudbeds, Monday.com), você verá um indicador verde "Conectado" quando o token for válido. Para integrações baseadas em API key (GoHighLevel, Stripe), a página de configurações mostra o resultado da última sincronização.

Uma integração parou de funcionar repentinamente. O que devo fazer?

Siga estes passos em ordem:

1. Verificar credenciais -- API keys podem expirar ou ser revogadas. Visite o painel do serviço terceiro para verificar se sua chave ainda está ativa
2. Reautorizar OAuth -- Para Cloudbeds e Monday.com, tente desconectar e reconectar pelo fluxo OAuth
3. Verificar o log de debug -- Vá em wp-content/debug.log no seu servidor e busque pelo nome da integração
4. Verificar limites de taxa -- Se você vê erros 429 (Too Many Requests), a API terceira está limitando suas solicitações. Aguarde alguns minutos e tente novamente
5. Contatar suporte -- Se nada acima resolver o problema, entre em contato com a equipe HiLucy com os detalhes do erro

Posso conectar múltiplas propriedades à mesma conta de integração?

Sim. Para Cloudbeds, cada propriedade é mapeada individualmente após conectar sua conta. Para GoHighLevel, use uma API key no nível de localização limitada à sub-conta correta. Para Stripe, todas as propriedades compartilham uma única conta Stripe.

Solicitar Novas Integrações

Meu PMS não está listado. O HiLucy pode integrar com ele?

O HiLucy é projetado para funcionar com qualquer PMS que ofereça uma API. Se seu PMS não é suportado atualmente, você pode solicitar uma integração. Consulte Solicitar Integração PMS para detalhes.

Quais integrações PMS estão disponíveis atualmente?

O HiLucy atualmente tem integrações nativas com:

• Cloudbeds -- Sincronização completa de reservas com arquitetura de escrita dual
• Acuity Scheduling -- Sincronização de reservas de atividades e agendamentos

Integrações PMS adicionais são construídas sob demanda baseado na demanda dos clientes.

API e Limites de Taxa

O HiLucy respeita os limites de taxa das APIs terceiras?

Sim. O HiLucy implementa deduplicação e throttling para evitar atingir limites de taxa. Por exemplo, a integração GoHighLevel rastreia quais combinações de pedido/status já foram sincronizadas e pula duplicatas. A sincronização do Cloudbeds roda em ciclo cron de 15 minutos em vez de tempo real para ficar dentro das cotas da API.

Posso acionar uma sincronização manual?

Para Cloudbeds, a sincronização roda automaticamente a cada 15 minutos. Se você precisa dos dados antes, pode acionar uma sincronização manual pelo administrador WordPress visitando a página de configurações da integração. Para GoHighLevel, sincronizações são orientadas por eventos (acionadas por eventos de pedidos WooCommerce), então não há acionamento manual -- simplesmente re-salve o pedido para reativar os hooks.

Quantos dados são enviados para serviços terceiros?

O HiLucy envia apenas os dados necessários para a integração funcionar:

• Cloudbeds -- Puxa dados de reservas e hóspedes; não envia dados de volta
• GoHighLevel -- Envia informações de contato do hóspede, itens de pedido, totais e cupons
• Monday.com -- Envia detalhes de tarefas (título, descrição, categoria, prioridade)
• Stripe -- Dados de pagamento são tratados inteiramente pela tokenização segura do Stripe; números de cartão nunca tocam os servidores do HiLucy

Segurança

As API keys são armazenadas com segurança?

API keys e tokens OAuth são armazenados na tabela de opções do WordPress, protegida pelas credenciais do banco de dados e autenticação do WordPress. Chaves nunca são expostas no frontend ou incluídas em respostas da API.

Os dados são criptografados em trânsito?

Toda comunicação com serviços terceiros usa HTTPS (TLS 1.2 ou superior). Nenhum dado é enviado por conexões não criptografadas.