跳到主要内容

🤖 Telegram Bot

PulseHub 通过 Bot API 连接到 Telegram。当用户向您的 Telegram 机器人发送消息时，消息会显示在 PulseHub 中。

前提条件​

一个 Telegram 账户，以及访问 @BotFather 以创建机器人。

设置步骤​

1. 使用 BotFather 创建机器人​

  1. 打开 Telegram 并搜索 @BotFather
  2. 发送 /newbot
  3. 选择一个显示名称（例如 "Acme 客服"）
  4. 选择一个以 bot 结尾的用户名（例如 acmesupport_bot）
  5. BotFather 会回复您的 Bot Token

2. 在 PulseHub 中添加频道​

  1. 前往 Channels → Add Channel
  2. 选择 Telegram
  3. 粘贴您的 Bot Token
  4. 点击 Save Channel
  5. 复制 Webhook URL

3. 在 Telegram 注册 Webhook​

在浏览器中打开此 URL：

https://api.telegram.org/bot{YOUR_BOT_TOKEN}/setWebhook?url={YOUR_PULSEHUB_WEBHOOK_URL}

Telegram 会响应：{"ok": true, "result": true, "description": "Webhook was set"}

4. 测试​

在 Telegram 中打开您的机器人并发送一条消息。消息应在几秒内出现在 PulseHub 中。

Telegram 的 Webhook 要求​

  • Webhook URL 必须使用 HTTPS 并具有有效的 SSL 证书
  • Telegram 期望在 60 秒内收到 200 响应

常见问题​

症状可能原因
Webhook 未设置URL 必须是具有有效证书的 HTTPS
机器人不响应检查 telegram_chat_id 是否在 contacts.external_ids 中
旧消息被重新投递重新注册 webhook 时属正常现象