Integração com a Hostfully

O Hostfully é uma plataforma de gestão de propriedades para alojamentos de férias e agências de arrendamento de curta duração. Ao ligá-lo ao ChatLab, o seu chatbot pode responder a perguntas sobre os seus alojamentos, datas e preços com base nos seus dados em tempo real do Hostfully, consultar a reserva de um hóspede e encaminhar pedidos de reserva para a sua equipa, em vez de responder a partir de texto estático que tem de manter atualizado.

Nota: o Hostfully requer a funcionalidade de integração correspondente. Se o seu plano não a incluir, ao abrir o mosaico do Hostfully verá uma breve nota com uma ligação para entrar em contacto connosco, em vez do formulário de ligação.

Exemplo de conversa

O exemplo ilustra a experiência do hóspede. As ações disponíveis e as informações devolvidas dependem desta integração e da sua configuração.

O que a integração oferece

Uma vez ligado, o chatbot recebe cinco ações do Hostfully. Uma ação separada de AI room search está disponível quando o chatbot tem a capacidade de pesquisa de quartos correspondente.

Hostfully - get properties - lista os alojamentos da sua agência. Para cada um, o chatbot pode mostrar o nome, a descrição, a fotografia, o número máximo de hóspedes e a ligação para a página do alojamento no Hostfully. As descrições são obtidas no idioma de conteúdo escolhido no momento da ligação.

Hostfully - find available properties - o hóspede indica um intervalo de datas e o número de hóspedes, e o chatbot devolve os alojamentos disponíveis para essas datas, com o preço da estadia e uma ligação de reserva por alojamento.

Hostfully - check availability - o hóspede pergunta sobre um alojamento específico. O chatbot verifica o calendário do alojamento para as datas pretendidas, informa se está disponível, quais as datas ocupadas caso não esteja, e o preço para o número indicado de hóspedes, além de uma ligação de reserva.

Hostfully - get reservation status - um hóspede que já tenha reservado indica a referência da reserva, e o chatbot lê o estado, o alojamento, o nome do hóspede e as datas de check-in e check-out a partir do Hostfully.

Hostfully - create booking request - o chatbot recolhe o alojamento, as datas, o número de adultos e crianças e o nome, e-mail e telefone do hóspede, confirma-os com o hóspede e cria um novo lead na sua conta Hostfully. O hóspede recebe um número de referência e a sua equipa dá seguimento no Hostfully.

As datas são compreendidas a partir de linguagem natural, pelo que um hóspede pode escrever "próximo fim de semana" ou "12-15 de junho", em vez de um formato de data rígido.

Antes de começar

Precisa de um chatbot ao qual ligar a integração. Se ainda não criou nenhum, consulte primeiro o artigo Como criar o seu primeiro chatbot ChatLab.

Em seguida, recolha dois valores no Hostfully. Ambos estão na mesma página: inicie sessão no Hostfully, clique no nome da sua empresa na navegação principal e escolha Agency Settings.

1. API Key - na secção API Key da página Agency Settings. O acesso à API é uma funcionalidade da conta Hostfully; se a secção não estiver visível na sua conta, peça ao suporte do Hostfully para a ativar. Consulte Hostfully API authentication.
2. Agency UID - na parte inferior da página Agency Settings.

Opcionalmente, prepare um terceiro valor:

3. Booking URL format - o endereço da sua própria página de reservas, com marcadores de posição que o ChatLab preenche em cada resposta:

   • {web_link} - a ligação para a página do alojamento no Hostfully
   • {property_uid} - o ID do alojamento no Hostfully
   • {date_from} - data de check-in
   • {date_to} - data de check-out
   • {guests} - número de hóspedes

   Por exemplo:

   {web_link}?checkIn={date_from}&checkOut={date_to}&guests={guests}
   

   Se deixar este campo em branco, o chatbot continuará a responder sobre disponibilidade e preços, utilizando a ligação da página do alojamento no Hostfully sem datas.

Passo 1: Ligar o Hostfully

1. Selecione o seu chatbot e aceda ao separador Connect (Ligar).
2. Clique em Connect (Ligar) no mosaico do Hostfully.

3. Cole a sua API Key e o Agency UID, selecione o Default content language (Idioma de conteúdo predefinido) e, opcionalmente, preencha o Booking URL format.

4. Clique em Connect.

O ChatLab guarda as definições e executa imediatamente uma chamada de teste que lista os alojamentos da sua agência. Se a API key ou o Agency UID estiverem incorretos, a integração é novamente desativada e o erro é apresentado no formulário, para que uma ligação com falhas nunca fique ativada pela metade. Em caso de sucesso, o ChatLab carrega os seus alojamentos com as respetivas descrições e fotografias para a sua própria cache, para que as respostas seguintes sejam rápidas.

O Default content language define em que idioma o ChatLab lê os nomes e descrições dos alojamentos quando o Hostfully os disponibiliza em vários idiomas. Estão disponíveis o inglês, polaco, alemão, espanhol, francês e italiano; o predefinido é o inglês.

Passo 2: Rever as ações do Hostfully

A ligação ativa quatro ações automaticamente: get properties, check availability, find available properties e get reservation status. A ação Create booking request permanece desativada, pois regista um novo lead na sua conta Hostfully; ative-a quando pretender que os hóspedes enviem pedidos de reserva através do chat.

