Integração com o IdoBooking

Ligue o seu chatbot ChatLab ao seu sistema de reservas IdoBooking para disponibilizar informações de disponibilidade em tempo real e assistência de reservas aos visitantes do seu website.

Exemplo de conversa

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

Antes de começar

Crie ou selecione primeiro um chatbot. Precisa de permissão para gerir as suas integrações e de acesso às definições de ligação da conta externa. Se o mosaico Connect (Ligar) apresentar uma mensagem de atualização de plano ou de contacto, verifique se a sua subscrição inclui esta integração. Mantenha as credenciais de API confidenciais; nunca as cole no código de incorporação do website.

O que a integração oferece

Com a integração do IdoBooking ativada, o seu chatbot pode:

• Apresentar a lista de apartamentos e alojamentos disponíveis com descrições e fotografias
• Verificar a disponibilidade para datas específicas
• Encontrar apartamentos disponíveis para um determinado intervalo de datas com preços
• Consultar reservas existentes por ID, estado ou intervalo de datas
• Criar novas reservas com os dados dos hóspedes

Existem duas formas de configurar esta integração - através do IdoBooking Marketplace (recomendado) ou manualmente através do painel de administração do ChatLab.

---

Opção A: Configuração pelo IdoBooking Marketplace (Recomendado)

A forma mais rápida de ligar o ChatLab ao IdoBooking é através do IdoBooking Marketplace. Este método processa as credenciais de API automaticamente e ativa as ações de leitura para o seu chatbot.

Passo 1: Instalar o ChatLab a partir do IdoBooking Marketplace

1. Inicie sessão no seu painel de administração do IdoBooking
2. Aceda à secção Marketplace
3. Encontre o ChatLab e clique em Install (Instalar)

O IdoBooking envia as suas credenciais de API para o ChatLab automaticamente - sem necessidade de criar um utilizador de API separado ou copiar credenciais manualmente.

Passo 2: Criar ou iniciar sessão na sua conta ChatLab

Após ativar o ChatLab no marketplace, é redirecionado para um assistente de configuração guiada. Se já tiver uma conta ChatLab, inicie sessão. Caso contrário, crie uma nova conta.

Passo 3: Escolher um plano de subscrição

Selecione um plano de subscrição adequado às suas necessidades. As funcionalidades de integração de reservas do IdoBooking (pesquisa de apartamentos, verificação de disponibilidade, reservas) exigem a funcionalidade de integração do IdoBooking. Se a sua subscrição não a incluir, siga a mensagem de atualização ou de contacto.

Passo 4: Selecionar um chatbot

Escolha um chatbot existente para ligar ao IdoBooking ou crie um novo. O assistente pode criar um novo bot automaticamente.

Passo 5: Concluir a configuração

O assistente faz automaticamente o seguinte:

• Liga as suas credenciais do IdoBooking ao chatbot selecionado
• Ativa a pesquisa de apartamentos, as verificações de disponibilidade e a consulta de reservas. A criação de reservas não é ativada automaticamente.
• Redireciona de volta para o IdoBooking ou para o painel de administração do ChatLab

Depois de concluir o assistente, o seu chatbot está pronto para responder a perguntas sobre reservas. Pode ajustar as ações individuais de IA em Settings > Actions (Definições > Ações).

---

Opção B: Configuração manual

Se preferir configurar a integração manualmente, siga estes passos.

Parte 1: Criar um utilizador de API no IdoBooking

Antes de ligar o ChatLab ao seu sistema IdoBooking, precisa de criar um utilizador dedicado com acesso à API no seu painel do IdoBooking.

Passo 1: Aceder à gestão de utilizadores

1. Inicie sessão no seu painel de administração do IdoBooking
2. Aceda a Settings > Users (Definições > Utilizadores)
3. Clique em Add new user (Adicionar novo utilizador)

Passo 2: Criar a conta de utilizador

1. Introduza um login name (nome de início de sessão) para o novo utilizador (por exemplo, "chatlab-api")
2. Preencha as restantes informações obrigatórias
3. Defina uma password (palavra-passe) segura para esta conta

Passo 3: Configurar o acesso à API

Configure as seguintes definições de acesso para o novo utilizador:

1. Ative "Active API access" (Acesso à API ativo) - obrigatório para o funcionamento da integração
2. Desative "Active panel access" (Acesso ao painel ativo) - o utilizador não necessita de acesso ao painel de administração

Passo 4: Definir a função e as permissões do utilizador

Tem duas opções para configurar a função do utilizador:

Opção A: Função de Administrador (Mais simples)

• Selecione Administrator (Administrador) como função
• Concede permissões amplas de API, mesmo com o acesso ao painel desativado. Utilize uma função personalizada se a integração apenas necessitar de operações de leitura selecionadas.

Opção B: Função de utilizador personalizada (Mais granular)

Se preferir um controlo mais granular, selecione Custom user (Utilizador personalizado) e configure as seguintes permissões de módulos:

