TelegramBot

一般问题

我如何创建一个机器人？

创建Telegram机器人是非常容易的，但你至少需要一些计算机编程技能。为了使机器人能够正常工作，请在@BotFather设置一个机器人账户，然后通过我们的API将其连接到你的后台服务器。

不幸的是，如果你不是一个开发人员，没有开箱即用的方法来创建一个工作的机器人。但我们相信，你很快就会发现有很多由其他人创建的机器人可以玩。

我是一个开发者。我在哪里可以找到一些例子？

这里有两个机器人的例子，都是用PHP写的：

• Hello Bot 演示了Telegram机器人API的基础知识。
• Simple Poll bot 是一个更完整的例子，它支持长时间的投票和Webhooks的更新。

我们社区的许多成员都在建立机器人并发布来源。
我们在这个页面上收集了它们。

如果你已经建立了一个机器人并希望与他人分享，请在@BotSupport上与我们联系。

你会向机器人API添加X吗？

机器人API仍然相当年轻。有许多潜在的功能需要考虑和实现。我们将在一段时间内研究人们用他们的机器人做什么，看看哪些方向对平台来说是最重要的。

欢迎所有机器人开发者与我们的@BotSupport账户分享对我们的机器人API的想法。

我的机器人会得到哪些信息？

1. 所有机器人，无论设置如何，都会收到：

• 所有的服务信息。
• 与用户私下聊天的所有信息。
• 来自他们是成员的频道的所有信息。

2. 禁用隐私模式的机器人管理员和机器人将收到所有的消息，除了其他机器人发送的消息。

3. 启用隐私模式的机器人将收到：

• 如果该机器人是最后一个向群组发送消息的机器人，那么来自用户的一般命令（例如：/start）。
• 通过这个机器人发送的信息。
• 对任何隐含或明确针对该机器人的信息的回复。

请注意，每个特定的消息在同一时间只能对一个启用了隐私的机器人可用，即，对机器人A的回复包含对机器人B的明确命令或通过机器人C发送的消息将只对机器人A可用，回复具有最高的优先权。

为什么我的机器人看不到其他机器人的信息？

机器人之间的对话有可能陷入不受欢迎的循环中。为了避免这种情况，我们决定，无论何种模式，机器人都不能看到来自其他机器人的信息。

获得更新

我如何获得更新？

目前有两种获得更新的方式。你可以使用长期轮询或Webhooks。请注意，在设置了出站的Webhook的情况下，不可能通过长时间轮询获得更新。

长时间轮询会让我一次又一次地得到相同的更新!

getUpdates方法返回最早的100个未确认的更新。要确认一个更新，在调用getUpdates时使用offset参数，像这样：

offset = update_id of last processed update + 1

所有update_id小于或等于offset的更新将在服务器上被标记为确认，并不再被返回。

我在使用Webhooks时遇到了问题。

如果你已经成功设置了你的Webhook，但没有得到任何更新，请记住：

• 你需要一个有效的SSL证书才能让Webhooks工作。
• 要使用自签名证书，你需要使用setWebhook中的证书参数上传你的公钥证书。请以输入文件的形式上传，发送一个字符串将不起作用。
• 目前支持Webhooks的端口：443, 80, 88, 8443.
• 通配符证书可能不被支持。
• 不支持重定向。
• CN必须与你的域名完全匹配。

请查看这个新的WEBHOOK指南，以了解关于WEBHOOK的所有知识!

我的自签名证书有问题!

请看看我们专门为您制作的自签名证书指南。如果你读完后仍有问题，请在botsupport上与我们联系。

我怎样才能确保Webhook请求来自Telegram？

如果你想确保Webhook请求来自Telegram，我们建议在你给我们的URL中使用一个秘密路径，例如：www.example.com/your_token。因为没有其他人知道你的机器人的令牌，所以你可以很确定是我们。

我怎样才能在更新时提出请求？

如果你使用webhooks，这是有可能的。好处是你需要更少的请求，坏处是在这种情况下，不可能知道这样的请求是否成功或得到其结果。

每当你收到一个webhook更新，你有两个选择：

1. 发出POST到https://api.telegram.org/bot<token>/方法

2. 2. 直接回复并在回复中给出方法作为JSON有效载荷

你可能还想看看我们的样本HelloBot，它提供了一个这样的PHP实现。

处理媒体

我如何下载文件？

使用getFile方法。请注意，这只对大小不超过20MB的文件有效。

我如何上传一个大文件？

目前，机器人可以发送大小不超过50MB的任何类型的文件，所以是的，非常大的文件目前还不能使用。对不起。这个限制在未来可能会被改变。

我可以指望file_ids是持久的吗？

是的，file_ids可以被视为持久性的。

向用户广播

我的机器人遇到了限制，我如何避免这种情况？

当在一个特定的聊天室内发送消息时，避免每秒发送超过一条消息。我们可能会允许短时间内超过这个限制，但最终你会开始收到429错误。

如果您要向多个用户批量发送通知，API不允许每秒钟超过30条左右的消息。考虑将通知分散在8-12小时的大间隔内，以获得最佳效果。

还要注意的是，你的机器人将不能每分钟向同一群体发送超过20条信息。

我怎样才能一次给我的机器人的所有用户发信息？

不幸的是，目前我们还没有发送批量信息的方法，例如通知。我们可能会在未来添加一些类似的功能。

为了避免在群发通知时触及我们的限制，可以考虑将它们分散在较长的时间间隔内，例如8-12小时。API不允许每秒钟向超过30个用户群发通知，如果你超过了，你将开始收到429个错误。

参见：如何避免触及限制？

如果你有本页面没有回答的问题，请在Telegram的@BotSupport上与Telegram联系。
Telegram欢迎对机器人平台和API的任何建议。