电报
Telegram 是 AiHummer 的生产级、推荐的第一个频道。 这是将一个可用的代理展示给真实人群的最快方式：创建一个带有的机器人 @BotFather，给连接器令牌，入站消息开始流向网关。
Telegram 连接器是从产品内安装的 市场 并在管理员界面中配置。它以主机本地方式运行，并通过入站 API 与网关通信，因此它可以独立于轮次引擎进行扩展和重启。
用6个步骤连接电报
这是从零到在 Telegram 上回复你的机器人的端到端路径。你所需要的只是一个 Telegram 账户和访问你的 AiHummer 网络管理界面。
- 使用 BotFather 创建一个机器人。 在电报中打开
@BotFather，发送
/newbot，并设置机器人的名字和 用户名。你会看到的内容： BotFather 返回一个 令牌 喜欢123456789:AA…— 这是机器人的访问密钥，复制它。 - 安装 Telegram 连接器。 在管理界面中打开 插件/市场，在……中找到 Telegram 连接器 打开目录并点击“安装”。等待卡片显示为“在线”（安装中） 显示进度条)。
- 粘贴令牌。 去到 频道 屏幕 → 这 配置已安装的频道 屏蔽，打开 Telegram 卡片并粘贴 机器人令牌 从连接器表单进入字段。保存。
- 创建一个代理 （如果你还没有的话）——见 代理：一个名字和一个系统提示就足够了。
- 将代理绑定到频道。 在 频道 屏幕上，在 绑定 阻止，选择一个 默认代理 适用于 Telegram — 的 规则“新的 Telegram 对话由代理 Y 处理”。选择会立即保存。
- 给机器人发消息。 在 Telegram 中打开你的机器人并发送一条消息给它。*什么 你会看到：*客服在聊天中回复，匹配的对话会出现 在管理界面的“会话”屏幕上。
[!NOTE] 默认情况下，代理会回答 仅已知用户 (登记的人 AiHummer)。如果机器人对你的信息保持沉默——要么将自己添加为一个 实例用户，或关闭上的“仅回答已知用户” 频道 屏幕。
为什么从Telegram开始
Telegram 是所有 AiHummer 频道中摩擦最小的：没有运营商，没有 OAuth 同意屏幕，没有应用审核。一个机器人令牌就足以发送和接收消息，并且同一个连接器既可以覆盖内部员工聊天，也可以覆盖面向客户的机器人。因为它是生产级别且经过充分使用的，所以我们建议在评估 AiHummer 时首先连接此频道。
轮询或网络钩子
该连接器支持两种摄取模式，因此无论您的网关是否可以从公共互联网访问，它都能正常工作。
- 长轮询 — 该连接器从 Telegram 拉取更新。没有入站端口 或者需要 TLS，这使其非常适合本地开发和私有环境 网络。
- 网络钩子 — Telegram 将更新推送到公共 HTTPS URL。延迟更低，并且 更适合在终止 TLS 的反向代理后进行生产部署。
连接器监听于 端口 8800 在正常部署中，或者 8091 用于本地运行。每条入站消息都会发布到配置中的网关 URL AIHUMMER_INBOUND_URL，使用共享的入站密钥进行身份验证。
丰富消息、消息反应和投票
除了纯文本，Telegram 频道还呈现 富消息 — 格式化的回复，将代理的结构化输出映射到 Telegram 的原生消息功能上。它还支持 消息反应 和 民意调查，因此代理可以对用户的消息做出反应，或在对话中放入快速投票作为回合的一部分。
[!TIP] Telegram 是被识别为 AiHummer 的频道
telegram使用那个频道 当您绑定代理或按来源过滤对话时的 ID。
带循环保护的机器人间通信
代理可以与其他机器人交流。为了确保安全，连接器提供了一个 循环守护：它在无人机对无人机的交换失控变成无限乒乓之前检测并打断这些交换。这让你可以组成多机器人工作流程，而不会出现经典的反馈循环失败模式。
关于OIDC的秘密中介
机器人令牌和其他连接器密钥从不硬编码到服务中。相反，连接器在运行时从一个地方获取它们 通过 OIDC 的秘密服务 ——它进行身份验证，然后检索所需的凭证。机密保存在加密的保险库中，而不出现在配置文件和进程参数中。
[!NOTE] 入站消息已发布至
AIHUMMER_INBOUND_URL并由……保护 共享 HMAC 入站密钥 (AIHUMMER_INBOUND_SECRET）。网关必须有一个 默认工作区已配置为调度它们。
如果它不起作用
- Telegram 连接器不在“频道”屏幕上 — 先安装它在 这 插件/市场 屏幕；直到安装完毕 频道未显示。在社区计划中，仅提供 Telegram； 其余需要升级（HTTP 402）。
- 机器人没有回复 — 检查：(1) 令牌是否正确粘贴，并且 Telegram 卡是“在线”；(2) 该频道在“绑定”中绑定了一个代理； (3) 发件人已在系统中注册（默认情况下代理仅回答 已知用户）。
- 回复看起来像模板 — 模拟模型可能仍然处于活动状态；连接一个 供应商在上 模型 页面。
- “未授权” / 令牌被拒绝 — 令牌错误或已被撤销；生成一个
带有新的 @BotFather (
/token）然后再次粘贴它。 - Webhook 没有到达 — 在 webhook 模式下，网关必须可以访问 一个公共 HTTPS URL；在私有网络上使用长轮询，这不需要入站 端口或 TLS。