• Reservations (Reservas) - Read-only (Só de leitura - se o chatbot apenas precisar de consultar informações sobre reservas) ou Full access (Acesso total - se o chatbot for criar reservas)
• Customers (Clientes) - Read-only (Só de leitura)
• Offers (Ofertas) - Read-only (Só de leitura)

Para utilizadores personalizados, também é necessário configurar as permissões de localização:

1. Desloque o ecrã até à secção Location and accommodation permissions (Permissões de localizações e alojamentos)
2. Selecione as propriedades que este chatbot deve cobrir; conceda acesso a todas apenas se esse for o âmbito pretendido.

Passo 5: Desativar notificações desnecessárias

Para evitar que o utilizador de API receba notificações operacionais, desative as seguintes opções:

• Notifications for property staff (Notificações para o pessoal da propriedade) - Desativar
• Automatic email notifications (Notificações automáticas por e-mail) - Desativar

Passo 6: Guardar e reunir os detalhes de ligação

1. Clique em Save (Guardar) para criar a conta de utilizador
2. Anote as seguintes informações - serão necessárias para a configuração no ChatLab:

• Login (Nome de utilizador) - O nome de utilizador que criou (por exemplo, chatlab-api)
• Password (Palavra-passe) - A palavra-passe que definiu
• Subdomain (Subdomínio) - O seu subdomínio IdoBooking (por exemplo, client3760)

Encontrar o seu subdomínio: Verifique o URL do seu painel IdoBooking. Por exemplo, se o seu URL for https://client3760.idosell.com, o seu subdomínio é client3760.

Parte 2: Configurar a integração no ChatLab

Passo 1: Aceder ao separador Connect

1. Inicie sessão no seu painel de administração do ChatLab
2. Selecione o bot que pretende configurar
3. Aceda ao separador Connect (Ligar)
4. Encontre e clique em IdoBooking na lista de integrações

Passo 2: Introduzir os detalhes de ligação

Preencha o formulário de ligação com as informações reunidas a partir do IdoBooking:

