Conexões
É aqui que ficam armazenadas as chaves e credenciais dos serviços externos que a Qubix utiliza: um bot do Telegram para notificações, Cloudflare e Namecheap para o trabalho com domínios, OpenRouter para os recursos de IA e VirusTotal para verificar domínios. A tela é dividida em abas: Telegram, Cloudflare, Namecheap, OpenRouter, VirusTotal.
O ponto à esquerda do nome de uma aba indica o seu estado: verde — a conexão está configurada, vermelho — algo está faltando. Assim você vê de imediato o que ainda falta configurar.
Telegram
É aqui que o administrador conecta o bot do Telegram pelo qual a Qubix envia notificações e distribui os canais entre as funções. (As assinaturas pessoais de um usuário são configuradas separadamente — veja Notificações.)
Como conectar o bot
- Crie um bot: abra @BotFather no Telegram, envie
/newbot, defina um nome e um username (ele precisa terminar com_bot). - Copie o token recebido e cole-o no campo da aba Telegram.
- Clique em Salvar token. A Qubix verifica o token antes de salvar.
Após salvar, aparecem um card do bot (com o nome e um token mascarado) e uma lista de funções de canais. O botão Substituir token permite colar um novo token sem perder as vinculações de canais.
Como vincular um canal a uma função
- Crie um canal (ou grupo) privado separado para a classe de notificações desejada.
- Adicione o bot a esse chat como administrador com permissão para enviar mensagens — caso contrário as notificações não chegarão.
- Clique em Atualizar no bloco Canais — o novo chat aparecerá nos menus suspensos.
- Ao lado da função desejada, escolha o chat na lista.
- Clique em Testar na linha da função — o bot enviará uma mensagem de teste ao chat. Se ela chegar, a vinculação está funcionando.
O bot precisa ter permissão para enviar mensagens no chat. Se Testar retornar um erro — quase sempre o motivo é que o bot não tem essa permissão, ou que ele foi removido do chat.
O mesmo chat pode ser atribuído a várias funções ao mesmo tempo. Para liberar um chat, escolha "— não atribuído —" na função dele.
Funções de canais
- Carteira — transações USDT TRC-20.
- Críticos — erros críticos.
- Técnicos — erros técnicos.
- Britva — disparos de regras do Britva.
- Depósitos — todos os depósitos (uma cópia global; o usuário ativa uma assinatura pessoal em Notificações).
- Registros — todos os registros (alto volume, pode gerar ruído).
- Erros de parsing — deslogamentos de perfis do Facebook durante a coleta de dados.
- Falhas no envio de conversões — eventos (registros, depósitos) que não puderam ser enviados à plataforma de anúncios (Facebook, TikTok, Google).
- VirusTotal — alertas para domínios marcados como maliciosos.
- Cloudflare — log de auditoria: um domínio configurado no Cloudflare.
- Namecheap — log de auditoria: um domínio registrado na Namecheap.
- Pixels desconhecidos — pixels vistos no tráfego que não estão no catálogo.
- Postbacks sem subid — postbacks de parceiros sem identificador de clique (não podem ser associados a uma visita).
- Limpeza de comentários — comentários excluídos sob posts de fan pages e sob anúncios.
Janela de repetição do alerta de erros de conversão
Abaixo da lista de funções está a configuração Com que frequência repetir o alerta. Se as falhas no envio de conversões chegam em fluxo, a Qubix não envia mensagens idênticas em spam: ela envia uma por período escolhido e, depois disso — um breve resumo "+N mais". Escolha um período na lista: 1, 3, 6 ou 12 h (padrão — 1 h).
Cloudflare
Um token da API do Cloudflare para gerenciar as zonas dos domínios PWA. Cole o API Token e o Account ID * (um hex de 32 caracteres da URL do dashboard) e, se necessário, copie o IP do servidor (ele é inserido nos registros A dos domínios). O botão Testar salva o que você inseriu e verifica imediatamente se o token tem permissões suficientes. As permissões necessárias do token: Zone:Read, Zone:Edit, Zone.DNS:Edit, Zone.Settings:Edit.
Namecheap
Acesso à Namecheap para registrar domínios e o contato WHOIS que é preenchido durante o registro.
- Primeiro, adicione o IP do servidor à lista de permissões da Namecheap (o botão de copiar ao lado do campo) — sem isso a API não funciona.
- Preencha o API User e o API Key, clique em Testar.
- No card Contato WHOIS, preencha todos os 9 campos (sem eles a Namecheap rejeita o registro) e, se desejar, ative a publicação dos contatos no WHOIS.
Após o primeiro domínio ser registrado, a Namecheap enviará por e-mail um link de verificação ao endereço indicado. As regras da ICANN exigem abri-lo uma vez dentro de 15 dias.
OpenRouter
Uma chave de acesso ao OpenRouter para os recursos de IA da Qubix. Cole o API Key (no formato sk-or-v1-...) e escolha os modelos:
- Modelo Chat — para o AI Chat.
- Modelo Agent — para o AI Agent.
- Modelo Image — geração de avatares para comentários PWA (opcional).
- Creative analyzer — um toggle e uma escolha de modelo separados para a análise de criativos; quando desativado, a análise de criativos não é realizada.
Clique em Salvar.
VirusTotal
Uma chave da API do VirusTotal para verificar automaticamente seus domínios quanto à "maliciosidade". A cada poucas horas o sistema compara seus domínios com as bases de dados antivírus e, se ao menos um marcar um domínio como perigoso — você recebe uma notificação no Telegram. Cole o API Key e clique em Testar. O plano gratuito do VirusTotal é suficiente — o sistema distribui as verificações ao longo do tempo para permanecer dentro dos limites.
O token pessoal para integrações agora fica na página MCP/API, onde você também obtém o endpoint, a configuração do cliente e o catálogo de métodos. Veja MCP/API.