Telegram 机器人
机器人发送转化通知和每日摘要,并用命令回答统计问题。它支持与面板相同的七种语言。
连接
- 在 Telegram 里打开
@BotFather,运行/newbot,得到形如1111:AAABBB…的令牌。 - ⚙ → Integrations → Telegram Bot — 粘贴令牌,按 Connect。
- 在同一页面,Connect chat → Get code,然后给机器人发
/start CODE(或打开"Open bot"链接)。验证码一次性有效,15 分钟内有效。机器人不接受没有验证码的聊天;可在同一页面断开聊天。 - 启用你需要的通知。
/start 之后机器人会置顶一个键盘菜单:Stats、Top、Campaigns、Conversions、Notifications、Digest、Language、Help — 不用输入命令。
更新如何到达机器人
面板自己选择模式并显示在状态卡片上;也可以手动设置。
- Webhook — Telegram 调用
https://<domain>/telegram_bot.php。只在 HTTPS、域名、且带 Telegram 信任的证书时可用。请求通过 Telegram secret token 校验。 - Polling(轮询) —
telegram_poll_cron.phpcron 每分钟拉取一次更新。不需要入站连接:机器人可以在裸 IP、http://和代理后面工作。安装器会添加这个 cron:
* * * * * php /var/www/orbitra/telegram_poll_cron.php --quiet >> /var/www/orbitra/var/logs/telegram_poll.log 2>&1
webhook 生效时,该任务立即退出、什么也不做。
如果机器人没有反应,状态卡片会显示模式、Telegram 自己返回的错误(getWebhookInfo)以及轮询器上次运行时间。"polling"模式下时间为空,表示 crontab 里没有条目。手动检查:
sudo -u www-data php /var/www/orbitra/telegram_poll_cron.php --once
命令
| 命令 | 作用 | ||||||
|---|---|---|---|---|---|---|---|
/stats | 今日统计;/stats yesterday、/stats 1d、/stats 7d、/stats 30d | ||||||
/campaigns | 运行中的广告系列,每个带一个按钮 | ||||||
/campaign ID | 广告系列详情 | ||||||
/top | 今日收入前 5 的广告系列 | ||||||
/conversions | 最近 10 条转化 | ||||||
| `/notify on\ | off` | 转化通知;不带参数 — 显示当前状态和一个按钮 | |||||
| `/daily on\ | off` | 每日摘要 | |||||
| `/lang en\ | ru\ | uk\ | es\ | zh\ | fr\ | de` | 机器人语言;不带参数 — 用按钮选择 |
/sources | 流量来源及其 URL 检查状态 | ||||||
/checksources | 检查所有来源的 URL | ||||||
/allow ID | 按 ID 允许再多一个聊天 | ||||||
/help | 帮助并重新置顶菜单 |
不带参数的命令不改变任何东西:/notify 显示当前状态而不是关闭通知。
通知
- 每次转化 — 广告系列、状态、金额和币种、带国旗的国家、时间。
- 每日摘要 — 点击、转化、收入、消耗、利润和前 3 个广告系列。发送时间为集成设置里的
telegram_daily_time。摘要由轮询器发送(webhook 模式也一样),每天最多一次。
Telegram 频道作为 offer — 独立的漏斗机器人
管理员机器人永远不会是 Telegram 频道 offer 的目的地。广告访客与独立的漏斗机器人对话(Admin → Telegram funnel bots),由它们自己的 worker 轮询;管理员机器人只继续应答你准入的聊天。见 外部 PWA 与 Telegram 频道。
发到频道的转化提醒
Notifications → Telegram → Conversion alerts to channels(机器人连接仍在 Integrations → Telegram)通过管理员机器人把选定的转化发到频道或群组:选择聊天(机器人必须是频道管理员或群组成员,按 Check)、状态(deposit、registration、sale、tg_join……)、广告系列,以及带宏的 HTML 模板 — {campaign}、{offer}、{status}、{payout}、{currency}、{country}、{flag}、{source}、{ad_campaign_name}、{adset_name}、{ad_name}(来自消耗同步的广告平台名称)、{sub1}–{sub3}、{click_id}、{time}、{date}。Send test 发送示例值;日志保留每条提醒最近 200 次发送。每个聊天的 /notify 开关照旧工作。
快速上手
从裸机服务器到第一条转化的九个步骤:安装、首次登录、域名、联盟与 offer、流量来源、广告系列、验证、消耗与统计。
阅读教程 →文档安装与更新
系统要求、一条命令的安装器、PHP 更新与安全公告、按 IP 访问后台、更新完整性校验,以及本地开发环境。
阅读教程 →文档从 Keitaro 迁移
通过 SQL dump 把设置从 Keitaro 迁到 Orbitra:迁移内容清单、导出脚本、导入步骤,以及导入后要检查的事项。
阅读教程 →文档从 Binom 迁移
通过 Binom v2 Public API 直接导入广告系列、offer、流等设置 — 无需 dump 文件,附字段映射说明。
阅读教程 →文档功能总览
所有功能一览:流量与方案、postback 与消耗、数据分析、基础设施与管理 — 每项都链接到详细页面,并附各版本的新增内容。
阅读教程 →文档广告系列与流
广告系列编辑器详解:设置标签页、计费模式、流类型与全部过滤器、方案、自动优化轮询、测试链接与重复点击防护。
阅读教程 →文档斗篷(参考文档)
斗篷完整参考:流设置、检测层、灵敏度、定向过滤器、JavaScript 验证、全局设置、判定结果与原因代码及诊断方法。
阅读教程 →文档浏览器检查
通过浏览器自报矛盾识别机器人、审核员虚拟机、模拟器和反检测浏览器:四种模式、特征清单、结果查看与安全启用步骤。
阅读教程 →文档落地页(参考文档)
落地页完整参考:本地、跳转、Preload 与 Action 四种类型,{offer} 宏、subid 传递、停留时长、JS adapter、PHP 落地页与故障排查。
阅读教程 →文档PWA 与 Web Push
PWA 落地页与自建 Web Push:构建器、域名绑定、VAPID 密钥、订阅者、消息与发送 cron、转化归因和故障排查。
阅读教程 →文档PWA 漏斗
PWA 落地页内的可配置漏斗:store/screen/instructions/push 步骤类型、逐屏追踪、统计维度与编辑器用法。
阅读教程 →文档转化弹窗(Conversion Popups)
在落地页上展示带 offer 按钮的弹窗:适用场景、Popup 标签页设置、触发条件与统计指标。
阅读教程 →文档会话录制与热力图
像视频一样回放真实访问,配合点击热力图与滚动图;含整站录制、Cookie 同意、存储上限与隐私说明。
阅读教程 →文档素材库完整参考
Gallery 页面、上传与软删除、MediaPicker 的尺寸契约(sizeContract)、格式与大小限制,以及视频支持。
阅读教程 →文档创意库
平台同步的创意与手动上传的草稿统一存放,自动绑定花费/收入/ROI,找出真正赚钱的创意。
阅读教程 →文档外部 PWA 与 Telegram 频道
把第三方 PWA 构建器接入流做 A/B,并把 Telegram 频道当作可归因的 offer 目的地。
阅读教程 →文档Postback 与转化
入站 postback 参数与状态映射、转化类型、出站 S2S postback、投递队列与测试器、转化导入和 Conversions API。
阅读教程 →文档花费(Costs)
从 Facebook、TikTok、Google Ads 和 push/pop 联盟导入花费并分摊到点击;含收入聚合器、代理佣金与排错。
阅读教程 →文档Push 与 Pop 联盟
接入 push/pop 联盟的花费导入与 zone 级优化:支持联盟列表、匹配规则与 Zone Killer 屏蔽烧钱 zone。
阅读教程 →文档Facebook / Meta
两套独立集成:从 Meta 导入广告花费,以及用 Conversions API 服务端发送转化事件,含浏览器匹配与排错。
阅读教程 →文档Dolphin / Fbtool
通过 Dolphin(Fbtool)API 实时接收 Facebook 消耗:兼容 Keitaro 的入站端点、API 密钥与活动参数配置、消耗分摊与验证。
阅读教程 →文档FB 评论清理器
按计划批量审核 Facebook 广告贴下的评论:停用词、正则、链接与联系方式规则,默认 dry-run、默认隐藏、操作可恢复。
阅读教程 →文档流量来源与联盟
配置漏斗两端的两个目录:约 200 个流量来源模板与约 440 个联盟模板,参数三元组、postback URL 与 offer 参数宏。
阅读教程 →文档报表、日志与指标
仪表盘、报表生成器、趋势与群组、流量日志与点击卡片,以及每个指标的计算方式。
阅读教程 →文档域名与 SSL
添加域名、把 DNS 指向服务器、自动签发 Let's Encrypt 证书,以及 Domains 页面上每个开关的作用。
阅读教程 →文档Cloudflare
通过 API 接入 Cloudflare:域名自动停放 A 记录、多账号、代理(橙色云朵)与 Flexible / Full / Strict SSL 模式。
阅读教程 →文档管理
用户、角色与按资源授权、两步验证、API 密钥、安全设置、geo 数据库、面板更新与系统状态。
阅读教程 →文档Telegram 机器人
在 Telegram 里管理追踪器:转化通知、每日摘要、统计命令,以及发到频道/群组的转化提醒。
阅读教程 →文档MCP:追踪器里的 AI 助手
把 Claude 或任何 MCP 客户端连上 Orbitra,用大白话管理广告系列:41 个工具、远程与本地两种连接方式、API 密钥安全。
阅读教程 →