Ligue o seu chatbot ChatLab ao seu sistema de gestão hoteleira (PMS) KWHotel para fornecer disponibilidade de quartos em tempo real, reservas e consulta de reservas aos visitantes do seu site. A integração utiliza o motor de reservas GuestSage para os dados de quartos e disponibilidade, e a KWHotel Integrations API para a consulta de reservas.
O que a integração oferece
Com a integração KWHotel ativada, o seu chatbot pode:
- Listar tipologias de quartos com descrições, capacidade, área e fotografias
- Encontrar quartos disponíveis para um determinado intervalo de datas com preços
- Verificar a disponibilidade para um quarto específico e intervalo de datas
- Criar novas reservas com os dados dos hóspedes
- Consultar reservas existentes
Pré-requisitos
Antes de configurar a integração, certifique-se de que tem:
- Uma conta KWHotel com o motor de reservas GuestSage ativado
- O seu Hotel ID (UUID) do motor de reservas GuestSage
- O seu Integrations Hotel ID (numérico) e a Integrations API Key emitidos pelo KWHotel
- Uma conta ChatLab num plano STANDARD ou PREMIUM, ou com o extra Travel Integrations
Como encontrar o seu Hotel ID (UUID)
O Hotel ID é um UUID atribuído ao seu alojamento no motor de reservas GuestSage.
- Inicie sessão em cloud.kwhotel.com
- Aceda a Modules (Módulos) > Booking Engine (Motor de reservas)
- No separador General (Geral), localize o campo Booking engine link (Ligação do motor de reservas)
- Copie o UUID do URL
Por exemplo, na ligação https://be.guestsage.com/en/82b0085d-da1b-4443-8fde-d5d569a859e6, o Hotel ID é 82b0085d-da1b-4443-8fde-d5d569a859e6.
Como encontrar as suas credenciais da Integrations API
A KWHotel Integrations API utiliza um identificador diferente do UUID do GuestSage:
- Integrations Hotel ID - um ID numérico (por exemplo,
292) - Integrations API Key - uma chave secreta que gera no KWHotel
Hotel ID numérico
Pode encontrar o Hotel ID numérico no canto superior direito do painel de administração do KWHotel.
Como gerar a chave de API
Gere a chave de API diretamente no KWHotel:
- Inicie sessão no KWHotel e abra o módulo Synchronization (Sincronização)
- Clique no botão Reset API key (Repor chave de API)
- Copie a chave gerada e cole-a no formulário de ligação do ChatLab
Clicar em Reset API key remove a chave anterior (caso já tenha sido gerada uma) e cria uma nova. Qualquer outro sistema que utilize a chave anterior deixará de funcionar até que o atualize com o novo valor.
Como configurar a integração no ChatLab
Passo 1: Aceder ao separador Connect
- Inicie sessão no painel de administração do ChatLab
- Selecione o bot que pretende configurar
- Aceda ao separador Connect (Ligar)
- Localize e clique em KWHotel na lista de integrações
Passo 2: Inserir os detalhes de ligação
Preencha o formulário de ligação:
- Hotel ID (UUID) - o GUID do seu hotel no KWHotel a partir da configuração do motor de reservas GuestSage
- Default Currency (Moeda predefinida) - a moeda utilizada para os preços apresentados aos utilizadores do chat (o valor predefinido é PLN)
- Default Language (Idioma predefinido) - o idioma utilizado para as descrições dos quartos e o texto das ofertas (o valor predefinido é polaco)
- Integrations Hotel ID - o ID numérico do hotel para a KWHotel Integrations API (diferente do UUID acima)
- Integrations API Key - a chave de API secreta emitida pelo KWHotel
- Discount bot channel (Canal de descontos do bot) - opcional. Quando definido, as ofertas são obtidas para este canal de descontos do KWHotel e ordenadas pela IA. Deixe em branco para utilizar o canal predefinido.
Passo 3: Ligar
- Assim que os campos estiverem preenchidos, o botão Connect (Ligar) fica ativo
- Clique em Connect para guardar a configuração. O ChatLab testa a ligação ao GuestSage e a ligação à Integrations API.
- Se a operação for bem-sucedida, verá uma notificação de confirmação.
Após uma ligação bem-sucedida, o botão Connect muda para Update Chatbot (Atualizar chatbot) e surge o botão Disconnect (Desligar), para que possa desativar a integração mais tarde.
Se a verificação da Integrations API falhar ao guardar, a ação Get reservation é desativada automaticamente. Introduza novamente as credenciais corretas e clique em Update Chatbot para a ativar.
Como configurar as ações de IA
Assim que a integração com o KWHotel estiver ligada, pode configurar quais as ações de IA que o seu chatbot pode executar.
Ações de IA disponíveis
- KWHotel - get rooms - Lista as tipologias de quartos com descrições, configuração de camas, área, capacidade e fotografias
- KWHotel - find available rooms - Procura quartos disponíveis para um determinado intervalo de datas e apresenta ofertas com preços
- KWHotel - check room availability - Verifica a disponibilidade para uma tipologia de quarto específica e intervalo de datas
- KWHotel - create reservation - Cria uma nova reserva com os dados dos hóspedes e as informações da reserva
- KWHotel - get reservation - Consulta reservas existentes
Como ativar e personalizar ações
- Após a ligação, clique em Configure AI Actions (Configurar ações de IA) na janela modal de sucesso ou aceda a Bot Settings > Actions (Definições do bot > Ações) e localize a categoria KWHotel
- Ative as ações que pretende disponibilizar
- Personalize a etiqueta da ação (o texto apresentado aos utilizadores enquanto a ação está a ser executada) e as instruções do prompt conforme necessário
- Clique em Save (Guardar) para aplicar as alterações
Boas práticas
Otimizar as respostas do chatbot
- Treine o seu bot com informações do alojamento - Adicione descrições dos seus quartos e comodidades do hotel à base de conhecimento, incluindo serviços, localização, atrações próximas e políticas de check-in/check-out
- Defina fluxos de conversação claros - Configure mensagens de boas-vindas que orientem os hóspedes a perguntar sobre a disponibilidade e utilize perguntas sugeridas como "Verificar disponibilidade de quartos" ou "Ver quartos"
- Adicione páginas específicas para os quartos - Crie páginas dedicadas a cada tipologia de quarto no seu site e treine o chatbot com os respetivos URL para obter respostas mais completas
Integração do motor de reservas
- A integração KWHotel funciona através do motor de reservas GuestSage para a gestão de inventário e preços
- Para a conclusão direta da reserva fora do chat, incorpore o widget de reservas do GuestSage no seu site juntamente com o chatbot ChatLab - o chatbot pode encaminhar os hóspedes para a página de reservas quando estiverem prontos para reservar
Resolução de problemas
- Falha na ligação - Verifique se o seu Hotel ID é o UUID do GuestSage (e não o ID numérico de integrações) e se o seu alojamento está ativo no motor de reservas GuestSage
- A ação Get reservation permanece desativada - Se o teste de ligação à Integrations API falhar ao guardar, a ação é desativada automaticamente. Introduza novamente o Integrations Hotel ID e a Integrations API Key e clique em Update Chatbot.
- Nenhum dado de quartos devolvido - Verifique se as tipologias de quartos estão devidamente configuradas no KWHotel com descrições e se a disponibilidade está publicada no GuestSage
- Preços incorretos ou ausência de ofertas - Os preços são obtidos do GuestSage. Atualize as tarifas e as definições de ofertas no KWHotel para refletir os preços atuais. Se definiu um Discount bot channel, certifique-se de que este tem ofertas ativas.
- Integração indisponível no painel de administração - A integração KWHotel requer um plano STANDARD ou PREMIUM do ChatLab, ou o extra Travel Integrations