Guesty
Integração
Inicie a integração iniciando sessão na sua conta Guesty em https://app.guesty.com/auth/login.
Depois de iniciar sessão, no canto superior direito do ecrã, abra o menu “Integrations” e selecione “Marketplace”.
Na barra de pesquisa do Marketplace, escreva Tedee e selecione a integração Tedee nos resultados filtrados.
Clique no botão “Connect” no lado direito do ecrã.
A plataforma Guesty irá então gerar a sua chave API exclusiva — um código necessário para a integração entre as plataformas Guesty e Tedee.
Dispõe agora de 3 horas para configurar a integração no Tedee Portal. Copie a chave API do Guesty para a área de transferência do seu computador.
Nota: Se precisar de aceder novamente à chave API do Guesty durante estas 3 horas após a gerar, clique em “View API key (integration token)” para a voltar a ver.
Se não conseguir integrar as plataformas no prazo de 3 horas, clique em “Disconnect” e, em seguida, em “Connect” novamente para gerar um novo código, válido pelas próximas 3 horas.
Também pode desligar as plataformas a qualquer momento e desativar a automação de gestão de acessos.
Depois de gerar a sua chave API do Guesty, vá ao Tedee Portal em https://portal.tedee.com e inicie sessão com a sua conta Tedee.
Depois, no menu da barra lateral esquerda, selecione a opção “Short-term rentals” e escolha “Guesty”.
No menu da barra lateral, cole a chave API do Guesty gerada anteriormente e clique em “Connect”.
O Guesty e o Tedee irão agora integrar-se e sincronizar as suas listagens de arrendamento.
Será redirecionado para a vista “Accommodations”. Todos os alojamentos serão automaticamente sincronizados a partir da plataforma de arrendamento de curta duração.
Página “Accommodations”
A página “Accommodations” lista todos os apartamentos de arrendamento sincronizados do utilizador, em todos os serviços de arrendamento ligados.
O separador “Accommodations” contém propriedades que foram corretamente associadas ao sistema Tedee. Isto significa que estão prontas para aceitar novas reservas e que a automação está a funcionar corretamente.
| Nome | Ação | |
| 1 | Ícone para mostrar/ocultar a barra de filtros | Mostra/oculta a barra de filtros |
| 2 | Botão de sincronização manual | Permite forçar a sincronização do seu alojamento com um fornecedor de serviços de reservas ligado |
| 3 | Filtrar por palavra-chave | Mostra todos os alojamentos filtrados pela palavra-chave selecionada |
| 4 | Filtrar por automação | Filtra a lista por alojamentos automatizados/não automatizados |
| 5 | Filtrar por plataforma | Filtra a lista por plataformas de arrendamento ligadas |
| 6 | Coluna do nome do apartamento | O nome do apartamento sincronizado a partir da integração de arrendamento de curta duração. Recomenda-se que os nomes dos alojamentos sejam diferentes — isto tornará todo o processo mais fácil de gerir |
| 7 | Coluna da fechadura | Nome da fechadura associada ao apartamento |
| 8 | Coluna da plataforma | Logótipo da plataforma de arrendamento de curta duração à qual o apartamento está associado |
| 9 | Nome do apartamento | Nome do apartamento associado à fechadura |
| 10 | Menu de contexto | Mostrar o menu de contexto do alojamento selecionado |
| 11 | Editar alojamento | Abre a barra lateral com o alojamento selecionado, onde os utilizadores podem sincronizar ou editar as propriedades do alojamento |
| 12 | Mostrar reservas | Redireciona o utilizador para a vista de reservas do apartamento selecionado |
| 13 | Opção “Load more” | Se existirem mais registos, deverão aparecer após fazer scroll |
| 14 | Limpar todos os filtros | Repor o estado de todos os filtros selecionados |
Vista “No bookings found”
A vista “Accommodations” pode filtrar dados por duas colunas: Nome do apartamento e Plataforma.
O utilizador pode filtrar de duas formas:
- selecionar a opção “Filter by name”
- selecionar “Platform” e clicar num sistema de gestão de canais na lista pendente
O principal objetivo da sincronização é manter o mesmo estado na plataforma de arrendamento de curta duração e no Tedee Portal.
Do ponto de vista do utilizador do Tedee Portal, o processo de sincronização dos alojamentos é simples. Atualiza a lista de alojamentos disponíveis a partir da plataforma de arrendamento de curta duração para o Tedee Portal. Depois de clicar no botão “Sync”, o processo de sincronização é iniciado. O sistema Tedee deve refletir todas as atualizações efetuadas na plataforma de arrendamento de curta duração. Por exemplo, todos os alojamentos eliminados devem desaparecer da lista no Tedee Portal e os alojamentos recém-criados devem aparecer no seu lugar.
Definições de automação de arrendamento
Depois de clicar na linha com o nome da instalação, aparecerá um painel no lado direito do ecrã. Contém as definições de automação de arrendamento que o utilizador pode modificar.
As opções de arrendamento que o utilizador pode alterar são:
- Associar/desassociar o arrendamento e a smart lock. A associação da smart lock é obrigatória para que a automação entre o sistema de gestão de canais e o sistema Tedee funcione corretamente. O utilizador só verá as fechaduras que possui. Para associar a fechadura ao alojamento, esta deve estar emparelhada com a bridge e o keypad.
- Quantos dias antes do início da reserva o hóspede deve receber os dados de acesso.
- Gestão de notificações.
Desassociar a fechadura do sistema de arrendamento cancela todas as reservas e o acesso concedido para essas reservas.
| Nome | Ação | |
| 1 | Nome do alojamento | Nome do alojamento sincronizado a partir do sistema de arrendamento de curta duração (campo só de leitura) |
| 2 | Smart lock associada | O nome da smart lock atribuída ao alojamento |
| 3 | Secção de dias antes da reserva para conceder acesso | O número de dias antes do qual os hóspedes irão receber acesso à fechadura a partir do sistema Tedee |
| 4 | Notificações do proprietário | Opções de notificações do proprietário |
| 5 | Notificações do hóspede | Opções de notificações do hóspede |
| 6 | Botão “Apply” ou “Cancel” | O utilizador pode aceitar as alterações introduzidas clicando em “Apply” e descartá-las clicando em “Cancel” |
Página “Bookings”
O separador “Bookings” apresenta todas as reservas efetuadas pelos hóspedes (utilizadores externos da plataforma de arrendamento de curta duração).
A vista de reservas permite verificar se a automação está a funcionar corretamente, o estado da reserva, se o utilizador entrou com sucesso no alojamento e se a reserva foi concluída.
Os utilizadores do portal podem ver os detalhes de acesso por PIN e atualizá-los.
Embora o sistema sincronize automaticamente a lista de reservas com as plataformas de arrendamento, os utilizadores podem forçar a sincronização manualmente se notarem que os dados estão desatualizados.
| Nome | Ação | |
| 1 | Botão de sincronização manual | Permite forçar a sincronização do seu alojamento com um fornecedor de serviços de reservas ligado |
| 2 | Ícone para mostrar/ocultar a barra de filtros | Mostra/oculta a barra de filtros |
| 3 | Filtrar por palavra-chave | Mostra todas as reservas cujas colunas ID/e-mail correspondem à palavra-chave |
| 4 | Seleção de alojamento | Mostra todas as reservas para um item de arrendamento selecionado |
| 5 | Coluna Booking ID | Booking ID da plataforma externa de arrendamento de curta duração |
| 6 | Coluna do hóspede | E-mail do hóspede |
| 7 | Coluna do apartamento | Nome do apartamento onde a reserva é criada |
| 8 | Coluna de início da reserva | Data de check-in — o acesso ao sistema Tedee começará a partir desta data |
| 9 | Coluna de fim da reserva | Data de check-out — após esta data, o acesso ao sistema Tedee termina |
| 10 | Barra de estado | Mostra uma barra de estado com informações sobre o estado atual da reserva |
| 11 | Opções “Load more” | Se existirem mais registos, deverão aparecer após fazer scroll |
Barra de estado
| Nome | Ação | |
| 1 | Etapa do agendamento da automação | Apresenta informações sobre o agendamento da automação.
Estão disponíveis dois estados:
|
| 2 | Etapa de concessão de acesso | Apresenta informações detalhadas sobre o estado do acesso concedido.
Estão disponíveis três estados:
A concessão de acesso pode falhar devido a três erros:
Se ocorrer um erro, a aplicação agendará automaticamente a próxima tentativa de ligação (apresentará a data da próxima tentativa). Quando for atingido o número máximo de tentativas, o sistema deixará de executar esta ação e ocultará a informação sobre a próxima tentativa. |
| 3 | Etapa de check-in | Apresenta informações sobre se o cliente efetuou o check-in.
Estão disponíveis dois estados:
|
Concessão automática de acesso
A concessão automática de acesso começa quando é criada uma nova reserva na plataforma de arrendamento de curta duração. Toda a automação baseia-se na configuração escolhida pelo utilizador.
Note que o acesso à fechadura Tedee não é criado ao mesmo tempo que a reserva é efetuada.
O processo de concessão automática de acesso é o seguinte:
- O sistema Tedee recebe informações sobre uma nova reserva criada no sistema de gestão de canais.
- As informações da reserva são guardadas no sistema Tedee.
- O proprietário ou administrador da fechadura define o momento em que o visitante recebe os dados de acesso.
- Um número selecionado de dias antes do início da reserva, o hóspede recebe informações de acesso à fechadura Tedee — os detalhes de acesso são enviados automaticamente por e-mail. Eis um modelo de mensagem de exemplo:
- O proprietário da fechadura pode ativar notificações para a primeira vez que o hóspede destranca a porta — assim, fica a saber a data exata do check-in.
- No check-out, o hóspede perde o acesso ao alojamento e não pode voltar a usar o seu PIN.
Edição da chave API do sistema de gestão de canais
A edição da chave API do sistema de gestão de canais permite ao utilizador atualizar a integração quando a chave anterior expirou ou quando um serviço foi desligado devido a um erro não especificado. Esta ação pode ser efetuada na vista de gestão de ligações — a lista de serviços de arrendamento ligados deverá estar visível no topo da barra lateral. Para abrir a página de edição, clique no ícone de três pontos no canto superior direito (1) e selecione Manage connections > ícone de engrenagem. Depois de colar a chave (2), conclua o processo clicando em Apply (3).
Desvincular o sistema de gestão de canais da conta Tedee
Ao desvincular as contas, todos os alojamentos relacionados associados ao Tedee Portal serão removidos automaticamente. Para isso, vá a Accommodations > Manage connections, clique no ícone do caixote do lixo junto ao logótipo do sistema de gestão de canais e confirme a eliminação.
Cancelamento de acesso
O cancelamento de acesso ocorre sempre que uma reserva é removida do sistema Tedee.
Isto acontece quando:
- A reserva na plataforma de arrendamento de curta duração é cancelada.
- A reserva na plataforma de arrendamento de curta duração é concluída.
- O alojamento na plataforma de arrendamento de curta duração é eliminado.
- A fechadura Tedee é desvinculada do alojamento.
O processo de cancelamento automático do acesso é o seguinte:
- Ocorre uma das situações acima.
- As informações da reserva são eliminadas do sistema Tedee.
- Se o acesso a uma fechadura Tedee estiver apenas agendado e pendente, é cancelado.
- Se o acesso à fechadura Tedee já tiver sido concedido, é revogado.
