Meu robô aparece offline ou não conecta

Use este checklist quando um robô aparece offline, nunca conecta ou parou de executar.

1. Client Secret

• O Client Secret deve ter o formato hb_ seguido de 64 caracteres hexadecimais. Se estiver errado, o SDK mostra um erro ao iniciar informando só o tamanho recebido, nunca o valor.
• Erro 401: chave errada ou inativa. O SDK tenta de novo a cada 30 segundos.
• Se a chave foi trocada, a mudança leva cerca de 1 minuto para valer.

2. Limite do plano

Erro 402 significa que o agente está fora do limite do plano. Faça upgrade em Plano e cobrança.

3. Chamadas duplicadas

Chamar register ou start duas vezes no mesmo programa gera o erro "o agente já foi iniciado". Chame uma única vez.

4. Instância estável

Use um HOBOTS_INSTANCE_ID fixo. Se ele muda a cada inicialização, aparecem instâncias fantasmas.

5. Tolerância de offline

No modo automático a instância fica offline após cerca de 90 segundos sem sinal. Para robôs que rodam de tempos em tempos, aumente a tolerância em configurações do agente, em "presença e heartbeat".

6. Rede

O robô precisa alcançar a API da Hobots. Em rede corporativa, confira proxy e firewall.

Ainda offline?

Abra um chamado com o nome do agente, a instância, o horário e a mensagem de erro exibida no log do robô.