Please check out this new WEBHOOK GUIDE to learn all there is to know about webhooks!
-I'm having trouble with my self-signed certificate!
-Please take a look at this self-signed certificate guide we made just for you. If you've read it and still have a question, ping us on botsupport.
-How can I make sure that Webhook requests are coming from Telegram?
-If you'd like to make sure that the Webhook request comes from Telegram, we recommend using a secret path in the URL you give us, e.g. www.example.com/your_token. Since nobody else knows your bot's token, you can be pretty sure it's us.
-How can I make requests in response to updates?
-This is possible if you're using webhooks. The upside is that you need less requests, the downside — that in this case it's not possible to know that such a request was successful or get its result.
+I'm having trouble with my self-signed certificate!
+Please take a look at this self-signed certificate guide we made just for you. If you've read it and still have a question, ping us on botsupport.
+How can I make sure that Webhook requests are coming from Telegram?
+If you'd like to make sure that the Webhook request comes from Telegram, we recommend using a secret path in the URL you give us, e.g. www.example.com/your_token. Since nobody else knows your bot's token, you can be pretty sure it's us.
+How can I make requests in response to updates?
+This is possible if you're using webhooks. The upside is that you need less requests, the downside — that in this case it's not possible to know that such a request was successful or get its result.
Whenever you receive a webhook update, you have two options:
-1. Issue POST to https://api.telegram.org/bot<token>/method
+1. Issue POST to https://api.telegram.org/bot<token>/method
2. Reply directly and give method as JSON payload in the reply
-You may also want to look at our sample HelloBot, it offers a PHP implementation of this.
Handling Media
-How do I download files?
+Handling Media
+How do I download files?
Use the getFile method. Please note that this will only work with files of up to 20 MB in size.
-How do I upload a large file?
-Bots can currently send files of any type of up to 50 MB in size, so yes, very large files won't work for now. Sorry. This limit may be changed in the future.
-Can I count on file_ids to be persistent?
+How do I upload a large file?
+Bots can currently send files of any type of up to 50 MB in size, so yes, very large files won't work for now. Sorry. This limit may be changed in the future.
+Can I count on file_ids to be persistent?
Yes, file_ids can be treated as persistent.
-Broadcasting to Users
-My bot is hitting limits, how do I avoid this?
-When sending messages inside a particular chat, avoid sending more than one message per second. We may allow short bursts that go over this limit, but eventually you'll begin receiving 429 errors.
-If you're sending bulk notifications to multiple users, the API will not allow more than 30 messages per second or so. Consider spreading out notifications over large intervals of 8—12 hours for best results.
+Broadcasting to Users
+My bot is hitting limits, how do I avoid this?
+When sending messages inside a particular chat, avoid sending more than one message per second. We may allow short bursts that go over this limit, but eventually you'll begin receiving 429 errors.
+If you're sending bulk notifications to multiple users, the API will not allow more than 30 messages per second or so. Consider spreading out notifications over large intervals of 8—12 hours for best results.
Also note that your bot will not be able to send more than 20 messages per minute to the same group.
-How can I message all of my bot's subscribers at once?
-Unfortunately, at this moment we don't have methods for sending bulk messages, e.g. notifications. We may add something along these lines in the future.
-In order to avoid hitting our limits when sending out mass notifications, consider spreading them over longer intervals, e.g. 8-12 hours. The API will not allow bulk notifications to more than ~30 users per second, if you go over that, you'll start getting 429 errors.
+How can I message all of my bot's subscribers at once?
+Unfortunately, at this moment we don't have methods for sending bulk messages, e.g. notifications. We may add something along these lines in the future.
+In order to avoid hitting our limits when sending out mass notifications, consider spreading them over longer intervals, e.g. 8-12 hours. The API will not allow bulk notifications to more than ~30 users per second, if you go over that, you'll start getting 429 errors.
See also: How to avoid hitting limits?
-+If you've got questions that are not answered on this page, ping us at @BotSupport in Telegram. -We welcome any suggestions for the Bot Platform and API.
-
If you've got questions that are not answered on this page, ping us at @BotSupport in Telegram.
We welcome any suggestions for the Bot Platform and API.