O robô falha ao se conectar ao Orquestrador pelo BotMaestroSDK porque o Python não reconhece o certificado SSL apresentado na conexão. O certificado SSL é o que comprova a identidade do servidor e protege a comunicação. Veja abaixo como identificar o erro, por que ele acontece e como resolver.

1. Qual erro aparece no log?

Normalmente, o log mostra um SSLError com a mensagem CERTIFICATE_VERIFY_FAILED, que indica que o Python não conseguiu validar o certificado do servidor.

2. Por que o Python não reconhece o certificado?

Esse cenário é comum em ambientes corporativos, em duas situações:

• O servidor usa um certificado autoassinado, ou seja, emitido pela própria empresa e não por uma autoridade certificadora pública.
• O proxy da empresa intercepta o tráfego e apresenta um certificado emitido por uma CA interna (autoridade certificadora da própria empresa).

Nos dois casos, o certificado não está na lista de certificados confiáveis do Python, e a conexão é recusada.

3. Como desativar a validação do certificado no BotMaestroSDK?

Desative a validação do certificado logo depois de instanciar o SDK, antes de qualquer chamada ao Orquestrador:

from botcity.maestro import BotMaestroSDK

maestro = BotMaestroSDK.from_sys_args()
maestro.VERIFY_SSL_CERT = False  # Ignora a validação do certificado

Versão mínima do SDK

Para que a flag VERIFY_SSL_CERT funcione corretamente, a dependência botcity-maestro-sdk precisa estar na versão 0.7.0 ou superior.

4. Desativar a validação do certificado é seguro?

Desativar a validação reduz a proteção da conexão. Com VERIFY_SSL_CERT = False, o robô deixa de validar o certificado apresentado pelo servidor. Valide com o time de segurança da sua empresa se essa solução é adequada para o seu ambiente.

A alternativa mais segura é fazer a máquina de execução confiar no certificado interno, como mostra o guia Configurar Certificado SSL Corporativo.

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.