Telegram Bot API
🌐 中文

setWebhook

分类: 更新 · Bot API 10.3 · 官方文档

设置 Webhook。

返回值: 调用成功时返回 True。

参数

参数类型必填说明
urlString是Webhook URL（空字符串 = 删除）
certificateInputFile可选公钥证书（用于自签名证书）
ip_addressString可选Webhook 的 IP 地址
max_connectionsInteger可选最大连接数（1-100，默认 40）
allowed_updatesArray of String可选更新类型的 JSON 数组
drop_pending_updatesBoolean可选丢弃待处理的更新
secret_tokenString可选用于 X-Telegram-Bot-Api-Secret-Token 的密钥令牌

参数说明为简要概括，完整内容请参阅官方文档。

请求示例

curl

curl -s -X POST "https://api.telegram.org/bot$TOKEN/setWebhook" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/telegram/webhook"}'

Python

import requests

TOKEN = "123456789:AAEexampleTokenReplaceWithYours"
resp = requests.post(
    f"https://api.telegram.org/bot{TOKEN}/setWebhook",
    json={
        "url": "https://example.com/telegram/webhook"
    },
    timeout=30,
)
print(resp.json())

JavaScript

const TOKEN = "123456789:AAEexampleTokenReplaceWithYours";
const res = await fetch(`https://api.telegram.org/bot${TOKEN}/setWebhook`, {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    "url": "https://example.com/telegram/webhook"
  }),
});
console.log(await res.json());

分步教程: Telegram Bot Webhook 设置教程：用 setWebhook 配置 Webhook URL 和 secret_token