跳到主要内容

连接

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

«连接»界面的各个选项卡

提示

选项卡名称左侧的圆点表示其状态:绿色——连接已配置,红色——尚有缺失。这样您可以立即看出还有哪些需要设置。

Telegram

管理员在这里连接 Telegram 机器人,Qubix 通过它发送通知,并将各频道按角色分配。(用户的个人订阅需单独设置——参见通知。)

如何连接机器人

  1. 创建机器人:在 Telegram 中打开 @BotFather,发送 /newbot,设置名称和用户名(必须以 _bot 结尾)。
  2. 复制您收到的令牌,并将其粘贴到 Telegram 选项卡中的字段里。
  3. 点击 保存 token。Qubix 会在保存前验证该令牌。 机器人令牌输入表单

保存后,将出现一张机器人卡片(含名称和经过遮罩的令牌)以及频道角色列表。替换 token 按钮可让您粘贴新令牌而不丢失频道绑定。

如何将频道绑定到角色

  1. 为所需的通知类别创建一个单独的私有频道(或群组)。
  2. 将机器人添加到该聊天中,作为具有发送消息权限的管理员——否则通知将无法送达。
  3. 频道 区块中点击 刷新——新的聊天将出现在下拉列表中。
  4. 在所需角色旁边,从列表中选择该聊天。
  5. 在角色行中点击 测试——机器人会向该聊天发送一条测试消息。如果收到,则说明绑定有效。
注意

机器人必须拥有在该聊天中发送消息的权限。如果 测试 返回错误——几乎总是因为机器人缺少此权限,或它已被移出该聊天。

同一个聊天可同时分配给多个角色。要释放某个聊天,请在其角色中选择 "— not assigned —"。

频道角色

  • 钱包 — USDT TRC-20 交易。
  • 严重 — 严重错误。
  • 技术 — 技术错误。
  • Britva — Britva 规则触发。
  • 存款 — 所有充值(全局副本;用户在通知中启用个人订阅)。
  • 注册 — 所有注册(量大,可能比较嘈杂)。
  • 解析错误 — 数据采集期间 Facebook 配置文件退出登录。
  • 转化发送失败 — 未能发送到广告平台(Facebook、TikTok、Google)的事件(注册、充值)。
  • VirusTotal — 针对被标记为恶意的域名的告警。
  • Cloudflare — 审计日志:在 Cloudflare 中设置的域名。
  • Namecheap — 审计日志:在 Namecheap 上注册的域名。
  • 未知像素 — 在流量中出现但不在目录中的像素。
  • 无 subid 的 postback — 没有点击标识符的合作伙伴回传(无法与访问匹配)。
  • 评论清理 — 在粉丝页帖子下和广告下被删除的评论。

转化错误提醒窗口

角色列表下方是设置项 多久重复一次告警。如果转化发送失败接连出现,Qubix 不会重复发送相同的消息:它在所选周期内只发送一条,之后——发送一条简短的 "+N more" 汇总。请从列表中选择一个周期:13612 h(默认为 1 h)。

Cloudflare

用于管理 PWA 域名区域的 Cloudflare API 令牌。粘贴 API TokenAccount ID *(来自仪表盘 URL 的 32 位十六进制字符),如有需要可复制 服务器 IP(它会被写入域名的 A 记录中)。测试 按钮会保存您所输入的内容,并立即检查该令牌是否具有足够的权限。所需的令牌权限:Zone:ReadZone:EditZone.DNS:EditZone.Settings:Edit

Cloudflare 选项卡

Namecheap

用于注册域名的 Namecheap 访问权限,以及在注册时填写的 WHOIS 联系人。

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

Namecheap 选项卡

注意

在注册第一个域名后,Namecheap 会向指定地址发送一封含验证链接的电子邮件。ICANN 规则要求在 15 天内打开它一次。

OpenRouter

用于 Qubix AI 功能的 OpenRouter 访问密钥。粘贴 API Key(格式为 sk-or-v1-...)并选择模型:

  • Chat 模型 — 用于 AI Chat。
  • Agent 模型 — 用于 AI Agent。
  • Image 模型 — 为 PWA 评论生成头像(可选)。
  • Creative analyzer — 用于创意分析的单独开关和模型选择;关闭后,将不执行创意分析。

点击 保存

OpenRouter 选项卡

VirusTotal

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

VirusTotal 选项卡

在找 API 令牌?

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

接下来