5分钟搞定Telegram机器人：从创建到发送消息的完整流程（附chatId获取技巧）

5分钟搞定Telegram机器人从创建到发送消息的完整流程附chatId获取技巧最近在捣鼓一些自动化通知的小工具发现Telegram的机器人接口真是个好帮手。无论是给自己发个每日提醒还是给团队群组推送服务器状态它都能轻松搞定。很多朋友觉得这玩意儿技术门槛高其实不然整个过程比想象中简单得多。这篇文章就是写给那些想快速上手、但又不想被繁琐文档劝退的开发者或普通用户的。我们聚焦于最核心的三件事创建机器人、拿到那个有点神秘的chatId、以及把消息成功发出去。特别是chatId的获取我会分享几个亲测有效、能绕过常见坑点的小技巧让你真正在五分钟内跑通整个流程。1. 从零开始创建你的第一个Bot在Telegram的生态里一切机器人的“出生证明”都由一位名叫BotFather的官方机器人签发。你可以把它理解为一个专门管理机器人的超级管理员。整个创建过程就像是在跟一个智能客服对话完全不需要写代码。首先在你的Telegram应用中无论是手机App还是桌面客户端的搜索框里直接输入BotFather并找到它。点击进入聊天界面你会看到它发来的一串命令菜单。别被吓到我们只需要用到其中最基础的一两个。注意请务必认准带有官方认证标志的BotFather这是唯一合法的创建入口能确保你的机器人功能完整且安全。启动对话后向它发送命令/newbot。接下来BotFather会像一位耐心的向导通过几个简单的问题引导你完成设置为你的机器人起个名字这个名字会显示在聊天列表和对话顶部比如“我的天气小助手”或“项目通知Bot”。这个名字后期是可以修改的。设置一个唯一的用户名这一步很关键。用户名必须以bot结尾例如my_awesome_bot。这个用户名是机器人在Telegram系统中的唯一标识别人通过my_awesome_bot就能找到并启用它。获取至关重要的Token创建成功后BotFather会发来一段长长的字符串格式类似1234567890:ABCdefGHIjklMNOpqrsTUVwxyz。这就是你的机器人的访问令牌Token是机器人调用所有API的“万能钥匙”。请务必立即妥善保存这个TokenBotFather只会显示这一次。如果不慎丢失你只能通过/mybots命令菜单里的API Token选项来重新生成一个新Token旧的会立即失效。为了让你对创建流程有个更直观的印象下面这个表格梳理了关键步骤和注意事项步骤操作指令/动作目的与产出关键提醒1. 找到管理员搜索并打开BotFather进入机器人创建与管理界面确认官方认证标志2. 发起创建发送文本命令/newbot启动新机器人创建流程命令需准确输入3. 设定身份依次回复机器人名称和用户名定义机器人的对外显示名和唯一ID用户名必须以bot结尾4. 领取密钥接收并保存BotFather回复的Token获得机器人API调用的唯一凭证立即备份安全存放创建完成后别忘了亲自“激活”一下你的机器人。在搜索框输入你刚才设置的用户名比如my_awesome_bot找到它并点击Start按钮。这相当于完成了机器人的首次上线握手。2. 破解关键难点多种场景下的chatId获取实战Token是机器人的身份而chatId则是消息要送达的目的地地址。这是新手最容易卡住的一环。简单来说chatId是一个数字标识代表一个特定的聊天会话——它可能是一个私聊你与机器人的对话、一个群组或者一个频道。为什么获取chatId不像Token那样直接给呢这是出于隐私和安全的设计。Telegram不会在界面里直接展示这些ID我们需要通过API来“探测”它。核心原理是让机器人在目标聊天中产生一点“动静”然后我们去查询机器人收到的更新记录从中提取出对应的chatId。2.1 获取与机器人的私聊chatId这是最简单的情况。你只需要给机器人发一条消息。任何消息都可以一个“嗨”或者一个表情符号都行。然后我们通过浏览器访问一个特定的API链接来查看这条消息记录从而拿到chatId。链接的格式如下https://api.telegram.org/bot你的Token/getUpdates请将你的Token替换成你从BotFather那里拿到的那一串字符。在浏览器中打开这个链接你会看到一个JSON格式的返回数据。看起来可能有点乱但我们需要的信息就在里面。{ ok: true, result: [ { update_id: 123456789, message: { message_id: 1, from: { ... }, chat: { id: 987654321, // 这就是你需要的私聊chatId first_name: 你的名字, type: private }, date: 1678888888, text: 嗨 } } ] }在这个JSON结构里找到result数组里第一个元素通常就是你刚发的消息然后顺着message - chat - id的路径就能找到那个数字比如例子中的987654321。私聊的chatId通常是一个正数。2.2 获取群组或超级群组的chatId群组的chatId获取稍微多一步但原理相通先将你的机器人添加到目标群组中并赋予其发送消息的权限。在群组的成员管理界面选择“添加成员”然后搜索你的机器人用户名并添加。添加成功后让机器人在群里“动一下”。最方便的方法是让机器人在群里发一条消息。你可以通过一个临时指令后面会讲发送消息的方法来让机器人发个“Hello”测试或者任何群成员在群里一下你的机器人并说句话也可以。再次访问getUpdates的API链接。这次返回的JSON里你会看到代表群组消息的新条目。{ result: [ ... (可能包含之前的私聊记录), { update_id: 123456790, message: { message_id: 2, from: { ... }, chat: { id: -1001234567890, // 注意群组的chatId通常是负数 title: 我的测试群组, type: supergroup // 或 group }, date: 1678888999, text: Hello } } ] }关键点来了群组和超级群组的chatId是一个负数比如-1001234567890。这个负号是它的重要特征在发送消息时必须原样带上。2.3 高效技巧与常见问题排查直接刷getUpdates接口有时会看到一堆历史消息不方便找。这里有几个提升效率的技巧清空历史精准获取在让机器人产生新动静发消息之前可以先访问一次getUpdates接口拿到当前的update_id。然后在浏览器中访问这样一个链接https://api.telegram.org/bot你的Token/getUpdates?offset最大的update_id1这会让服务器标记这些更新为“已读”之后的新消息就会单独出现在下一次getUpdates的返回结果里非常清晰。使用命令行工具快速解析如果你熟悉命令行用curl和jq工具可以一键提取chatId非常优雅。# 将YOUR_TOKEN替换为你的实际Token curl -s https://api.telegram.org/botYOUR_TOKEN/getUpdates | jq .result[0].message.chat.id这条命令会直接输出第一个更新记录中的chatId数字省去了在JSON中肉眼查找的麻烦。为什么返回空数组[]如果访问getUpdates只看到{ok:true, result:[]}大概率是因为机器人还没有在任何聊天里收到过新消息。请确保你已经给机器人发了消息私聊或机器人在群组里有发言/被提及。Token无效错误如果返回{ok:false,error_code:401,description:Unauthorized}请百分之百检查你粘贴的Token是否正确开头和结尾有没有多余的空格或换行。3. 发送消息不止于文本探索更多可能拿到了Token和chatId发送消息就水到渠成了。Telegram Bot API提供了sendMessage方法通过一个HTTP GET或POST请求即可调用。最基本的文本消息发送URL构造如下https://api.telegram.org/bot你的Token/sendMessage?chat_id你的chatIdtext你好这是来自机器人的消息将你的Token和你的chatId替换成你的实际值text参数后接你想发送的URL编码后的文本内容。在浏览器中打开这个链接如果一切正常你会收到一个JSON响应同时你的机器人就已经把消息发出去了。提示如果消息内容包含特殊字符或空格最好进行URL编码。大多数编程语言都有现成的编码函数或者你也可以使用在线的URL编码工具。但这只是开始。Telegram机器人支持丰富的消息格式和交互元素下面我们展开讲讲。3.1 消息格式与Markdown你可以发送纯文本也可以使用Markdown或HTML来格式化消息让通知更美观。只需要在参数中指定parse_mode。MarkdownV2风格https://api.telegram.org/botToken/sendMessage?chat_idChatIDparse_modeMarkdownV2text*重要通知*%0A任务%20%60%23123%60%20已完成%20✅%0A请点击%20[查看详情](https://example.com)发送效果会是重要通知任务#123已完成 ✅ 请点击 查看详情注意MarkdownV2模式下特殊字符如_,*,,[等前需要加反斜杠\转义上面URL中已做了编码。HTML风格https://api.telegram.org/botToken/sendMessage?chat_idChatIDparse_modeHTMLtextb重要通知/bbrcode#123/code 任务已完成 ✅br请点击 a href\https://example.com\查看详情/a3.2 嵌入键盘与按钮静态消息还不够你可以为用户提供回复键盘或内联键盘创建简单的交互。回复键盘会出现在聊天输入框上方直到被隐藏。# 示例使用Python的requests库发送一个带自定义键盘的消息 import requests import json token YOUR_TOKEN chat_id YOUR_CHAT_ID url fhttps://api.telegram.org/bot{token}/sendMessage keyboard { keyboard: [ [{text: 选项一}, {text: 选项二}], [{text: 帮助}] ], resize_keyboard: True, # 调整键盘大小以适应按钮 one_time_keyboard: True # 使用一次后隐藏 } payload { chat_id: chat_id, text: 请选择一个选项, reply_markup: json.dumps(keyboard) } response requests.post(url, datapayload) print(response.json())内联键盘直接附着在单条消息下方非常适合做菜单或投票。{ inline_keyboard: [ [ {text: 赞成, callback_data: vote_yes}, {text: 反对, callback_data: vote_no} ], [{text: 打开网站, url: https://example.com}] ] }将上述JSON字符串作为reply_markup参数的值发送即可。3.3 发送图片、文档等媒体文件除了文本发送图片、文档、贴纸等媒体文件也非常常见。对于小文件可以直接使用sendPhotosendDocument等接口通过multipart/form-data表单上传。对于网络上的已有文件则可以传递其URL。例如发送一张网络图片https://api.telegram.org/botToken/sendPhoto?chat_idChatIDphotohttps://example.com/image.jpgcaption这是一张示例图片4. 从脚本到服务构建稳定的消息推送流程在浏览器里手动拼接URL测试可以但真正的实用性在于自动化。你需要将发送消息的逻辑集成到你的脚本、应用或服务器中。4.1 使用编程语言封装几乎所有主流编程语言都有方便的HTTP库可以让你更优雅地调用Bot API。这里以Python和Node.js为例Python示例 (使用requests库):import requests def send_telegram_message(token, chat_id, text, parse_modeNone): 发送Telegram消息的通用函数 url fhttps://api.telegram.org/bot{token}/sendMessage payload { chat_id: chat_id, text: text } if parse_mode: payload[parse_mode] parse_mode try: response requests.post(url, datapayload) result response.json() if result.get(ok): print(消息发送成功) return True else: print(f发送失败: {result.get(description)}) return False except Exception as e: print(f请求出错: {e}) return False # 使用函数 TOKEN 你的Token CHAT_ID 你的chatId send_telegram_message(TOKEN, CHAT_ID, 服务器备份已完成。, parse_modeMarkdownV2)Node.js示例 (使用node-fetch或axios):// 使用axios示例 const axios require(axios); async function sendTelegramMessage(token, chatId, text) { const url https://api.telegram.org/bot${token}/sendMessage; try { const response await axios.post(url, { chat_id: chatId, text: text }); console.log(消息发送成功:, response.data); return true; } catch (error) { console.error(发送失败:, error.response ? error.response.data : error.message); return false; } } // 使用函数 const TOKEN 你的Token; const CHAT_ID 你的chatId; sendTelegramMessage(TOKEN, CHAT_ID, Node.js脚本测试消息。);4.2 集成到自动化场景将上述代码片段嵌入你的业务逻辑就能实现强大的自动化通知服务器监控在CI/CD流水线如Jenkins、GitLab CI的构建成功或失败后调用脚本发送通知到团队群。数据报告写一个定时任务Cron Job每天上午10点运行Python脚本从数据库读取核心业务数据生成Markdown格式的日报自动发送给相关负责人。智能家居联动通过Home Assistant等平台当传感器触发报警时调用Telegram Bot API给你的手机发送紧急提醒。社交媒体监听设定一个监听特定关键词的脚本当网络出现相关讨论时立刻摘要推送给你。4.3 错误处理与最佳实践在实际使用中网络波动、API限制、Token失效等问题都可能发生。一个健壮的实现需要考虑以下几点重试机制对于网络超时等临时性错误实现简单的重试逻辑例如最多重试3次每次间隔递增。速率限制Telegram Bot API对发送消息的频率有限制大致是每分钟最多30条消息到同一个群组。在频繁发送的场景下如广播需要在代码中加入延迟。安全存储Token和chatId等敏感信息绝对不要硬编码在脚本里更不要上传到公开的代码仓库。应该使用环境变量、配置文件.env或安全的密钥管理服务来存储。# 在终端中设置环境变量临时 export TELEGRAM_BOT_TOKEN你的Token export TELEGRAM_CHAT_ID你的chatId# 在Python代码中读取环境变量 import os token os.environ.get(TELEGRAM_BOT_TOKEN) chat_id os.environ.get(TELEGRAM_CHAT_ID)日志记录记录每次发送的成功与否、发送时间、消息内容摘要等便于后续排查问题。我自己的几个机器人已经稳定运行了超过一年主要用来接收服务器安全日志和数据库备份状态。最开始也遇到过因为没对消息内容做URL编码导致发送失败或者群组chatId忘了负号的情况。把这些细节处理好之后剩下的就是享受自动化带来的便利了。如果你在测试过程中遇到了其他奇怪的问题不妨回头仔细检查一下Token和chatId的格式以及消息文本里有没有破坏URL结构的字符这两个地方解决了99%的问题都能迎刃而解。