Visão geral
Ao abrir uma página de Integração do Marketplace no Guesty para uma integração já conectada, você verá um botão com o rótulo "Exibir chave de API (token de integração)". Clicar nesse botão exibe o último token gerado para essa integração.
Este artigo explica para que serve este token, por que ele expira e o que fazer se você precisar gerar um novo.
Para que serve o token de integração?
O token de integração (chave de API) é usado apenas para a conexão/autorização inicial entre a Guesty e a plataforma do parceiro. Uma vez que a integração tenha sido estabelecida com sucesso usando este token, sua função está concluída - ele não é usado para manter a integração em funcionamento contínuo.
Por que o token expira após 4 horas?
Por motivos de segurança, cada token de integração expira automaticamente 4 horas após ser gerado. Esse período de 4 horas permite que você copie o token e o insira no sistema do parceiro para concluir a conexão.
Se você visualizar o token após esse período de 4 horas, verá uma mensagem indicando que o token expirou.
Importante: Um token expirado não significa que sua integração esteja desconectada ou não esteja funcionando. Significa simplesmente que esse token específico não é mais válido e não pode ser usado/não será aceito novamente pelo Parceiro — isso não afeta a conexão ativa atual entre a Guesty e o Parceiro.
Quando é que eu precisaria de um novo token?
Você só precisa gerar um novo token de integração se estiver enfrentando um problema de conexão ativo - por exemplo:
- Você está configurando a integração pela primeira vez e ainda não terminou de inserir o token no lado do parceiro, ou
- O painel de controle do parceiro exibe uma mensagem que a integração está desconectada ou que uma nova chave de API é necessária.
Se a sua integração estiver funcionando normalmente, um token expirado exibido nesta página não requer nenhuma ação.
Uma integração é considerada conectada no Guesty se exibir o status "Conectado" no Guesty Marketplace.
Como gerar um novo token de integração
Caso precise de um novo token, siga estes passos:
- Acesse a página de integração correspondente no Guesty.
- Clique em Desconectar.
- Na janela pop-up, marque a caixa para confirmar que leu a mensagem > clique em Desconectar
- Atualize a página completamente.
- Clique em Conectar. Isso fará com que o Guesty gere um novo token de integração.
- Copie o novo token e insira-o no campo apropriado no aplicativo do parceiro ou compartilhe-o com a equipe de suporte do parceiro, conforme necessário.
Observação: o novo token também expirará 4 horas após ser gerado, portanto, recomendamos concluir a conexão no lado do parceiro o mais rápido possível após a geração.