Telegram（纸飞机）机器人功能详细介绍

2024-11-13

为了更好地帮助您理解 Telegram 机器人功能以及如何在您的项目中加以应用，以下是对这些功能的详细说明，并通过更具说服力的实际案例来展示如何利用这些功能提高用户体验和业务效率。

Telegram 机器人功能详细介绍

Telegram 机器人是一种强大的工具，可以为用户提供丰富的互动体验，支持从自动化任务到复杂的商业集成功能。以下是一些核心功能的详细说明：

1. 输入和命令

机器人能够接收用户的文本输入、命令、按钮选择、甚至附件。用户可以通过发送简单的文本指令与机器人交互，如/start启动机器人，或使用更复杂的命令如/newlocation设置新位置。

用户可以向机器人发送各种类型的消息，包括文本、文件、位置、贴纸、语音消息，如果他们觉得幸运的话，甚至可以发送骰子。但是，Telegram 机器人提供了许多其他工具来构建适合您特定需求的灵活界面：

在消息中突出显示的命令，键入后可以从列表中选择/。
用预定义的答案选项替换用户键盘的键盘。
显示在机器人消息旁边的按钮。

为了获得更大的灵活性，Web 应用程序支持使用 JavaScript 的 100% 自定义界面。

注意： Telegram 机器人可以支持多种语言，以适应应用程序中用户的语言设置。

命令很简单/keyword，告诉机器人该做什么。Telegram 应用程序将：

突出显示消息中的命令。当用户点击突出显示的命令时，该命令会立即再次发送。
当用户输入时，建议一个带有描述的受支持的命令列表（要使此功能正常工作，您需要向@BotFather或通过适当的API方法/提供命令列表）。从列表中选择一个命令会立即发送它。
显示包含全部或部分机器人命令的菜单按钮（通过@BotFather设置）。

命令必须始终以/符号开头，且最多包含 32 个字符。它们可以使用拉丁字母、数字和下划线，但建议使用简单的小写文本以获得更清晰的外观。

以下是一些示例：

/下一个
/取消
/新位置
/新规则

命令应该尽可能具体– 例如/newlocation，或比需要用户提供附加参数（如“位置”或“规则”）的命令/newrule 更好。/new

注意：我们要求所有开发人员支持几个全局命令，以确保 Telegram 机器人提供一致且用户友好的体验。

实际案例：

假设您是一家提供外卖服务的餐厅，您可以利用命令来帮助用户快速下单。比如，用户输入/order，机器人会展示一个预设菜单，允许用户直接选择他们想要的菜品。进一步，机器人可以通过/cancel来取消订单，或通过/track来查看订单状态。这些命令帮助减少了用户与客服的交互次数，提高了效率。

2. 键盘和按钮

为了提升用户体验，Telegram 机器人提供了自定义键盘和按钮。用户可以通过点击按钮来选择预设的选项，而不需要输入文本。

机器人能够解释用户的自由文本输入，但提供具体的建议通常更直观——这是自定义键盘非常有用的地方。

每当您的机器人发送消息时，它都可以显示带有预定义回复选项的特殊键盘（请参阅ReplyKeyboardMarkup）。接收消息的 Telegram 应用程序将向用户显示您的键盘。使用任何按钮都会立即发送相应的文本。这样，您可以大大简化和简化用户与机器人的交互。

您还可以通过设置参数自定义输入字段中的文本占位符input_field_placeholder。

直列键盘

有时您可能希望在不向聊天发送任何消息的情况下执行操作 - 例如当用户更改设置、切换选项或浏览搜索结果时。在这种情况下，您可以使用直接显示在相关消息下方的内联键盘。

与自定义回复键盘不同，按下内联键盘上的按钮不会向聊天发送消息。相反，内联键盘支持可以在后台工作或打开不同界面的按钮：回调按钮、URL 按钮、切换到内联按钮、游戏按钮和支付按钮。

注意：为了提供更好的用户体验，请考虑在用户切换设置按钮或导航到新页面时编辑键盘- 这比发送全新的消息并删除前一条消息更快、更流畅。

实际案例：

在一个在线旅游预定系统中，用户与机器人互动时，机器人可以展示自定义的按钮，如“预定机票”、“查看酒店”或“查看旅游套餐”。用户点击相应按钮，系统就能自动识别其需求并进行后续操作，从而极大简化了用户的操作流程。

3. 内联模式与深度链接

Telegram 机器人支持内联查询和深度链接功能，允许用户直接从任何聊天中与机器人互动。内联模式可以让用户直接向机器人发起查询，而无需离开当前的聊天界面。

