Esse erro indica que o Wizard de instalação não conseguiu confirmar que a URL informada é de um Orquestrador BotCity. Na maioria dos casos, o problema está no acesso da máquina à Plataforma BotCity, e não na URL em si. Veja abaixo quando o erro aparece, as causas mais comuns e como resolver.

1. Quando esse erro aparece?

O erro aparece na etapa de login do Wizard de instalação, depois que você informa a URL da Plataforma BotCity no campo Server:

Not a valid BotCity Orchestrator hostname.

2. Por que o erro aparece mesmo com a URL correta?

Para validar o campo, o Wizard faz uma requisição GET para <url-do-orquestrador>/api/v2/maestro/version e só considera o servidor válido se a resposta trouxer a versão do Orquestrador. Qualquer falha nessa requisição gera a mesma mensagem, mesmo quando a URL está correta.

Por exemplo, se o proxy da empresa bloquear essa requisição, o Wizard exibe o erro, ainda que https://suaempresa.botcity.dev seja o endereço certo do seu workspace.

3. Quais são as causas mais comuns e como resolver?

• URL digitada incorretamente: informe apenas o endereço do seu workspace, com https:// e sem caminhos adicionais, por exemplo https://suaempresa.botcity.dev.
• Proxy corporativo: configure o proxy nas ferramentas BotCity.
• Bloqueio de firewall: peça ao time de TI a liberação dos domínios da BotCity na porta 443.
• Restrição de IP no workspace: se o workspace usa a Lista de IPs permitidos da Central de Segurança, confirme que o IP de saída da máquina está liberado.
• Falha de DNS ou timeout: verifique se a máquina resolve o domínio do workspace e se a rede não está interrompendo a conexão.

4. Como testar o acesso ao Orquestrador pela própria máquina?

Na máquina onde o Wizard está sendo executado, abra no navegador o endereço https://<seu-workspace>.botcity.dev/. Se a página não carregar, o problema está no acesso da máquina à Plataforma BotCity, e não na instalação.

Se o erro continuar, execute a ferramenta de diagnóstico e veja se todos os requisitos e liberações estão sendo atendidos.

Ainda precisa de ajuda?

Se isso não resolver o seu caso ou sua pergunta não está listada aqui, abra um chamado com o time de suporte.