• Client Subdomain (Subdomínio do cliente) - Introduza o seu subdomínio IdoBooking (sem o URL completo). Exemplo: client3760 (e não https://client3760.idosell.com)
• System Login (Nome de utilizador do sistema) - Introduza o nome de utilizador do utilizador de API criado no IdoBooking
• System Password (Palavra-passe do sistema) - Introduza a palavra-passe do utilizador de API
• Default Currency (Moeda predefinida) - Selecione a moeda para as informações de preços
• Default Language (Idioma predefinido) - Selecione o idioma para as descrições dos alojamentos

Passo 3: Ligar

1. Depois de preencher todos os campos obrigatórios, o botão Connect (Ligar) fica ativo
2. Clique em Connect para estabelecer a ligação
3. Aguarde pela mensagem de confirmação
4. Assim que a ligação for estabelecida, verá uma notificação de sucesso

Após uma ligação bem-sucedida, o botão muda de "Connect" para "Update Chatbot" (Atualizar chatbot), e surge um botão "Disconnect" (Desligar) caso pretenda desativar a integração mais tarde.

---

Configurar ações de IA

Assim que a integração do IdoBooking estiver ligada (por qualquer um dos métodos), pode configurar que ações de IA o seu chatbot pode executar. Reveja as ações ativas após qualquer um dos métodos de configuração. A criação de reservas não é ativada automaticamente.

Ações de IA disponíveis

• Get Apartments (Obter apartamentos) - Apresenta os apartamentos e alojamentos disponíveis com descrições, configurações de camas e fotografias
• Find Available Apartments (Encontrar apartamentos disponíveis) - Pesquisa apartamentos disponíveis para um determinado intervalo de datas com informações de preços
• Check Apartment Availability (Verificar disponibilidade de apartamento) - Verifica a disponibilidade para um apartamento específico e intervalo de datas
• Get Reservations (Obter reservas) - Consulta reservas existentes por ID, estado ou intervalo de datas
• Create Reservation (Criar reserva) - Cria novas reservas com dados dos hóspedes e detalhes da marcação
• AI room search (Pesquisa de quartos por IA) - Faz a correspondência da descrição daquilo que o hóspede procura com as descrições dos seus quartos, em vez de consultar datas

A pesquisa de quartos por IA e a ação Get Apartments são alternativas, não complementos. Quando a pesquisa de quartos por IA está ativa, substitui a ferramenta de listagem simples e a ação Get Apartments é retirada do chatbot, garantindo que apenas uma ferramenta de listagem de quartos permanece ativa. As ações baseadas em datas não são afetadas.

Ativar e personalizar ações

1. Depois de ligar, clique em Configure AI Actions (Configurar ações de IA) no modal de sucesso ou aceda a Settings > Actions (Definições > Ações) e localize a categoria IdoBooking
2. Ative as ações pretendidas
3. Personalize a etiqueta da ação (o texto apresentado aos utilizadores enquanto a ação está em execução) e as instruções conforme necessário
4. Na caixa de diálogo da ação, clique em Enable (Ativar) para uma nova ação ou em Update (Atualizar) para uma ação existente.

Configurar "Find available apartments"

A ação Find available apartments possui dois controlos adicionais que determinam quantos apartamentos o chatbot apresenta quando um hóspede pergunta pela disponibilidade e quais os apartamentos selecionados. Abra a ação a partir de Settings > Actions > IdoBooking - find available apartments para aceder a estes controlos.

Number of offers to show (Número de ofertas a apresentar)

Um controlo deslizante que varia entre 3 e 10 (predefinição: 6). Controla quantos apartamentos o chatbot devolve ao utilizador numa única resposta.

• Valores mais baixos (3-4) mantêm a resposta curta e focada, útil quando a maioria dos hóspedes escolhe apenas entre algumas opções favoritas.
• Valores mais elevados (8-10) proporcionam aos hóspedes mais variedade para comparar, útil para propriedades com um catálogo mais extenso.

Offer selection strategy (Estratégia de seleção de ofertas)

Um menu pendente que decide que apartamentos são selecionados a partir da lista completa de resultados disponíveis, após a filtragem por data e número de hóspedes. Estão disponíveis quatro opções:

• Cheapest offers (Ofertas mais baratas - predefinição) - devolve os apartamentos com o preço mínimo mais baixo, ordenados do mais barato para o mais caro. Indicado para hóspedes sensíveis ao preço ou para começar pelas opções mais acessíveis.
• Evenly distributed by price (Distribuído uniformemente por preço) - escolhe apartamentos distribuídos uniformemente pela gama de preços. Por exemplo, com 9 ofertas, seleciona aproximadamente as 3 mais baratas, 3 de preço médio e as 3 mais caras. Útil quando pretende que os hóspedes vejam toda a gama disponível e não apenas a opção económica.
• Most expensive offers (Ofertas mais caras) - devolve os apartamentos de preço mais alto, ordenados do mais caro para o mais barato. Indicado para propriedades premium ou para destacar as unidades de categoria superior.
• Random selection (Seleção aleatória) - seleciona apartamentos aleatoriamente a partir dos resultados filtrados. Útil quando pretende variar os apartamentos destacados entre conversas e evitar sugerir sempre os mesmos.

Ambas as definições são guardadas por bot, juntamente com o prompt personalizado e a etiqueta de ação existentes.

---

Testar a configuração concluída

Abra a secção Overview (Visão geral) e inicie uma nova conversa de teste. Peça quartos para um intervalo de datas futuro e um número específico de hóspedes; em seguida, abra a ligação de reserva apresentada e compare as datas, a moeda e o preço com o IdoBooking. Teste a consulta de reservas com uma reserva que tenha autorização para consultar. Ative e teste a opção Create Reservation apenas quando pretender criar uma reserva real; um teste no chat pode registar dados diretamente no seu sistema de reservas.

Boas práticas

Recomendações de segurança (Configuração manual)

• Utilizar um utilizador de API dedicado - Crie um utilizador separado especificamente para a integração com o ChatLab, em vez de utilizar a sua conta de administrador pessoal
• Permissões mínimas - Conceda apenas as permissões estritamente necessárias para o seu caso de utilização. Utilize acesso só de leitura se o chatbot apenas precisar de obter informações
• Rotação regular de credenciais - Atualize periodicamente a palavra-passe do utilizador de API e, em seguida, atualize as credenciais no ChatLab

Otimizar as respostas do chatbot

• Treinar o seu bot com informações da propriedade - Adicione descrições dos seus alojamentos à base de conhecimento, incluindo comodidades, características dos quartos e detalhes de localização
• Definir fluxos de conversa claros - Configure mensagens de boas-vindas que orientem os utilizadores a perguntar sobre disponibilidade e utilize perguntas sugeridas como "Verificar disponibilidade" ou "Ver quartos"

---

Resolução de problemas

• A ligação falha - Verifique se a opção "Active API access" está ativada para o utilizador no IdoBooking
• Erros de "Access denied" (Acesso negado) - Confirme se o utilizador possui as permissões de módulo corretas
• Nenhum dado devolvido - Certifique-se de que o utilizador tem acesso às localizações e propriedades relevantes
• Subdomínio incorreto - Verifique o URL do IdoBooking e extraia apenas a parte do subdomínio (por exemplo, client3760 a partir de https://client3760.idosell.com)

---

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 baseadas em datas: faz a correspondência com base nas descrições dos quartos, enquanto as ações de disponibilidade verificam uma estadia pretendida. A indexação automática de quartos depende da indexação automática do catálogo e da capacidade atribuída aos quartos; caso contrário, utilize Train rooms (Treinar quartos) quando disponível. Reveja as ações ativadas e aguarde que o treino termine antes de recorrer à pesquisa de quartos por IA.

Artigos relacionados

• Adicionar o chatbot ao seu website
• Treinar o seu chatbot
• Enviar uma ligação para o seu chatbot