设置与开发

@BotFather 完整中文教程:创建 Telegram 机器人、获取 Token 与发带按钮消息

从认准蓝标 @BotFather 创建机器人、API Token 结构解析与泄露吊销,到排查 BUTTON_URL_INVALID / 403 权限报错、分端配置频道最小权限管理员,手把手配合在线排版工具发出带透明内联按钮的 Telegram 频道置顶帖。

@BotFather 完整中文教程:创建 Telegram 机器人、获取 Token 与发带按钮消息(设置与开发封面图)
设置与开发Telegram 实战文章

01 /

认准蓝标 @BotFather:3 分钟创建机器人与 /newbot 避坑全流程

速览结论:通过 Telegram 官方唯一机器人总管 @BotFather 发送 /newbot,2–3 分钟即可完成机器人创建并拿到 HTTP API Token。普通个人号之所以发不出底部透明跳转按钮,是因为 Telegram 底层协议将 Inline Keyboard(内联键盘)能力严格限定于 Bot API,个人聊天框无法附加该字段。要在频道发出带按钮置顶帖,核心只有三步:创建 Bot 拿 Token、授予频道发帖管理员权限、通过排版工具或接口下发结构化 JSON。

在搜索框检索 @BotFather 时,务必认准用户名右侧的官方蓝色认证徽章(Verified),避开 @BotFatherSupport、BotFather_bot 等高仿钓鱼号,也切勿在来源不明的第三方修改版客户端内创建。进入官方对话后发送 /newbot:先输入展示名称(Name,支持中文与空格,如“AnyTele 客服助手”);再设置全局唯一用户名(Username,5–32 位,仅限英文字母、数字与下划线,且必须以 bot 或 _bot 结尾)。若系统提示 Sorry, the username must end in 'bot'. 检查结尾拼写即可;若报错 Sorry, this username is already taken. 说明已被抢注,可在末尾叠加品牌缩写或业务后缀(如 _official_bot)解决。创建完成后,建议顺手发送 /setuserpic 上传品牌头像、用 /setdescription 编写 512 字符以内的欢迎介绍卡,并通过 /setcommands 配置对话框左下角的斜杠快捷菜单(如 /start、/help、/buy)。

相关配图 · 配置架构客户端环境配置、频道防搬运与开发集成图解
STEP 01

网页端放开限制

iOS 受限于商店规则,需登录 web.telegram.org 打开 Disable filtering 后重启 App。

STEP 02

官方语言包与缓存

通过官方语言包链接一键汉化并关闭无限制媒体下载,清理缓存不丢云端消息。

STEP 03

频道评论与防转发

频道绑定讨论组即可开评论,开启 Restrict Saving Content 可禁止转发下载视频。

STEP 04

Bot 与小程序安全链路

生产级 Bot 走单实例 Webhook + 限流队列,Mini App 后端必须做 initData HMAC 验签。

避坑提示:切勿下载第三方「中文增强版 / 解锁版」安装包,官方直登包+语言包即可零风险完成配置。

02 /

API Token 结构解析、泄露应急吊销与防劫持避坑

@BotFather 返回的 Token 形如 7182930123:AAHxxxx...,冒号左侧纯数字是机器人的全局 User ID,右侧约 35 位字符则是接口鉴权密钥,持有这串密钥等同于拥有机器人的完全控制权。开发部署时应将其写入 .env 环境变量并加入 .gitignore,防止随代码提交至公开仓库。一旦误发群聊或怀疑外泄,立即回到 @BotFather 发送 /mybots → 选中目标机器人 → 点击 API Token → 点击 Revoke current token,旧密钥当场作废,再将新密钥同步替换到服务端配置即可。

日常运营需重点防范两类盗号与劫持陷阱:第一类是打着“免费一键发按钮帖”“免代码防封机器人”旗号的野鸡网页或脚本,诱导你直接粘贴明文 Bot Token,后台实则调用 getUpdates 窃取消息流或覆盖 setWebhook 地址来劫持机器人,再利用你频道里的管理员权限群发钓鱼诈骗广告;第二类是私信兜售的“官方蓝标代认证”“代开机器人收款”服务,均属常见骗局。切勿在不受信的公共代理抓包环境明文传输密钥,也不要把 Token 交给无法本地校验的第三方网站。

