Use this method to specify a url and receive incoming updates via an outgoing webhook.

Log in to see full request history
timestatususer agent
Retrieving recent requests…
LoadingLoading…

Use this method to specify a URL and receive incoming updates via an outgoing webhook. Whenever there is an update for the bot, we will send an HTTPS POST request to the specified URL, containing a JSON-serialized Update. In case of an unsuccessful request, we will give up after a reasonable amount of attempts.

If you'd like to make sure that the Webhook request comes from Telegram, we recommend using a secret path in the URL, e.g. https://www.example.com/{token}. Since nobody else knows your bot‘s token, you can be pretty sure it’s us.

See setWebhook official docs for a list of supported parameters and other info.

📘

Notes

1. You will not be able to receive updates using getUpdates for as long as an outgoing webhook is set up.
2. To use a self-signed certificate, you need to upload your public key certificate using the certificate parameter. Please upload as InputFile, sending a String will not work.
3. Ports currently supported for Webhooks: 443, 80, 88, 8443.

Path Params
string
required

Your Bot Token

Body Params
string
Defaults to Optional

HTTPS url to send updates to. Use an empty string to remove webhook integration

file
Defaults to Optional

Upload your public key certificate so that the root certificate in use can be checked. See our self-signed guide https://core.telegram.org/bots/self-signed for details.

Responses

Language
Request
Click Try It! to start a request and see the response here! Or choose an example:
application/json