对于许多刚接触Telegram的用户来说,设置一个机器人(Bot)可能听起来很复杂。实际上,你可能会遇到以下问题:不知道如何创建一个机器人、无法获取API Token、或者成功创建后不知如何将机器人添加到群组或频道。本教程将手把手带你完成从零开始设置Telegram机器人的全过程,确保你能够顺利拥有并使用自己的机器人。

第一步:准备工作与基础环境确认

具体操作说明:

在开始创建机器人之前,请确保你已经安装了最新版本的Telegram官方客户端(手机或电脑版均可)。打开Telegram,登录你的账号。如果你使用的是电脑版,建议下载并安装Telegram Desktop,因为后续操作中复制粘贴Token会更方便。同时,请确保你的网络连接稳定,能够正常访问Telegram服务器。

注意事项/小提示:

  • 请使用主账号创建机器人,不要使用临时或小号,因为机器人创建后与账号绑定。
  • 如果你在中国大陆,可能需要使用稳定的网络工具才能正常访问Telegram,否则可能无法完成创建。
  • 建议提前准备好一个记事本或文档,用于保存稍后生成的API Token。

备用方案:

  • 如果无法下载电脑版,可以使用手机版Telegram的浏览器功能,同样可以完成操作,但复制粘贴可能稍麻烦。
  • 如果网络不通畅,尝试切换不同的网络节点或重启客户端。

第二步:找到BotFather并创建机器人

具体操作说明:

在Telegram的搜索框中输入@BotFather,这是Telegram官方提供的机器人管理账号。点击进入它的聊天界面,然后点击底部的“开始”按钮。接着,在输入框中输入命令/newbot并发送。BotFather会回复要求你为机器人起一个名字,例如“我的天气助手”。输入名字后,它会继续要求你设置机器人的用户名,注意用户名必须以bot结尾,例如“MyWeatherBot”或“my_weather_bot”。用户名必须唯一,如果被占用会提示你更换。

注意事项/小提示:

  • 机器人的名字可以随意取,但用户名必须全局唯一且以bot结尾。
  • 建议用户名尽量简洁易记,方便后续邀请他人使用。
  • 发送/newbot后,如果BotFather没有响应,可以尝试再次点击“开始”按钮。

备用方案:

  • 如果忘记命令,可以在BotFather对话框中输入/,它会自动弹出命令列表供选择。
  • 如果用户名被占用,可以尝试在末尾加数字或下划线,例如“MyWeather_Bot_2024”。

第三步:获取并保存API Token

具体操作说明:

当BotFather成功创建你的机器人后,它会回复一条包含API Token的消息。Token是一长串由字母和数字组成的密钥,格式类似于1234567890:ABCdefGHIjklMNOpqrsTUVwxyz请立即复制并保存这个Token到安全的地方,因为关闭对话框后你将无法再次查看它。如果你丢失了Token,只能通过BotFather重新生成。保存好Token后,你可以点击BotFather回复中的t.me/你的机器人用户名链接,直接打开你的机器人并点击“开始”按钮,确认它已经在线。

注意事项/小提示:

  • Token是机器人的唯一身份凭证,泄露给他人可能导致机器人被恶意控制。
  • 绝对不要将Token上传到公开的代码仓库或论坛。
  • 如果怀疑Token泄露,可以随时在BotFather中使用/revoke命令撤销旧Token并生成新的。

备用方案:

  • 如果你忘记保存Token,再次进入BotFather,输入/mybots,点击你的机器人,选择API Token即可重新查看。
  • 如果点击链接后机器人无响应,可能是网络延迟,稍等片刻后重试。

第四步:配置机器人基础设置(头像、描述与命令)

具体操作说明:

回到BotFather的聊天界面,输入命令/mybots,然后从列表中选择你刚刚创建的机器人。你会看到多个设置选项,包括Edit Bot(编辑机器人)。点击进入后,你可以依次完成以下配置:

  • Edit Name:修改机器人的显示名称。
  • Edit Description:添加一段简短描述,例如“这是一个提供实时天气信息的机器人”。
  • Edit About:填写更详细的介绍,会显示在机器人资料页。
  • Edit Botpic:上传一个头像图片(建议使用正方形图片,大小不超过512KB)。
  • Edit Commands:设置机器人的命令列表,例如添加/start/help。每条命令格式为命令 - 说明,例如weather - 获取当前天气

