Conectando um robô existente com o SDK (Node e Python)
Instale o SDK, configure o Client Secret e as variáveis de ambiente e veja como testar localmente sem a Central.
2 min de leituraAtualizado em 09 de novembro de 2026
Se você já tem um robô em Node ou Python, conecte-o à Central com o SDK hobots.
Instalação
- Node:
npm install hobots - Python:
pip install hobots
Variáveis de ambiente
| Variável | Para que serve |
|---|---|
| HOBOTS_CLIENT_SECRET | Chave do agente (começa com hb_). Obrigatória. |
| HOBOTS_INSTANCE_ID | Nome da instância. Se não informada, usa o nome da máquina. |
| HOBOTS_ENVIRONMENT | Ambiente: development, testing, staging ou production (padrão). |
Registrando o robô
Chame register(handler) (sob demanda) ou start(handler) (sempre ligado) uma única vez por programa. O programa permanece aberto sozinho; use close() para encerrar. Veja "Modo sob demanda ou sempre ligado".
Cada tarefa é um agente
Um robô que faz duas coisas deve ser dois agentes, cada um com seu Client Secret.
Testando sem a Central
Defina HOBOTS_LOCAL_RUN=1 ou use a linha de comando hobots run bot.js --params .... Códigos de saída: 0 terminou, 1 falhou, 2 uso inválido, 130 cancelado.
O que o SDK envia
O SDK conversa com a API da Hobots usando o Client Secret no cabeçalho de autorização. Ele envia sinal de vida (heartbeat) a cada 30 segundos, consulta novos trabalhos a cada 2 segundos quando a fila está vazia e envia logs a cada 2 segundos ou 20 linhas. O Client Secret é ocultado ("[REDACTED]") em logs e erros.
Chave rejeitada
Erro 401 significa Client Secret errado ou inativo; erro 402 significa que o agente está fora do limite do plano. Veja "Meu robô aparece offline".