Visão Geral
Se você está usando um aplicativo do Marketplace da Cloudbeds (como um provedor de check-in automático, Gerenciador de Canais ou sistema de contabilidade) e está enfrentando falhas na sincronização de dados, erros de autenticação ou informações ausentes, a principal causa pode ser um token de acesso/atualização expirado ou ausente.
Esses tokens são essenciais para o aplicativo comunicar de forma segura com a plataforma da Cloudbeds; quando expiram ou se tornam inválidos, a conexão é interrompida.
Este artigo orienta você a reautorizar o aplicativo, testar a conexão e coletar detalhes para o Suporte se precisar de mais ajuda.
Manifestações mais comuns
- A funcionalidade integrada do aplicativo (p. ex., fluxo de check-in, sincronização de reservas, relatórios) falha ou não é acionada.
- O aplicativo relata uma falha de autenticação, problema com o token ou erro de "não autorizado".
- Não parece estar ocorrendo sincronização de novos dados do sistema da Cloudbeds, apesar do uso bem-sucedido anterior.
- Mensagens de erro específicas do sistema parceiro, como:
- HTTP 401:
{ "error": "server_error", "error_description": "O código de autorização é inválido ou expirou." } - HTTP 200:
{ "success": false, "message": "O usuário que aprovou esta conexão não está mais ativo" }
- HTTP 401:
Passos para a Solução
Passo 1: Reautorizar o aplicativo para gerar um novo token
Os tokens de acesso e atualização são gerados apenas durante a conexão inicial ou reautorização. Se um token for perdido ou expirar, a solução mais rápida é desconectar e reconectar o aplicativo em sua conta da Cloudbeds. Esse processo emite um novo token de acesso e atualização válido.
- Acesse seu Menu da Conta
→ Aplicativos e Marketplace
→ Aplicativos Conectados;
- Localize o aplicativo problemático na lista (p. ex., Trevo, Sweeply);
- Clique em Desconectar, depois confirme a ação;
- Clique em Conectar e siga as etapas de autorização na tela específicas para aquele aplicativo. Isso geralmente envolve fazer o logon na plataforma do parceiro ou confirmar permissões.
Esse processo força a Cloudbeds a emitir um novo token de acesso e atualização completamente novo.
Passo 2: Testar a conexão
- Abra um caso de teste relevante no PMS da Cloudbeds (p. ex., uma reserva de teste para um aplicativo de check-in automático ou acione uma sincronização de dados para um aplicativo de relatórios);
- Execute o fluxo ou ação que falhou anteriormente (p. ex., iniciar check-in, forçar uma sincronização);
- Verifique se é concluído sem erros e se os dados estão sendo sincronizados conforme o esperado.
Isso garante que o novo token seja válido e esteja funcionando conforme o esperado.
Passo 3: Se o problema persistir
Se reautorizar não resolver o problema, entre em contato com o Suporte da Cloudbeds e inclua os seguintes detalhes:
- Sua ID da Propriedade na Cloudbeds.
- A data e hora aproximadas em que você reautorizou o aplicativo.
- Um número de reserva recente (ou outra ID relevante) onde o problema ocorreu após a reconexão.
Também peça à equipe de suporte do parceiro (p. ex., Suporte do Trevo, Suporte do Sweeply) para fornecer:
- Registros (logs) de solicitação e resposta da API mostrando o uso do token falhou ou mensagens de erro. Esses registros ajudam a Equipe de Integrações da Cloudbeds a identificar o problema.
Perguntas Frequentes
Por que os tokens do Marketplace da Cloudbeds expiram ou desaparecem?
Os tokens de acesso e de atualização podem expirar após inatividade ou redefinições de segurança. Eles também são invalidados se o usuário da Cloudbeds que autorizou originalmente a conexão se tornar inativo. Reconexão com um usuário ativo é necessária nesses casos.
A expiração do token afeta outras integrações na plataforma da Cloudbeds ou aplicativos conectados?
Sim. O mesmo processo de solução de problemas de desconexão e reconexão se aplica à maioria dos outros aplicativos do Marketplace da Cloudbeds que usam autenticação baseada em token (OAuth 2.0). Se um parceiro relatar erros como "O código de autorização é inválido ou expirou" ou "O usuário que aprovou esta conexão não está mais ativo", geralmente é necessária uma reautorização
Existem integrações que utilizem um método de autenticação diferente dos tokens do Marketplace da Cloudbeds?
Sim, algumas integrações podem ter métodos de autenticação diferentes. Por exemplo, as integrações da Omniboost são tratadas de forma diferente. Sempre consulte guias de integração específicos ou consulte o Suporte da Cloudbeds se não tiver certeza.
O que significa a mensagem de erro “O ConnectionTokenProvider do seu aplicativo não acionou o bloco de conclusão fornecido em 60 segundos” no aplicativo da Cloudbeds?
Esta mensagem aparece quando o aplicativo da Cloudbeds para dispositivos móveis tenta se conectar aos servidores, mas leva mais de 60 segundos para concluir o processo de conexão segura. Isso geralmente acontece durante o uso de um leitor de pagamentos (como Stripe ou Cloudbeds Payments) e é frequentemente causado por um sinal de rede fraco, atraso temporário do servidor ou problema de conexão do leitor.
Abaixo há um exemplo de como o erro aparece no aplicativo:
Possíveis causas
- Conexão Wi-Fi/celular instável ou fraca.
- O aplicativo foi minimizado ou interrompido durante o processo de conexão.
- O leitor de pagamentos perdeu a conexão ou não foi emparelhado corretamente.
- Atraso temporário na geração do token de conexão no lado do servidor.
Etapas para solução
- Feche e reabra o aplicativo da Cloudbeds para dispositivos móveis.
- Certifique-se de que o dispositivo tenha um sinal Wi-Fi ou celular forte e tente novamente.
- Verifique se o leitor de pagamentos está ligado e emparelhado corretamente.
- Atualize o aplicativo da Cloudbeds para a versão mais recente.
Se o problema persistir após essas etapas, entre em contato com o suporte da Cloudbeds e inclua a versão do aplicativo, o modelo do leitor e quando o erro ocorreu para que nossa equipe possa ajudar.
Se precisar de mais assistência ou informações, nossa Equipe de Suporte está aqui para ajudar.
Comentários
Por favor, entre para comentar.