#setWebhook
使用此方法指定一个 URL,机器人有更新时将通过 HTTPS POST 向该地址推送 JSON 序列化的 Update 对象。请求失败(非 2xx)会自动重试并在多次尝试后放弃。成功返回 True。
参数
| 参数 | 类型 | 必需 | 说明 |
|---|---|---|---|
| url | String | Yes | HTTPS 回调地址;传空字符串可删除 Webhook |
| certificate | InputFile | Optional | 自签名证书公钥(当前版本不支持,请使用受信任证书) |
| ip_address | String | Optional | 固定回调源 IP(当前版本不支持) |
| max_connections | Integer | Optional | 回调最大并发连接数 1–100,默认 40 |
| allowed_updates | Array of String | Optional | JSON 序列化的更新类型白名单;空数组表示接收除 chat_member 外全部类型 |
| drop_pending_updates | Boolean | Optional | 设置为 True 时丢弃设置前积累的更新 |
| secret_token | String | Optional | 1–256 位密钥;设置后每次回调都带请求头 X-Telegram-Bot-Api-Secret-Token |
示例
curl -X POST "https://mivra.im/bot<TOKEN>/setWebhook" -H "Content-Type: application/json" -d '{"url":"https://example.com/webhook","secret_token":"my-secret-123","max_connections":40}'
备注
Webhook 端口仅支持 443、80、88、8443。
只要设置了 Webhook,getUpdates 就不再返回更新。
请始终校验 secret_token 请求头,防止伪造回调。