注意事项/小提示:

  • 描述和关于信息最好使用英文或目标用户的语言,因为机器人默认面向全球用户。
  • 命令列表中的命令名称必须由字母、数字或下划线组成,不能包含空格。
  • 每次修改后,BotFather会提示“Success!”表示保存成功。

备用方案:

  • 如果不想设置头像,可以跳过“Edit Botpic”步骤,机器人会使用默认灰色头像。
  • 命令设置后如果发现错误,可以重复上述步骤重新编辑修改。

第五步:将机器人添加到群组或频道

具体操作说明:

打开你想要添加机器人的群组或频道,点击群组名称进入群组信息页(如果是频道,点击频道名称)。在群组信息页中,点击“添加成员”“管理员”(取决于你的权限)。在搜索框中输入你的机器人用户名(例如@MyWeatherBot),选中它并点击“添加”。如果你希望机器人拥有管理员权限(例如发送消息、删除消息等),在添加时勾选“设为管理员”并分配相应权限。添加成功后,群组或频道中会显示“XXX 已将机器人添加到群组”。

注意事项/小提示:

  • 只有群组管理员或频道所有者才有权限添加机器人。
  • 如果机器人需要读取群组消息或执行管理操作,必须设为管理员并赋予对应权限。
  • 在公开群组中,机器人也可以通过群组链接被用户手动邀请。

备用方案:

  • 如果无法添加,检查机器人是否被群组封禁,可以在群组设置中查看“被封禁的用户”列表。
  • 对于频道,机器人必须拥有发布消息的权限才能正常工作。

第六步:验证机器人是否正常运行

具体操作说明:

添加完成后,在群组或频道中发送一条消息,例如/start或你自定义的命令(如/help)。如果机器人配置正确,它应该会回复一条消息。你也可以直接点击机器人头像,进入它的私聊界面,发送/start命令,查看它是否响应。如果机器人没有任何反应,请检查以下步骤:

1. 确认机器人的Token是否已正确配置到你的后端程序或第三方平台。

2. 确认机器人是否已启用(在BotFather中查看状态应为“Enabled”)。

3. 检查网络连接是否正常,机器人服务器是否在线。

注意事项/小提示:

  • 如果你只是创建了机器人但未编写后端代码,机器人只能响应内置的简单命令(如/start),无法实现复杂功能。
  • 如果机器人回复了错误信息,说明后端代码可能存在逻辑问题。
  • 建议在私聊中测试机器人,避免在群组中频繁发送测试消息影响他人。

备用方案:

  • 如果机器人无响应,尝试在BotFather中发送/setprivacy命令,选择Disable,允许机器人看到所有群组消息(仅适用于需要读取消息的机器人)。
  • 也可以使用/deletebot命令删除机器人后重新创建,但注意这会丢失所有设置。

常见问题补充

问:为什么我创建机器人后,BotFather说“Sorry, this name is already taken”?

答:这意味着你选择的用户名已被其他机器人占用。请换一个不同的用户名,确保以bot结尾且全局唯一,例如在名字后加数字。

问:我保存了Token,但后来忘记了,还能找回吗?

答:可以。进入BotFather,发送/mybots,点击你的机器人,选择“API Token”即可重新查看。但请勿泄露给他人。

问:机器人添加到群组后,为什么无法发送消息?

答:检查你是否将机器人设为管理员,并赋予了“发送消息”的权限。如果没有,请在群组管理员设置中重新编辑机器人的权限。

问:如何删除一个机器人?

答:在BotFather中发送/mybots,选择要删除的机器人,然后点击“Delete Bot”并确认。注意删除后无法恢复,所有数据将丢失。

问:机器人可以同时存在于多个群组吗?

答:可以。一个机器人可以被添加到任意数量的群组和频道,无需重复创建。

总结:

通过以上六个步骤,你已成功创建并配置了自己的Telegram机器人,掌握了从获取Token到添加至群组的完整流程。