连接
这里存放 Qubix 所使用的外部服务的密钥和凭证:用于通知的 Telegram 机器人、用于处理域名的 Cloudflare 和 Namecheap、用于 AI 功能的 OpenRouter,以及用于检查域名的 VirusTotal。该界面分为若干选项卡:Telegram、Cloudflare、Namecheap、OpenRouter、VirusTotal。

选项卡名称左侧的圆点表示其状态:绿色——连接已配置,红色——尚有缺失。这样您可以立即看出还有哪些需要设置。
Telegram
管理员在这里连接 Telegram 机器人,Qubix 通过它发送通知,并将各频道按角色分配。(用户的个人订阅需单独设置——参见通知。)
如何连接机器人
- 创建机器人:在 Telegram 中打开 @BotFather,发送
/newbot,设置名称和用户名(必须以_bot结尾)。 - 复制您收到的令牌,并将其粘贴到 Telegram 选项卡中的字段里。
- 点击 保存 token。Qubix 会在保存前验证该令牌。

保存后,将出现一张机器人卡片(含名称和经过遮罩的令牌)以及频道角色列表。替换 token 按钮可让您粘贴新令牌而不丢失频道绑定。
如何将频道绑定到角色
- 为所需的通知类别创建一个单独的私有频道(或群组)。
- 将机器人添加到该聊天中,作为具有发送消息权限的管理员——否则通知将无法送达。
- 在 频道 区块中点击 刷新——新的聊天将出现在下拉列表中。
- 在所需角色旁边,从列表中选择该聊天。
- 在角色行中点击 测试——机器人会向该聊天发送一条测试消息。如果收到,则说明绑定有效。
机器人必须拥有在该聊天中发送消息的权限。如果 测试 返回错误——几乎总是因为机器人缺少此权限,或它已被移出该聊天。
同一个聊天可同时分配给多个角色。要释放某个聊天,请在其角色中选择 "— not assigned —"。
频道角色
- 钱包 — USDT TRC-20 交易。
- 严重 — 严重错误。
- 技术 — 技术错误。
- Britva — Britva 规则触发。
- 存款 — 所有充值(全局副本;用户在通知中启用个人订阅)。
- 注册 — 所有注册(量大,可能比较嘈杂)。
- 解析错误 — 数据采集期间 Facebook 配置文件退出登录。
- 转化发送失败 — 未能发送到广告平台(Facebook、TikTok、Google)的事件(注册、充值)。
- VirusTotal — 针对被标记为恶意的域名的告警。
- Cloudflare — 审计日志:在 Cloudflare 中设置的域名。
- Namecheap — 审计日志:在 Namecheap 上注册的域名。
- 未知像素 — 在流量中出现但不在目录中的像素。
- 无 subid 的 postback — 没有点击标识符的合作伙伴回传(无法与访问匹配)。
- 评论清理 — 在粉丝页帖子下和广告下被删除的评论。
转化错误提醒窗口
角色列表下方是设置项 多久重复一次告警。如果转化发送失败接连出现,Qubix 不会重复发送相同的消息:它在所选周期内只发送一条,之后——发送一条简短的 "+N more" 汇总。请从列表中选择一个周期:1、3、6 或 12 h(默认为 1 h)。
Cloudflare
用于管理 PWA 域名区域的 Cloudflare API 令牌。粘贴 API Token 和 Account ID *(来自仪表盘 URL 的 32 位十六进制字符),如有需要可复制 服务器 IP(它会被写入域名的 A 记录中)。测试 按钮会保存您所输入的内容,并立即检查该令牌是否具有足够的权限。所需的令牌权限:Zone:Read、Zone:Edit、Zone.DNS:Edit、Zone.Settings:Edit。

Namecheap
用于注册域名的 Namecheap 访问权限,以及在注册时填写的 WHOIS 联系人。
- 首先,将 服务器 IP 添加到 Namecheap 白名单中(字段旁的复制按钮)——没有这一步,API 将无法工作。
- 填写 API 用户 和 API Key,点击 测试。
- 在 WHOIS 联系信息 卡片中,填写全部 9 个字段(缺少它们 Namecheap 将拒绝注册),如愿意,可启用在 WHOIS 中公开联系人。

在注册第一个域名后,Namecheap 会向指定地址发送一封含验证链接的电子邮件。ICANN 规则要求在 15 天内打开它一次。
OpenRouter
用于 Qubix AI 功能的 OpenRouter 访问密钥。粘贴 API Key(格式为 sk-or-v1-...)并选择模型:
- Chat 模型 — 用于 AI Chat。
- Agent 模型 — 用于 AI Agent。
- Image 模型 — 为 PWA 评论生成头像(可选)。
- Creative analyzer — 用于创意分析的单独开关和模型选择;关闭后,将不执行创意分析。
点击 保存。

VirusTotal
用于自动检查您的域名是否"具有恶意"的 VirusTotal API 密钥。系统每隔几小时将您的域名与杀毒数据库进行比对,如果至少有一个将某域名标记为危险——您将在 Telegram 中收到通知。粘贴 API Key 并点击 测试。VirusTotal 的免费套餐已足够——系统会将检查分散到不同时间,以保持在限额之内。

用于集成的个人令牌现已移至 MCP/API 页面,在那里您还可以获取端点、客户端设置和方法目录。参见 MCP/API。