03 /

为什么个人号发不出按钮?Inline Keyboard 限制与 3 类报错诊断

不少新手误以为底部透明按钮只是类似超链接的富文本排版,但在 Telegram 协议层,普通个人号发帖仅支持加粗、引用、行内链接与网页预览,而底部内联按钮属于 reply_markup.inline_keyboard 数据结构,只能通过 Bot API 的 sendMessage 或 editMessageText 接口携带下发,因此个人客户端找不到任何按钮添加入口。

用机器人向频道推帖最容易碰到以下 3 类报错,可按错误码定位排查:第一,400 Bad Request: BUTTON_URL_INVALID,代表按钮链接缺少 https:// 或 http:// 协议头(例如只填 t.me/channel),或混入了未转义的空格与中文字符;第二,403 Forbidden: bot is not a member of the channel chat 或 400 Bad Request: chat not found,说明机器人未进频道或 chat_id 格式填错(公开频道填 @channel_username,私密频道必须填 -100 开头的 13 位数字 ID);第三,403 Forbidden: not enough rights to send text messages to the chat,表示机器人虽在管理员列表内,但未勾选发帖权限。

设置与开发场景配图:为什么个人号发不出按钮?Inline Keyboard 限制与 3 类报错诊断
场景图解 · 设置与开发为什么个人号发不出按钮?Inline Keyboard 限制与 3 类报错诊断

04 /

分端配置频道发帖管理员(最小权限原则)与工具一键排版

为避免 Token 意外泄露波及频道安全,授权管理员必须遵守最小权限原则。Desktop 桌面端:进入频道 → 点击右上角 ⋮ → Manage Channel → Administrators → Add Administrator → 搜索并选中 @机器人用户名 → 仅开启 Post Messages(如需修改已发按钮帖可加开 Edit Messages of Others),保持 Change Channel Info、Delete Messages 与 Add New Admins 关闭后点 Save。iOS / Android 移动端:点击频道顶部进入 Channel Info → 点右上角 Edit(iOS)或铅笔图标(Android)→ Administrators → Add Admin → 搜出机器人后同样只保留发帖与必要编辑权限 → 点 Done 或 ✓ 保存。

发帖前快速核对三项检查清单:Token 未在外部工具明文留存、管理员已开启 Post Messages、按钮链接均以 https:// 开头。随后打开 带按钮消息排版工具,左侧填写正文与多排按钮链接,右侧实时预览手机端气泡与换行效果,确认后一键导出标准 Bot JSON 发送并置顶即可。若按钮需承接客服私聊,可参考 Telegram 双向机器人搭建指南;想优化首屏转化与防采集,可阅读 频道首屏印象与置顶导航设计 与 Telegram 中文搜索与禁止转发设置。

05 /

商业化进阶落地与高频追问速答(FAQ)

单向跳转按钮主要解决“把访客引向哪里”的导航需求;当业务需要直接在电报内完成下单核销时,可将 Bot Token 接入自有后端,把按钮从普通 url 升级为 web_app,让用户在聊天窗口拉起免下载的 Telegram Mini App 选购商品,或对接链上监控实现 USDT-TRC20 与 Stars 自动核销、发卡密并拉入 VIP 群组。预算评估可参阅 Telegram 小程序开发预算与频道投流 ROI 核算,TRC20 自动收款建议搭配 USDT-TRC20 手续费与波场能量租赁指南 压低单笔转账成本。

Q1:个人号以前发的置顶帖能直接补加按钮吗? 不能。Bot API 只能修改同一个机器人发出的消息,个人号历史帖子无法后补 Inline Keyboard,只能由机器人重发新帖后重新置顶。Q2:一排最多放几个按钮?文案太长会怎样? 协议单行上限为 8 个按钮,但手机端屏幕较窄,建议每行放 1–3 个、单个文案控制在 6–8 个汉字以内,避免被客户端截断显示省略号。Q3:跳转网址和回调按钮怎么选? 进群、跳官网或客服号选 url 即可;需后端统计点击或触发多级菜单交互时再用 callback_data。

参考资料

功能规则参照下列官方说明,实操步骤由 AnyTele 整理。