Ligue o seu chatbot ChatLab ao seu sistema de reservas IdoBooking para disponibilizar informações de disponibilidade em tempo real e assistência nas reservas aos visitantes do seu website.
O que a integração oferece
Com a integração IdoBooking ativada, o seu chatbot pode:
- Listar 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 todas as ações de IA para o seu chatbot.
Passo 1: Instalar o ChatLab a partir do IdoBooking Marketplace
- Inicie sessão no seu painel de administração do IdoBooking
- Aceda à secção Marketplace
- Localize 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 de copiar credenciais manualmente.
Passo 2: Criar ou iniciar sessão na sua conta ChatLab
Após ativar o ChatLab no marketplace, será 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) requerem um plano STANDARD ou PREMIUM.
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 executa automaticamente as seguintes ações:
- Liga as suas credenciais do IdoBooking ao chatbot selecionado
- Ativa todas as ações de IA disponíveis (pesquisa de apartamentos, verificações de disponibilidade, reservas)
- Redireciona-o de volta para o IdoBooking ou para o painel de administração do ChatLab
Após concluir o assistente, o seu chatbot está pronto para responder a pedidos de informação sobre reservas. Pode ajustar detalhadamente as ações individuais de IA em Bot Settings > Actions (Definições do bot > 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, é necessário criar um utilizador dedicado com acesso à API no seu painel do IdoBooking.
Passo 1: Navegar para a gestão de utilizadores
- Inicie sessão no seu painel de administração do IdoBooking
- Aceda a Settings > Users (Definições > Utilizadores)
- Clique em Add new user (Adicionar novo utilizador)
Passo 2: Criar a conta de utilizador
- Introduza um login name (nome de início de sessão) para o novo utilizador (por exemplo, "chatlab-api")
- Preencha as restantes informações obrigatórias
- 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:
- Ative a opção "Active API access" - este passo é obrigatório para que a integração funcione
- Desative a opção "Active panel access" - o utilizador não necessita de acesso ao painel de administração
Passo 4: Definir a função e as permissões do utilizador
Existem duas opções para configurar a função do utilizador:
Opção A: Função de administrador (Mais simples)
- Selecione Administrator como a função
- Como o utilizador não terá acesso ao painel, esta é uma opção segura que concede permissões completas de API
Opção B: Função de utilizador personalizada (Mais detalhada)
Se preferir um controlo mais granular, selecione Custom user e configure as seguintes permissões de módulos:
- Reservations - Apenas leitura (se o chatbot apenas precisar de consultar informações de reservas) ou Acesso total (se o chatbot for criar reservas)
- Customers - Apenas leitura
- Offers - Apenas leitura
Para utilizadores personalizados, também é necessário configurar as permissões de localização:
- Desloque o ecrã até à secção Location and accommodation permissions
- Recomendamos selecionar Select all para conceder acesso a todas as propriedades
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 - Desativar
- Automatic email notifications - Desativar
Passo 6: Guardar e reunir os dados de ligação
- Clique em Save (Guardar) para criar a conta de utilizador
- Anote as seguintes informações - serão necessárias para a configuração no ChatLab:
- Login - O nome de utilizador que criou (por exemplo, chatlab-api)
- Password - A palavra-passe definida
- Subdomain - O seu subdomínio do IdoBooking (por exemplo, client3760)
Como encontrar o seu subdomínio: Verifique o URL do seu painel do 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: Navegar até ao separador Connect
- Inicie sessão no seu painel de administração do ChatLab
- Selecione o bot que pretende configurar
- Aceda ao separador Connect (Ligar)
- Localize e clique em IdoBooking na lista de integrações
Passo 2: Introduzir os dados de ligação
Preencha o formulário de ligação com as informações obtidas no IdoBooking:
- Client Subdomain - Introduza o seu subdomínio do IdoBooking (sem o URL completo). Exemplo:
client3760(nãohttps://client3760.idosell.com) - System Login - Introduza o nome de utilizador do utilizador de API criado no IdoBooking
- System Password - Introduza a palavra-passe do utilizador de API
- Default Currency - Selecione a moeda para as informações de preços
- Default Language - Selecione o idioma para as descrições das propriedades
Passo 3: Ligar
- Depois de preencher todos os campos obrigatórios, o botão Connect (Ligar) fica ativo
- Clique em Connect para estabelecer a ligação
- Aguarde pela mensagem de confirmação
- Assim que a ligação for concluída, verá uma notificação de sucesso
Após a ligação com sucesso, o botão muda de "Connect" para "Update Chatbot", e surge o botão "Disconnect" caso precise de desativar a integração mais tarde.
Configurar ações de IA
Assim que a sua integração com o IdoBooking estiver ligada (por qualquer um dos métodos), pode configurar que ações de IA o seu chatbot pode realizar. Se utilizou a configuração pelo marketplace, todas as ações vêm ativadas por predefinição.
Ações de IA disponíveis
- Get Apartments - Lista apartamentos e alojamentos disponíveis com descrições, configurações de camas e fotografias
- Find Available Apartments - Procura apartamentos disponíveis para um determinado intervalo de datas com informações de preços
- Check Apartment Availability - Verifica a disponibilidade para um apartamento e intervalo de datas específicos
- Get Reservations - Consulta reservas existentes por ID, estado ou intervalo de datas
- Create Reservation - Cria novas reservas com os dados dos hóspedes e detalhes da reserva
Ativar e personalizar ações
- Após a ligação, clique em Configure AI Actions no modal de sucesso, ou navegue até Bot Settings > Actions e localize a categoria IdoBooking
- Ative ou desative as ações pretendidas
- 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
- Clique em Save (Guardar) para aplicar as alterações
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 questiona sobre a disponibilidade e quais os apartamentos selecionados. Abra a ação a partir de Bot Settings > Actions > IdoBooking - find available apartments para aceder a essas opções.
Number of offers to show
Um seletor 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, o que é útil quando a maioria dos hóspedes apenas hesita entre poucas opções favoritas.
- Valores mais altos (8-10) dão aos hóspedes maior variedade de escolha para comparação, ideal para propriedades com um catálogo mais alargado.
Offer selection strategy
Um menu pendente que determina como os apartamentos são escolhidos 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 (predefinição) - devolve os apartamentos com o preço mínimo mais baixo, ordenados do mais barato para o mais caro. Indicado para situações em que os hóspedes são sensíveis ao preço ou quando pretende destacar primeiro as opções mais acessíveis.
- Evenly distributed by price - escolhe apartamentos distribuídos uniformemente ao longo de toda a gama de preços. Por exemplo, com 9 ofertas, apresenta sensivelmente 3 mais económicas, 3 de preço intermédio e 3 de valor mais alto. Útil quando pretende que os hóspedes vejam toda a amplitude de opções disponíveis, em vez de focar apenas o segmento mais económico.
- Most expensive offers - devolve os apartamentos com os preços mais altos, ordenados do mais caro para o mais barato. Adequado para propriedades premium ou quando pretende destacar as opções de topo.
- Random selection - escolhe apartamentos aleatoriamente a partir dos resultados filtrados. Útil quando pretende variar os apartamentos em destaque entre conversas e evitar sugerir sempre as mesmas opções.
Ambas as definições são guardadas por bot, juntamente com o prompt personalizado e a etiqueta da ação já existentes.
Boas práticas
Recomendações de segurança (Configuração manual)
- Utilize um utilizador de API dedicado - Crie um utilizador em separado especificamente para a integração do ChatLab, em vez de utilizar a sua conta pessoal de administrador
- Permissões mínimas - Conceda apenas as permissões estritamente necessárias para o seu caso de utilização. Recorra ao acesso de apenas leitura se o chatbot apenas precisar de consultar dados
- 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
- Treine o seu bot com informações sobre as propriedades - Adicione descrições dos seus alojamentos à base de conhecimento, incluindo comodidades, características dos quartos e detalhes sobre a localização
- Defina fluxos de conversação 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
- Falha na ligação - Verifique se a opção "Active API access" está ativada para o utilizador no IdoBooking
- Erros de "Access denied" - Verifique se o utilizador tem 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 seu painel IdoBooking e extraia apenas a parte do subdomínio (por exemplo,
client3760a partir dehttps://client3760.idosell.com)