Telegram机器人主动发消息完全攻略：从Webhook到定时推送的实战指南

引言：为什么机器人需要主动发消息？

在Telegram生态中，大多数机器人遵循“你问我答”的被动模式：用户发送指令，Bot返回结果。但真正的效率革命，在于让机器人主动发消息——例如每日天气提醒、订单状态更新、群组活跃度播报、定时任务通知等。本文将带你从零掌握Telegram机器人主动发消息的能力，打通从“响应器”到“推送器”的进阶之路。

一、理解Telegram机器人的消息发送机制

Telegram Bot API的核心是HTTP请求，无论被动回复还是主动推送，最终都通过sendMessage等接口将消息发给用户或群组。区别在于触发方式：

被动响应：用户发送消息，Telegram通过getUpdates或Webhook将更新推送给服务器，Bot处理后回复。
主动推送：无需用户触发，由你的服务器在任意时间调用API发送消息到指定chat_id。

要实现主动推送，你需要两个关键信息：Bot Token（从BotFather获取）和目标chat_id（用户、群组或频道的数字标识）。

二、获取chat_id：主动发消息的前提

只有拿到对方的chat_id，才能主动发送消息。以下是常用方法：

2.1 通过用户主动发起对话获取

当用户第一次与Bot对话时，你的服务器会收到包含from.id的更新。记录该ID，即可在后续任意时间主动推送。

2.2 通过群组或频道获取

将Bot加入群组，并给予发送消息权限。群组的chat_id通常为负数，可通过getUpdates或Webhook获取。频道则需将Bot设为管理员，频道的chat_id是@频道用户名或数字ID。

2.3 使用@userinfobot等辅助工具

在Telegram中搜索@userinfobot，转发任意消息给它，即可获得你的chat_id。对于测试场景非常方便。

三、主动发消息的两种实现模式

3.1 长轮询（Long Polling）模式

服务器通过getUpdates持续拉取新消息，一旦发现用户交互，就记录chat_id。该模式适合开发调试，但生产环境容易遇到并发问题。

3.2 Webhook模式

将Bot的Webhook指向你的HTTPS服务器，Telegram将实时推送更新。Webhook模式下，你可以在处理更新时提取chat_id并保存，同时还可以处理其他业务逻辑。推荐生产环境使用。

但注意：主动发消息并不依赖Webhook或轮询，而是直接调用sendMessage接口。你只需在服务器上存储用户数据库，随时发起推送。

四、最常用的主动发消息API详解

4.1 sendMessage基础调用

发送文本消息是最核心的功能。接口地址：

https://api.telegram.org/bot<TOKEN>/sendMessage

参数：chat_id（必填）、text（必填）、parse_mode（可选，支持HTML或Markdown）、disable_notification（可选，静默发送）等。

示例（Python requests）：

import requests

token = '123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11'
chat_id = '987654321'
text = '这是一条主动推送的消息'

url = f'https://api.telegram.org/bot/sendMessage'
data = {'chat_id': chat_id, 'text': text}
response = requests.post(url, data=data)

4.2 发送富媒体消息

除了文本，你还可以主动发送图片（sendPhoto）、文件（sendDocument）、视频（sendVideo）、音频（sendAudio）、位置（sendLocation）等。以sendPhoto为例：

url = f'https://api.telegram.org/bot/sendPhoto'
data = {'chat_id': chat_id, 'photo': 'https://example.com/image.jpg', 'caption': '每日精选图片'}
requests.post(url, data=data)

4.3 使用Markdown或HTML排版

设置parse_mode为MarkdownV2或HTML，让消息加粗、斜体、带链接等。注意MarkdownV2有严格的转义要求。

五、实现定时自动推送：用定时任务驱动

定时推送是主动发消息最常见场景。你可以使用Python的schedule库、Celery、或系统cron。下面是一个简单的每日推送示例：

import requests
import schedule
import time

def daily_report():
    # 生成内容，然后发送
    text = '今日报告：...'
    requests.post(f'https://api.telegram.org/bot/sendMessage', data={'chat_id': chat_id, 'text': text})

schedule.every().day.at("09:00").do(daily_report)

while True:
    schedule.run_pending()
    time.sleep(1)

对于多用户推送，你需要从数据库中读取所有chat_id，遍历发送。注意控制频率，避免触发Telegram的频率限制（默认每秒约30条消息）。

六、实战场景：构建群组通知机器人

假设你有一个开发群，希望当服务器错误时自动通知所有成员。可以这样设计：

服务器监控程序捕获异常，调用Bot API向指定群组chat_id发送消息。
使用disable_notification参数控制是否静默，避免打扰非关键消息。
在群组中，需要将Bot设为管理员，并开启“发送消息”权限。

示例（Node.js）：

const telegram = (text) => {
  const token = 'YOUR_TOKEN';
  const chatId = '-1001234567890';
  fetch(`https://api.telegram.org/bot$/sendMessage`, {
    method: 'POST',
    headers: {'Content-Type': 'application/json'},
    body: JSON.stringify({chat_id: chatId, text: text})
  });
};

// 在错误处理中调用
telegram('服务器发生500错误，请检查！');

七、主动发消息的权限与安全注意事项

7.1 用户隐私与反骚扰

Telegram严格禁止滥用主动消息进行垃圾广告。如果用户拉黑你的Bot，发送会失败并返回403错误。务必保障用户退订机制，尊重用户意愿。

7.2 保护Token安全

Token是控制机器人的唯一凭证，务必存放于环境变量或安全配置中，切勿硬编码在公开代码里。

7.3 处理发送频率限制

Telegram对Bot有频率限制（约30条/秒），大批量推送时建议使用队列和分批发送。

7.4 错误处理

重点检查chat_id是否正确、Bot是否被移除、网络是否通畅。对于失败的发送，做好日志和重试机制。

八、进阶技巧：让主动消息更智能

结合用户行为：在用户触发某操作后，延迟一段时间主动推送结果，例如“30分钟没有完成支付，提醒你继续”。
动态定时：使用APScheduler等库实现复杂的循环任务，如每周一、三推送。
多机器人管理：一个服务器可以管理多个Bot Token，按业务分流。
消息回执：使用editMessageText修改已发送的主动消息，适合进度条类通知。

九、总结：从被动到主动，让机器人真正为你工作

掌握主动发消息能力，意味着你的Telegram机器人不再只是“问答工具”，而是能够驱动业务、提升效率的自动化引擎。本文介绍了核心API、chat_id获取、定时推送、实战场景及安全要点。请记住：技术本身并无好坏，关键在于合理使用，尊重用户意愿。现在就尝试构建你的第一个主动推送机器人吧。