Para rever ou ajustar as ações, aceda a Settings > Actions (Definições > Ações) e consulte o grupo Hostfully Actions. Também pode clicar em Hostfully no painel Filter by Platform (Filtrar por plataforma) à direita para mostrar apenas este grupo:

• Hostfully - get properties - etiqueta de ação predefinida "Getting properties..."
• Hostfully - check availability - etiqueta de ação predefinida "Checking availability..."
• Hostfully - find available properties - etiqueta de ação predefinida "Searching available properties..."
• Hostfully - get reservation status - etiqueta de ação predefinida "Checking reservation..."
• Hostfully - create booking request - etiqueta de ação predefinida "Submitting request..."

A captura de ecrã acima mostra o grupo antes de a integração ser ligada: as ações e a pesquisa de quartos por IA opcional estão listadas, mas marcadas como Not connected (Não ligado) e indisponíveis para o chatbot. O AI room search depende da capacidade de quartos e da indexação automática do catálogo; não é garantido que se ative com todas as ligações. Quando o AI room search está ativo, assume a descoberta de alojamentos e a ação simples get properties deixa de intervir.

Para cada ação, pode editar:

• Action Label - a mensagem curta que o hóspede vê no chat enquanto a ação é executada.
• Instructions - o que a ação faz, utilizado pela IA para decidir quando a deve chamar.
• User Instructions - as suas próprias regras adicionais, como pedir o número de hóspedes antes de pesquisar ou mencionar a estadia mínima.

Também pode desativar uma ação individual se não pretender utilizá-la. Por exemplo, pode manter a disponibilidade e os preços ativos, mas desligar a consulta de reservas.

A ação find available properties também tem uma definição de limite de resultados: de 1 a 10 alojamentos, com o valor predefinido de 5. Esta opção limita a lista devolvida, pelo que uma resposta não é necessariamente uma lista exaustiva de todos os alojamentos livres.

Passo 3: Testar

Abra a página Overview (Visão geral), inicie uma nova conversa de teste e experimente perguntas que correspondam a cada ação:

• "Que apartamentos têm?" - aciona Hostfully - get properties
• "O que está livre de 12 a 15 de junho do próximo ano para 2 adultos?" - aciona Hostfully - find available properties
• "O Seaside Loft está livre no próximo fim de semana?" - aciona Hostfully - check availability
• "Qual é o estado da minha reserva ABC123?" - aciona Hostfully - get reservation status
• "Quero reservar o Seaside Loft para essas datas" - aciona Hostfully - create booking request, se a tiver ativado

Verifique se os nomes dos alojamentos e os preços correspondem aos seus dados no Hostfully, se as ligações de reserva abrem a sua página de reservas com as datas já preenchidas e se um pedido de reserva de teste aparece como um novo lead no Hostfully.

Gerir a integração

Atualizar definições - abra o mosaico do Hostfully no separador Connect, altere a API key, o Agency UID, o idioma de conteúdo ou o Booking URL format e clique em Update Chatbot (Atualizar chatbot). O ChatLab executa a chamada de teste novamente e atualiza a cache de alojamentos.

Desligar - abra o mosaico do Hostfully e clique em Disconnect (Desligar). As ações do Hostfully deixam de estar disponíveis para o chatbot e os dados de alojamentos em cache são eliminados. As suas definições permanecem no formulário, pelo que voltar a ligar mais tarde requer apenas um clique.

Dicas

• Continue a treinar o seu bot com o conteúdo do seu website. As ações do Hostfully cobrem alojamentos, datas e preços; tudo o resto sobre o qual um hóspede pergunte (horários de check-in, estacionamento, regras da casa, animais de estimação) vem da sua base de conhecimento. Consulte Treinar o seu chatbot - conceitos básicos e limites.
• Inclua regras de reserva, como a estadia mínima ou a política de caução, nas instruções de utilizador da ação, para que o chatbot as mencione juntamente com a disponibilidade, em vez de deixar o hóspede descobri-las mais tarde.
• Adicione perguntas sugeridas, como "Verificar disponibilidade" ou "Mostrar apartamentos", para que os hóspedes descubram o que o chatbot pode fazer.
• Um pedido de reserva só é criado no Hostfully depois de o chatbot obter o nome, e-mail e telefone do hóspede e de este confirmar os dados. Se também utiliza um formulário de recolha de leads, mantenha os dois alinhados para que os hóspedes não tenham de introduzir os mesmos dados duas vezes. Consulte Recolha de leads.
• Cada resposta que recorra a uma ação do Hostfully consome créditos de mensagens como qualquer outra resposta do chatbot. Consulte O que é um crédito de mensagem.

Artigos relacionados

• Integração com Beds24
• Integração com Hotres
• Integração com IdoBooking
• Integração com KWHotel
• Integração com Mews
• Treinar o seu chatbot - conceitos básicos e limites
• O que é um crédito de mensagem

Catálogo de quartos e visão geral do hotel

Se a sua conta apresentar o separador Hotel, utilize Hotel > Rooms (Hotel > Quartos) para rever o catálogo de quartos e o estado de treino. O AI room search é independente das verificações de disponibilidade por data: corresponde descrições de alojamentos, enquanto as ações de disponibilidade verificam uma estadia pretendida. A indexação automática de alojamentos depende da indexação automática do catálogo e da capacidade de quartos atribuída; caso contrário, utilize Train rooms (Treinar quartos) quando disponível. Reveja as ações ativadas e aguarde que o treino termine antes de depender do AI room search.