用户可以直接从任何聊天中的消息字段通过内联查询与您的机器人互动。他们只需以您的机器人的@用户名开头发送消息并输入关键字即可。

收到查询后，您的机器人可以返回一些结果。一旦用户选择一个结果，它就会被发送到相关聊天。这样，人们就可以在任何聊天、群组或频道中请求和发送来自您的机器人的内容。

请记住，必须通过@BotFather启用内联功能，否则您的机器人将不会收到内联更新。

Telegram 机器人具有深度链接机制，允许在启动时将其他参数传递给机器人。这可能是启动机器人的命令，也可能是将用户的 Telegram 帐户连接到另一个平台的帐户的身份验证令牌。

每个机器人都有一个链接，可以在 Telegram 中打开与其的对话https://t.me/<bot_username>- 。可以直接将参数添加到此链接，让您的机器人即时处理其他信息，而无需任何用户输入。

允许使用AZ、az、0-9、_和-，建议使用base64url对二进制等内容类型的参数进行编码，参数最长为64个字符

注意：内联机器人的示例包括@gif、@bing和@wiki。Web应用机器人也可以内联使用 - 尝试在任何聊天中输入@durgerkingbot。

实际案例：

例如，用户在一个群聊中提到一个旅游地点，机器人通过内联查询直接展示该目的地的详细信息或相关产品。例如，用户输入@TravelBot Paris，机器人返回关于巴黎的旅游推荐、机票价格或酒店信息。这种无缝的互动模式极大提升了用户体验。

4. 小程序与Web集成

Telegram 机器人还支持小程序和Web集成功能，可以在机器人中内嵌应用程序，提供更丰富的互动内容。例如，您可以直接在Telegram内嵌入一个小游戏或业务管理面板。

小程序让开发者可以创建无限灵活的界面，直接在 Telegram 内部启动——与应用程序无缝集成并取代任何网站。

如果您的机器人是迷你应用，您可以向机器人的个人资料添加显眼的启动应用按钮以及演示视频和屏幕截图。为此，请转到@BotFather并设置您的机器人的主迷你应用。

我们的专门指南详细介绍了小程序——您应该仔细阅读以了解它们可以提供的各种功能。

小程序与 Telegram无缝集成——从接收详细的主题设置到使用原生对话框读取二维码、控制生物识别、直接将媒体分享到故事等等。

当从群组中的直接链接chat_instance打开时，小程序还可以使用参数来跟踪当前上下文，支持多个聊天成员共享使用——创建实时白板、群组订单、多人游戏等。

从小程序到故事的分享

小程序创建的任何媒体，如白板快照、排行榜和 AI 生成的视频，都可以通过shareToStory方法使用原生故事编辑器打开，用户可以直接从小程序以Telegram Story形式分享。

注意：小程序还会接收许多事件，从而能够立即对用户的操作做出反应。您可以在此处详细了解有哪些事件可用

实际案例：

假设您运营一个在线教育平台，您可以通过Telegram机器人向学生提供课程内容预览或实时互动的学习小程序。学生无需离开Telegram应用就能完成课程学习和互动。

通过Web集成，您还可以实现在线支付功能。比如，用户通过Telegram机器人选择课程并进行支付，而所有的付款信息都通过集成的支付网关直接发送给相关的支付提供商进行处理。

5. 支付与商业机器人

Telegram 机器人不仅限于提供服务或信息，还可以通过集成支付系统来完成交易。商家可以通过机器人的支付接口接受用户的付款，支持各种第三方支付提供商。

机器人可以启用商业模式，允许Telegram 商业用户将它们连接到他们的帐户 - 以简化和自动化私人聊天管理和与客户的互动。

账户所有者可以指定您的机器人可以访问哪些聊天 - 在这些聊天中，机器人将收到Bot API通常支持的所有更新，但其自身和其他机器人发送的消息除外。根据业务连接设置，您的机器人可能还能够在过去 24 小时内活跃的聊天中代表账户所有者发送消息并执行其他操作。

以下是将您的机器人与 Telegram Business 集成的快速入门指南：

在@BotFather中为您的机器人启用商业模式。
处理传入的BusinessConnection更新，表示用户已与您的机器人建立、编辑或结束业务连接。
business_message通过处理、edited_business_message和更新来处理业务消息deleted_business_messages。
can_reply通过最新的BusinessConnection更新检查您的机器人的写入权限。
如果允许，请使用sendMessage、sendChatActionbusiness_connection_id和其他发送方法中的字段代表企业用户进行沟通。