Melhores Práticas
Melhores Práticas
Diretrizes para operar BotCloud de forma responsável, segura e eficiente.
Antes de Começar
Confirme autorização escrita, use proxies controlados, use dados sintéticos/anonimizados, respeite termos de serviços de terceiros.
- Confirme autorização escrita de seu provedor de serviço antes de integrar
- Use proxies dedicados e controlados — nunca proxies residenciais compartilhadas de fontes desconhecidas
- Use dados de teste sintéticos ou anonimizados, não credenciais de usuários reais
- Revise e respeite os termos de serviço de terceiros antes de alvejar qualquer plataforma
Higiene de Segurança
Criptografe e armazene credenciais com segurança, gire regularmente, mantenha registro detalhado.
- Armazene seu token de API em variáveis de ambiente, nunca no código-fonte
- Gire credenciais regularmente e imediatamente após qualquer exposição suspeita
- Use autenticação de token Bearer para todas as chamadas de endpoint de API
- Mantenha logs de auditoria detalhados usando GET /api/history para trilhas de sessão
Gerenciamento de Sessão
Gerenciamento correto do ciclo de vida da sessão previne vazamentos de cota e garante automação confiável.
- Sempre use try-finally com browser.close() para garantir liberação de cota
- Monitore motivos de desconexão via GET /api/history — saldo insuficiente interrompe sessões no meio
- Verifique cota restante com GET /api/quota antes de lançar trabalhos grandes
- Trate erros 400/401/403/500 com retentativas de backoff exponencial
Configuração de Proxy
Declarações de proxy são obrigatórias em cada conexão — nenhuma saída não autenticada.
- Declare --proxy-server em cada conexão WebSocket — o parâmetro é obrigatório
- Credenciais viajam na string de conexão codificada em URL; use proxies HTTPS para fluxos de trabalho sensíveis
- Geo-inferência é automática do seu IP de proxy: fuso horário, localidade e região são definidos para corresponder
- Use UDP sobre SOCKS5 para prevenção de vazamento WebRTC em provedores de proxy suportados
Você Não Deve
Interferir em mecanismos anti-abuso sem permissão, coletar credenciais ou dados pessoais de terceiros, revender acesso, envolver-se em spam ou fraude.
- Interferir em mecanismos anti-abuso sem permissão escrita explícita
- Coletar credenciais de terceiros, dados pessoais ou informações de pagamento
- Revender ou sub-licenciar acesso à API BotCloud para terceiros
- Usar BotCloud para spam, fraude ou qualquer atividade proibida por lei aplicável
Tratamento de Incidentes e Abuso
Pause imediatamente tarefas anômalas e notifique a equipe de suporte.
- Pause imediatamente todas as sessões em execução quando comportamento anômalo for detectado
- Contate suporte via Telegram @BotCloudSupport com IDs de sessão e timestamps
- Preserve saída de GET /api/history para a janela de tempo afetada
- Documente o escopo do incidente antes de retomar fluxos de trabalho de automação
Dúvidas Sobre Conformidade?
Revise o Aviso Legal completo e as Diretrizes de Uso Responsável antes de integração.