Centro de Ajuda
Integrações do chatbot

Integração com o Hotres

Última atualização:

Ligue o seu chatbot ChatLab ao sistema de reservas Hotres para fornecer informações de disponibilidade de apartamentos em tempo real e hiperligações de reserva diretamente no chat.

Nota: A integração com o Hotres está disponível mediante pedido. Se não vir a opção Hotres no seu separador Connect (Ligar), contacte o suporte para que seja ativada na sua conta.

O que a integração oferece

Get Apartments - Os clientes podem perguntar sobre os quartos e apartamentos da sua propriedade. O chatbot obtém uma lista completa a partir do Hotres, incluindo:

  • Nome e descrição do apartamento/quarto
  • Imagem e hiperligação direta para a página do apartamento

Check Apartment Availability - Os clientes podem verificar se um apartamento específico está disponível para determinadas datas. O chatbot devolve:

  • Estado de disponibilidade e preços
  • Indicador de oferta especial quando a tarifa difere da sua lista de preços principal
  • Apartamentos alternativos com intervalos de datas sugeridos caso o apartamento pretendido esteja indisponível ou tenha requisitos de estadia mínima
  • Hiperligação de reserva com as datas pré-preenchidas

Find Available Apartments - Os clientes podem procurar apartamentos disponíveis indicando um intervalo de datas e o número de hóspedes. O chatbot devolve:

  • Todos os apartamentos disponíveis para as datas especificadas com os respetivos preços
  • Indicador de oferta especial para tarifas com desconto
  • Hiperligações de reserva para cada apartamento disponível
  • Se nenhum apartamento estiver disponível para as datas exatas, opções alternativas com intervalos de datas sugeridos que cumpram os requisitos de estadia mínima

Pré-requisitos

Antes de começar, recolha as seguintes informações da sua conta Hotres:

  1. API Key - A sua chave de autenticação da API Hotres

  2. Object ID - O identificador da sua propriedade no Hotres

  3. Main Pricelist Name - O nome exato da sua lista de preços principal no Hotres

  4. Booking URL Format - O padrão de URL para a sua página de reservas, utilizando estes marcadores de posição:

    • {DATE_FROM} - Data de check-in
    • {DATE_TO} - Data de check-out
    • {TAG} - Identificador do apartamento/quarto

    Formato de exemplo:

    https://yourdomain.com/booking?checkin={DATE_FROM}&checkout={DATE_TO}&apt={TAG}
    

Passo 1: Ligar o Hotres no ChatLab

  1. Inicie sessão no ChatLab e selecione o seu bot
  2. Aceda ao separador Connect (Ligar)

Separador Connect a apresentar o mosaico de integração do Hotres

  1. Clique em Connect (Ligar) no mosaico do Hotres
  2. Preencha os quatro campos obrigatórios: API Key, Object ID, Main Pricelist Name e Booking URL format

Formulário de integração do Hotres com os detalhes de ligação

  1. Clique em Connect (Ligar)

O ChatLab testa automaticamente a ligação consultando a sua propriedade no Hotres. Se a API key ou o Object ID estiverem incorretos, verá uma mensagem de erro. Em caso de sucesso, surge uma caixa de diálogo de confirmação com a opção de configurar ações de IA.

Passo 2: Configurar as ações do Hotres

Após estabelecer a ligação, ative e personalize as ações individuais de IA. Navegue até Settings > Actions (Definições > Ações) e filtre pela plataforma Hotres.

Ações do Hotres em Settings a mostrar as três ações disponíveis

Estão disponíveis três ações:

  • Hotres - get apartments - lista todos os quartos e apartamentos da sua propriedade
  • Hotres - check apartment availability - verifica um apartamento específico para determinadas datas
  • Hotres - find available apartments - pesquisa apartamentos disponíveis por intervalo de datas e número de hóspedes

Clique no botão de ativação em cada ação para a ativar. Pode personalizar:

  • Action Label - a mensagem apresentada aos utilizadores enquanto a ação é executada (por exemplo, "A verificar disponibilidade...")
  • Instructions - orienta a IA sobre quando e como utilizar a ação
  • User Instructions - regras de negócio adicionais ou preferências para a IA

Testar a sua integração

Depois de ativar as ações, abra o widget do seu chatbot e experimente:

  • "Que apartamentos têm?" (testa o Get Apartments)
  • "O apartamento 101 está disponível de 15 a 20 de dezembro?" (testa o Check Apartment Availability)
  • "O que está disponível de 15 a 20 de dezembro para 2 hóspedes?" (testa o Find Available Apartments)

Verifique se as respostas coincidem com os dados do seu Hotres e se as hiperligações de reserva abrem corretamente com as datas pré-preenchidas.

Gerir a integração

Atualizar definições - Clique no mosaico do Hotres no separador Connect (Ligar), atualize qualquer campo e clique em Update Chatbot (Atualizar Chatbot).

Desligar - Clique no mosaico do Hotres e, em seguida, clique em Disconnect (Desligar). Esta ação desativa todas as ações de IA do Hotres. A sua configuração fica guardada e pode voltar a ligá-la mais tarde.

Dicas

  • Treine o seu bot com descrições detalhadas da propriedade, comodidades e informações de localização para que a IA possa fornecer contexto juntamente com os dados de disponibilidade.
  • Adicione perguntas sugeridas como "Verificar disponibilidade" ou "Mostrar apartamentos" para orientar os visitantes.
  • Se tiver políticas de reserva (estadia mínima, regras de cancelamento), adicione-as às instruções da ação para que a IA as mencione automaticamente.