开始使用
BotNexus Ultra
欢迎使用全球领先的 TG 消息互联系统。本系统可以将 Telegram 消息实时推送到您的企业微信，并支持在微信内直接回复。得益于我们的 Bridge Protocol 架构，您无需魔法环境即可实现毫秒级消息响应。
01 准备 Telegram 机器人
步骤 1: 申请机器人
打开 Telegram，搜索 @BotFather (官方机器人之父)。
• 发送指令 /newbot
• 按提示输入机器人名称 (Name)，如：My Assistant
• 输入机器人用户名 (Username)，必须以 bot 结尾，如：my_test_bot
步骤 2: 获取 Token
BotFather 会回复一段长字符串，这就是 Token，请务必妥善保管。
02 配置企业微信 (核心)
管理后台：work.weixin.qq.com
步骤 1: 获取 CorpID、AgentID 与 Secret
1. 获取 CorpID: 点击菜单 我的企业 -> 底部可见 企业ID。
2. 创建应用: 点击菜单 应用管理 -> 创建应用。上传 Logo 并起名（如“TG小助手”）。
注意： 可见范围 必须选择您自己，千万不要留空。
3. 获取 ID 与密钥: 创建成功后进入应用详情页，即可看到 AgentId（如 1000001）和 Secret（需手机端确认查看）。
步骤 2: 域名所有权验证 (先决条件)
在配置 IP 白名单前，必须先通过微信的域名验证。BotNexus 提供了“验证”功能，无需手动上传文件。
1. 在企微后台点击 “网页授权及JS-SDK” 或配置可信域名处，下载微信提供的 .txt 验证文件。
2. 回到 BotNexus 控制台，点击顶部 “域名归属权验证” 按钮。
点击“保存并生效”后，微信即可检测通过，无需操作服务器文件。
步骤 3: 配置 IP 白名单 (必做)
验证完成后，进入应用详情页底部 -> 企业可信IP -> 点击配置。
请将以下 IP 填入企业微信后台白名单：
03 绑定与上线测试
步骤 1: 部署机器人
回到 BotNexus 控制台，点击 Deploy New Bot，粘贴刚才申请的 TG Token。
步骤 2: 注入微信参数
点击机器人卡片进入 [WeChat Connector] 模块。
填入 CorpID, AgentID, Secret 并启用 Active Switch。
步骤 3: 连通性测试
使用您的个人 Telegram 账号给该机器人发送 /start 或 Hello。
常见问题排查 (Troubleshooting)
Q: 为什么配置完成却收不到消息？ ▼
1. 确认企微应用的 “可见范围” 是否真的包含了当前登录的成员。
2. 确认 “企业可信IP” 是否与 BotNexus 控制台显示的服务器 IP 一致。
3. 检查 BotNexus 控制台该 Bot 的微信推送开关是否已打开。
Q: 点击卡片回复显示“网络错误”？ ▼
这通常是国内代理服务器握手超时。请尝试 *下拉刷新页面* 或在手机端强制关闭微信后台重新进入。如果频繁发生，请在控制台重置 Webhook 状态。