Recurso Premium

As integrações são um recurso disponível apenas para utilizadores nos planos Premium e Business Pro.

 

O que faz a integração?


O Hostaway é um software de gestão de propriedades para alojamentos de férias e Airbnbs. A utilização da integração do Hostaway com a Keycafe permite que os códigos de acesso e as instruções das chaves sejam criados e enviados automaticamente aos seus hóspedes quando uma reserva é criada no Hostaway.

 

Como configurar a integração


1. Gerar uma chave de API do Hostaway

  1. Siga os passos do Hostaway para criar uma chave de API.

  2. Tome nota tanto do Account ID quanto da API Key.

API secret key generated successfully.png

2. Vincular as suas contas

  1. No seu painel Keycafe, selecione +Adicionar → Integração → Hostaway.

  2. Introduza o seu Hostaway Account ID e a Hostaway API key e, em seguida, clique em Enviar

Adicionar Webhook ao Hostaway


Assim que concluir a configuração da integração, receberá um e-mail com um URL de webhook.

  1. Copie o URL.

  2. No seu painel Hostaway, selecione Settings → Integrations e desça até Unified webhooks.

  3. Em Add Webhook, cole o URL e certifique-se de que Is enbaled está definido como Yes; em seguida, clique em +Add.

 

Associar uma chave Keycafe ao seu anúncio do Hostaway


Adicionar a etiqueta Keycafe ao anúncio no Hostaway

Para cada anúncio do Hostaway que deseje incluir na integração com a Keycafe, deve ser adicionada uma etiqueta "Keycafe" nos detalhes do anúncio. Os anúncios sem a etiqueta adicionada não terão reservas criadas automaticamente na Keycafe.

  1. No seu painel Hostaway, selecione Listings → Details → Edit.

  2. No campo Tags, introduza a etiqueta "Keycafe".

image.jpg

 

Etiquetas úteis adicionais

A etiqueta "Keycafe" pode ser editada para incluir algumas configurações adicionais para a sua integração:

  • -sn (Suprimir notificações): Se preferir enviar apenas um e-mail ao seu hóspede com o código de acesso e as instruções da chave através do Hostaway, pode desativar o e-mail automático da Keycafe adicionando "-sn" à etiqueta. A etiqueta completa passa a ser "Keycafe-sn".

  • -dc (Código da porta): Se desejar guardar automaticamente o código de reserva Keycafe da chave no campo Door Code da reserva no Hostaway, adicione "-dc" à etiqueta. A etiqueta completa passa a ser "Keycafe-dc". Tenha em atenção que, se esta etiqueta for adicionada e introduzir manualmente um código de porta ao criar uma reserva no Hostaway, este será substituído pelo código de reserva Keycafe.

Adicionar ambas as etiquetas

Se desejar suprimir as notificações e guardar automaticamente o código de reserva no campo do código da porta, pode utilizar a etiqueta "Keycafe-sn-dc" ou "Keycafe-dc-sn".

 

Adicionar o número de ID do anúncio à chave na Keycafe

O seu Listing ID do Hostaway é utilizado para identificar a chave associada na Keycafe. Se tiver vários anúncios e várias chaves, este processo deve ser efetuado para cada par.

  1. No seu painel Hostaway, selecione Listings e copie o Listing ID Number.

Screenshot 2024-12-13 at 3.44.09 PM.png
  1. No seu painel Keycafe, selecione Chaves e, em seguida, a chave para o anúncio. Se ainda não tiver criado a chave para o anúncio, consulte Adicionar uma chave para o fazer.

  2. Selecione Sobre a chave → Editar, introduza o Listing ID Number do passo 1 no campo Notas internas e clique em Guardar.

Screenshot 2025-01-27 at 5.19.24 PM.jpg

 

Utilizar a integração


Assim que uma reserva de hóspede for criada no Hostaway, será gerada automaticamente uma reserva única na Keycafe para a chave associada com a mesma data/hora de início e de fim da reserva. Quaisquer alterações à reserva no Hostaway serão refletidas na reserva Keycafe, incluindo o cancelamento da reserva. Aguarde 1 a 2 minutos para que as novas reservas e alterações apareçam na reserva Keycafe.

O código de reserva para aceder à chave na sua SmartBox é então enviado automaticamente ao hóspede por e-mail.

Localização da SmartBox

Tenha em atenção que o e-mail não especifica onde a sua SmartBox está localizada, pelo que terá de informar o seu hóspede separadamente sobre a sua localização.

 

Desconectar a sua conta Hostaway


  1. No seu painel Keycafe, selecione Integrações → Hostaway → Sobre a integração → Desconectar.

  2. Clique em Desconectar para confirmar.

 

Mais assistência


Tem dúvidas sobre a integração ou sugestões de melhorias? Envie-nos um e-mail para support@keycafe.com.