homeassistant 2025.6.3__py3-none-any.whl → 2025.7.0b1__py3-none-any.whl

homeassistant/components/telegram_bot/translations/zh-Hant.json

@@ -1,12 +1,152 @@
 {
+    "config": {
+        "abort": {
+            "already_configured": "\u670d\u52d9\u5df2\u7d93\u8a2d\u5b9a\u5b8c\u6210",
+            "reauth_successful": "\u91cd\u65b0\u8a8d\u8b49\u6210\u529f",
+            "reconfigure_successful": "\u91cd\u65b0\u8a2d\u5b9a\u6210\u529f"
+        },
+        "error": {
+            "invalid_api_key": "API \u91d1\u9470\u7121\u6548",
+            "invalid_proxy_url": "{proxy_url_error}",
+            "invalid_trusted_networks": "\u4fe1\u4efb\u7db2\u8def\u7121\u6548\uff1a{error_message}",
+            "invalid_url": "\u7db2\u5740\u5fc5\u9808\u4ee5 https \u958b\u982d",
+            "no_url_available": "\u7531\u65bc\u5c1a\u672a\u5728 Home Assistant \u4e2d\u8a2d\u5b9a\u5916\u90e8\u7db2\u5740\uff0c\u56e0\u6b64\u9700\u8981\u63d0\u4f9b\u7db2\u5740"
+        },
+        "step": {
+            "reauth_confirm": {
+                "data": {
+                    "api_key": "API \u91d1\u9470"
+                },
+                "data_description": {
+                    "api_key": "\u6a5f\u5668\u4eba API \u6b0a\u6756"
+                },
+                "title": "\u91cd\u65b0\u8a8d\u8b49 Telegram \u6a5f\u5668\u4eba"
+            },
+            "reconfigure": {
+                "data": {
+                    "platform": "\u5e73\u53f0"
+                },
+                "data_description": {
+                    "platform": "Telegram \u6a5f\u5668\u4eba\u5be6\u4f5c"
+                },
+                "description": "\u91cd\u65b0\u8a2d\u5b9a Telegram \u6a5f\u5668\u4eba",
+                "title": "Telegram \u6a5f\u5668\u4eba\u8a2d\u5b9a"
+            },
+            "user": {
+                "data": {
+                    "platform": "\u5e73\u53f0"
+                },
+                "data_description": {
+                    "api_key": "\u6a5f\u5668\u4eba API \u6b0a\u6756",
+                    "platform": "Telegram \u6a5f\u5668\u4eba\u5be6\u4f5c"
+                }
+            },
+            "webhooks": {
+                "data": {
+                    "trusted_networks": "\u4fe1\u4efb\u7db2\u8def",
+                    "url": "\u7db2\u5740"
+                },
+                "data_description": {
+                    "trusted_networks": "Telegram \u4f3a\u670d\u5668\u5b58\u53d6 ACL \u5217\u8868\u3002\n\u9810\u8a2d\u503c\uff1a149.154.160.0/20, 91.108.4.0/22",
+                    "url": "\u5141\u8a31\u7531 Home Assistant \u8a2d\u5b9a\u4e2d\u8986\u5beb\u5916\u90e8\u7db2\u5740\uff0c\u4ee5\u9069\u61c9\u4e0d\u540c\u7684\u8a2d\u5b9a\u3002"
+                },
+                "title": "Webhooks \u7db2\u8def\u8a2d\u5b9a"
+            }
+        }
+    },
+    "config_subentries": {
+        "allowed_chat_ids": {
+            "abort": {
+                "already_configured": "\u804a\u5929\u5ba4\u5df2\u7d93\u8a2d\u5b9a"
+            },
+            "error": {
+                "chat_not_found": "\u627e\u4e0d\u5230\u804a\u5929\u5ba4"
+            },
+            "initiate_flow": {
+                "user": "\u65b0\u589e\u5141\u8a31\u804a\u5929\u5ba4 ID"
+            },
+            "step": {
+                "user": {
+                    "data": {
+                        "chat_id": "\u804a\u5929\u5ba4 ID"
+                    },
+                    "data_description": {
+                        "chat_id": "\u4ee3\u8868\u53ef\u4ee5\u5411\u5176\u50b3\u9001\u8a0a\u606f\u7684\u4f7f\u7528\u8005\u6216\u7fa4\u7d44\u804a\u5929\u5ba4 ID\u3002"
+                    },
+                    "title": "\u65b0\u589e\u804a\u5929\u5ba4"
+                }
+            }
+        }
+    },
+    "exceptions": {
+        "allowlist_external_dirs_error": {
+            "message": "allowlist_external_dirs \u4e2d\u5c1a\u672a\u8a2d\u5b9a\u6a94\u6848\u8def\u5f91\u3002"
+        },
+        "failed_to_load_file": {
+            "message": "\u8f09\u5165\u6a94\u6848\u5931\u6557\uff1a{error}"
+        },
+        "failed_to_load_url": {
+            "message": "\u8f09\u5165\u7db2\u5740\u5931\u6557\uff1a{error}"
+        },
+        "missing_allowed_chat_ids": {
+            "message": "\u627e\u4e0d\u5230\u5141\u8a31\u7684\u804a\u5929\u5ba4 ID\u3002\u8acb\u5148\u70ba {bot_name}.\u65b0\u589e\u5141\u8a31\u804a\u5929\u5ba4 ID\u3002"
+        },
+        "missing_config_entry": {
+            "message": "\u627e\u4e0d\u5230\u8a2d\u5b9a\u689d\u76ee\u6216\u8a2d\u5b9a\u5931\u6557\u3002\u8acb\u5148\u8a2d\u5b9a Telegram \u6a5f\u5668\u4eba\u3002"
+        },
+        "missing_input": {
+            "message": "{field} \u70ba\u5fc5\u586b\u3002"
+        },
+        "multiple_config_entry": {
+            "message": "\u627e\u5230\u591a\u500b\u8a2d\u5b9a\u689d\u76ee\u3002\u8acb\u5728\u8a2d\u5b9a\u689d\u76ee ID \u6b04\u4f4d\u4e2d\u6307\u5b9a\u6240\u8981\u4f7f\u7528\u7684 Telegram \u6a5f\u5668\u4eba\u3002"
+        }
+    },
     "issues": {
+        "deprecated_yaml": {
+            "description": "\u4f7f\u7528 YAML \u8a2d\u5b9a\u7684 {integration_title} \u5373\u5c07\u9032\u884c\u79fb\u9664\u3002\n\n\u65e2\u6709\u7684 YAML \u8a2d\u5b9a\u5c07\u81ea\u52d5\u532f\u5165\u81f3 UI \u5167\u3002\n\n\u8acb\u65bc configuration.yaml \u6a94\u6848\u4e2d\u79fb\u9664 `{domain}` \u8a2d\u5b9a\u4e26\u91cd\u65b0\u555f\u52d5 Home Assistant \u4ee5\u4fee\u6b63\u6b64\u554f\u984c\u3002",
+            "title": "{integration_title} YAML \u8a2d\u5b9a\u5373\u5c07\u79fb\u9664"
+        },
+        "deprecated_yaml_import_issue_error": {
+            "description": "\u4f7f\u7528 YAML \u8a2d\u5b9a\u7684 {integration_title} \u6574\u5408\u5df2\u9032\u884c\u79fb\u9664\u3001\u4f46\u65bc\u532f\u5165\u73fe\u6709\u8a2d\u5b9a ({telegram_bot}) \u6642\u51fa\u73fe\u932f\u8aa4\uff1a{error_message}\u3002\n\u8a2d\u5b9a\u5c07\u7121\u6cd5\u7e7c\u7e8c\u3002\n\n\u8acb\u78ba\u8a8d {telegram_bot} \u662f\u5426\u6b63\u5e38\u5de5\u4f5c\u3001\u4e26\u91cd\u65b0\u555f\u52d5 Home Assistant \u4ee5\u91cd\u65b0\u5617\u8a66\u532f\u5165\u3002\n\n\u6216\u8005\uff0c\u4e5f\u53ef\u4ee5\u5b8c\u5168\u7531 configuration.yaml \u8a2d\u5b9a\u4e2d\u79fb\u9664 `{domain}`\u3001\u91cd\u65b0\u555f\u52d5 Home Assistant\uff0c\u4e26\u624b\u52d5\u65b0\u589e {integration_title} \u6574\u5408\u3002",
+            "title": "{error_field} \u7121\u6548\u3001YAML \u532f\u5165\u5931\u6557"
+        },
+        "deprecated_yaml_import_issue_has_more_platforms": {
+            "description": "\u4f7f\u7528 YAML \u8a2d\u5b9a\u7684 {integration_title} \u7684\u5373\u5c07\u9032\u884c\u79fb\u9664\u3002\n\n\u73fe\u6709\u7684 YAML \u8a2d\u5b9a\u4e2d\u7684\u6700\u5f8c\u4e00\u500b\u689d\u76ee ({telegram_bot}) \u5df2\u81ea\u52d5\u532f\u5165\u81f3\u4f7f\u7528\u8005\u4ecb\u9762\u3002\n\n\u8acb\u65bc configuration.yaml \u6a94\u6848\u4e2d\u79fb\u9664 `{domain}` \u8a2d\u5b9a\u4e26\u91cd\u65b0\u555f\u52d5 Home Assistant \u4ee5\u4fee\u6b63\u6b64\u554f\u984c\u3002\u5176\u4ed6 Telegram \u6a5f\u5668\u4eba\u9700\u8981\u5728\u4f7f\u7528\u8005\u4ecb\u9762\u4e2d\u9032\u884c\u624b\u52d5\u8a2d\u5b9a\u3002",
+            "title": "{integration_title} YAML \u8a2d\u5b9a\u5373\u5c07\u79fb\u9664"
+        },
         "proxy_params_auth_deprecation": {
             "description": "{telegram_bot} \u6574\u5408\u4e2d\u8a2d\u5b9a\u7684\u4ee3\u7406\u7684\u9a57\u8b49\u8cc7\u6599\u61c9\u8a72\u79fb\u5165 {proxy_url} \u4e2d\u3002\u8acb\u66f4\u65b0\u8a2d\u5b9a\u4e26\u91cd\u65b0\u555f\u52d5 Home Assistant \u4ee5\u89e3\u6c7a\u6b64\u554f\u984c\u3002\n\n{proxy_params} \u8a2d\u5b9a\u9375\u5c07\u5728\u672a\u4f86\u7684\u7248\u672c\u4e2d\u9032\u884c\u79fb\u9664\u3002",
             "title": "{telegram_bot}: Proxy \u8a8d\u8b49\u5c07\u79fb\u81f3 URL"
+        }
+    },
+    "options": {
+        "step": {
+            "init": {
+                "data": {
+                    "parse_mode": "\u89e3\u6790\u6a21\u5f0f"
+                },
+                "data_description": {
+                    "parse_mode": "\u5982\u679c\u8a0a\u606f\u8cc7\u6599\u4e2d\u672a\u660e\u78ba\u6307\u5b9a\uff0c\u5247\u70ba\u8a0a\u606f\u7684\u9810\u8a2d\u89e3\u6790\u6a21\u5f0f\u3002"
+                },
+                "title": "\u8a2d\u5b9a Telegram \u6a5f\u5668\u4eba"
+            }
+        }
+    },
+    "selector": {
+        "parse_mode": {
+            "options": {
+                "html": "HTML",
+                "markdown": "Markdown (\u820a\u7248)",
+                "markdownv2": "MarkdownV2",
+                "plain_text": "\u7d14\u6587\u5b57"
+            }
         },
-        "proxy_params_deprecation": {
-            "description": "\u5c07\u5728\u672a\u4f86\u7684\u7248\u672c\u4e2d\u79fb\u9664 {telegram_bot} \u6574\u5408\u7684 {proxy_params} \u8a2d\u5b9a\u9375\u3002\n\n\u76ee\u524d\u53ef\u901a\u904e {proxy_url} \u9375\u9032\u884c\u8eab\u4efd\u9a57\u8b49\u3002\n\n\u5e95\u5c64\u8cc7\u6599\u5eab\u5df2\u66f4\u6539\u70ba {httpx}\u3001\u8207\u5148\u524d\u7684\u53c3\u6578\u4e0d\u76f8\u5bb9\u3002\u5982\u679c\u4ecd\u9700\u8981\u6b64\u529f\u80fd\u4f86\u9032\u884c\u5176\u4ed6\u9078\u9805\uff0c\u8acb\u5728\u4e86\u89e3\u66f4\u591a\u9023\u7d50\u4e2d\u4e0a\u7559\u4e0b\u8a55\u8ad6\u3002\n\n\u8acb\u66f4\u65b0\u8a2d\u5b9a\u4ee5\u79fb\u9664 {proxy_params} \u9375\uff0c\u4e26\u91cd\u65b0\u555f\u52d5 Home Assistant \u4ee5\u89e3\u6c7a\u6b64\u554f\u984c\u3002",
-            "title": "{telegram_bot}: Proxy \u53c3\u6578\u9078\u9805\u5c07\u9032\u884c\u79fb\u9664"
+        "platforms": {
+            "options": {
+                "broadcast": "\u5ee3\u64ad",
+                "polling": "\u6295\u7968",
+                "webhooks": "Webhooks"
+            }
         }
     },
     "services": {
@@ -17,6 +157,10 @@
                     "description": "Callback \u56de\u61c9\u552f\u4e00 ID\u3002",
                     "name": "Callback \u67e5\u8a62 ID"
                 },
+                "config_entry_id": {
+                    "description": "\u4ee3\u8868 Telegram \u6a5f\u5668\u4eba\u56de\u8986 Callback \u8a2d\u5b9a\u689d\u76ee\u3002",
+                    "name": "\u8a2d\u5b9a\u689d\u76ee ID\u3002"
+                },
                 "message": {
                     "description": "\u901a\u77e5\u8a0a\u606f\u672a\u683c\u5f0f\u5316\u5167\u5bb9\u3002",
                     "name": "\u8a0a\u606f"
@@ -39,6 +183,10 @@
                     "description": "\u522a\u9664\u8a0a\u606f\u7684\u804a\u5929 ID\u3002",
                     "name": "\u804a\u5929\u5ba4 ID"
                 },
+                "config_entry_id": {
+                    "description": "\u4ee3\u8868 Telegram \u6a5f\u5668\u4eba\u522a\u9664\u8a0a\u606f\u8a2d\u5b9a\u689d\u76ee\u3002",
+                    "name": "\u8a2d\u5b9a\u689d\u76ee ID\u3002"
+                },
                 "message_id": {
                     "description": "\u6b32\u522a\u9664\u8a0a\u606f ID\u3002",
                     "name": "\u8a0a\u606f ID"
@@ -57,6 +205,10 @@
                     "description": "\u7de8\u8f2f\u6a19\u984c\u7684\u804a\u5929 ID\u3002",
                     "name": "\u804a\u5929\u5ba4 ID"
                 },
+                "config_entry_id": {
+                    "description": "\u4ee3\u8868 Telegram \u6a5f\u5668\u4eba\u7de8\u8f2f\u6a19\u984c\u8a2d\u5b9a\u689d\u76ee\u3002",
+                    "name": "\u8a2d\u5b9a\u689d\u76ee ID\u3002"
+                },
                 "inline_keyboard": {
                     "description": "\u88fd\u4f5c\u81ea\u8a02 inline \u9375\u76e4\u5e36\u6709\u95dc\u806f callback \u8cc7\u6599\u6309\u9215\u7684\u547d\u4ee4\u884c\u5217\u8868\u3001\u4ee5\u9017\u865f\u5206\u9694\u3002",
                     "name": "\u5167\u5d4c\u9375\u76e4"
@@ -75,6 +227,10 @@
                     "description": "\u7de8\u8f2f\u8a0a\u606f\u7684\u804a\u5929 ID\u3002",
                     "name": "\u804a\u5929\u5ba4 ID"
                 },
+                "config_entry_id": {
+                    "description": "\u4ee3\u8868 Telegram \u6a5f\u5668\u4eba\u7de8\u8f2f\u8a0a\u606f\u8a2d\u5b9a\u689d\u76ee\u3002",
+                    "name": "\u8a2d\u5b9a\u689d\u76ee ID\u3002"
+                },
                 "disable_web_page_preview": {
                     "description": "\u95dc\u9589\u8a0a\u606f\u4e2d\u7684\u9023\u7d50\u9810\u89bd\u3002",
                     "name": "\u95dc\u9589\u7db2\u9801\u9810\u89bd"
@@ -109,6 +265,10 @@
                     "description": "\u7de8\u8f2f\u56de\u8986\u6a19\u8a18\u7684\u804a\u5929 ID\u3002",
                     "name": "\u804a\u5929\u5ba4 ID"
                 },
+                "config_entry_id": {
+                    "description": "\u4ee3\u8868 Telegram \u6a5f\u5668\u4eba\u7de8\u8f2f\u56de\u8986\u8a2d\u5b9a\u689d\u76ee\u3002",
+                    "name": "\u8a2d\u5b9a\u689d\u76ee ID\u3002"
+                },
                 "inline_keyboard": {
                     "description": "\u88fd\u4f5c\u81ea\u8a02 inline \u9375\u76e4\u5e36\u6709\u95dc\u806f callback \u8cc7\u6599\u6309\u9215\u7684\u547d\u4ee4\u884c\u5217\u8868\u3001\u4ee5\u9017\u865f\u5206\u9694\u3002",
                     "name": "\u5167\u5d4c\u9375\u76e4"
@@ -120,6 +280,20 @@
             },
             "name": "\u7de8\u8f2f\u56de\u8986\u6a19\u8a18"
         },
+        "leave_chat": {
+            "description": "\u5f9e\u804a\u5929\u5ba4\u4e2d\u79fb\u9664\u6a5f\u5668\u4eba\u3002",
+            "fields": {
+                "chat_id": {
+                    "description": "\u6240\u8981\u79fb\u9664\u6a5f\u5668\u4eba\u7684\u7fa4\u7d44\u804a\u5929\u5ba4 ID\u3002",
+                    "name": "\u804a\u5929\u5ba4 ID"
+                },
+                "config_entry_id": {
+                    "description": "\u4ee3\u8868 Telegram \u6a5f\u5668\u4eba\u9000\u51fa\u804a\u5929\u5ba4\u8a2d\u5b9a\u689d\u76ee\u3002",
+                    "name": "\u8a2d\u5b9a\u689d\u76ee ID\u3002"
+                }
+            },
+            "name": "\u9000\u51fa\u804a\u5929\u5ba4"
+        },
         "send_animation": {
             "description": "\u50b3\u9001\u52d5\u756b\u3002",
             "fields": {
@@ -131,6 +305,10 @@
                     "description": "\u52d5\u756b\u6a19\u984c\u3002",
                     "name": "\u6a19\u984c"
                 },
+                "config_entry_id": {
+                    "description": "\u4ee3\u8868 Telegram \u6a5f\u5668\u4eba\u50b3\u9001\u52d5\u756b\u8a2d\u5b9a\u689d\u76ee\u3002",
+                    "name": "\u8a2d\u5b9a\u689d\u76ee ID\u3002"
+                },
                 "disable_notification": {
                     "description": "\u975c\u97f3\u50b3\u9001\u8a0a\u606f\u3002iOS \u7528\u6236\u8207 Web \u7528\u6236\u5c07\u4e0d\u6703\u6536\u5230\u901a\u77e5\uff0cAndroid \u7528\u6236\u5247\u6703\u6536\u5230\u4e00\u689d\u7121\u8072\u7684\u901a\u77e5\u3002",
                     "name": "\u95dc\u9589\u901a\u77e5"
@@ -201,6 +379,10 @@
                     "description": "\u6587\u4ef6\u6a19\u984c\u3002",
                     "name": "\u6a19\u984c"
                 },
+                "config_entry_id": {
+                    "description": "\u4ee3\u8868 Telegram \u6a5f\u5668\u4eba\u50b3\u9001\u6587\u4ef6\u8a2d\u5b9a\u689d\u76ee\u3002",
+                    "name": "\u8a2d\u5b9a\u689d\u76ee ID\u3002"
+                },
                 "disable_notification": {
                     "description": "\u975c\u97f3\u50b3\u9001\u8a0a\u606f\u3002iOS \u7528\u6236\u8207 Web \u7528\u6236\u5c07\u4e0d\u6703\u6536\u5230\u901a\u77e5\uff0cAndroid \u7528\u6236\u5247\u6703\u6536\u5230\u4e00\u689d\u7121\u8072\u7684\u901a\u77e5\u3002",
                     "name": "\u95dc\u9589\u901a\u77e5"
@@ -263,6 +445,10 @@
         "send_location": {
             "description": "\u50b3\u9001\u4f4d\u7f6e\u3002",
             "fields": {
+                "config_entry_id": {
+                    "description": "\u4ee3\u8868 Telegram \u6a5f\u5668\u4eba\u50b3\u9001\u4f4d\u7f6e\u8a2d\u5b9a\u689d\u76ee\u3002",
+                    "name": "\u8a2d\u5b9a\u689d\u76ee ID\u3002"
+                },
                 "disable_notification": {
                     "description": "\u975c\u97f3\u50b3\u9001\u8a0a\u606f\u3002iOS \u7528\u6236\u8207 Web \u7528\u6236\u5c07\u4e0d\u6703\u6536\u5230\u901a\u77e5\uff0cAndroid \u7528\u6236\u5247\u6703\u6536\u5230\u4e00\u689d\u7121\u8072\u7684\u901a\u77e5\u3002",
                     "name": "\u95dc\u9589\u901a\u77e5"
@@ -309,6 +495,10 @@
         "send_message": {
             "description": "\u50b3\u9001\u901a\u77e5\u3002",
             "fields": {
+                "config_entry_id": {
+                    "description": "\u4ee3\u8868 Telegram \u6a5f\u5668\u4eba\u50b3\u9001\u8a0a\u606f\u8a2d\u5b9a\u689d\u76ee\u3002",
+                    "name": "\u8a2d\u5b9a\u689d\u76ee ID\u3002"
+                },
                 "disable_notification": {
                     "description": "\u975c\u97f3\u50b3\u9001\u8a0a\u606f\u3002iOS \u7528\u6236\u8207 Web \u7528\u6236\u5c07\u4e0d\u6703\u6536\u5230\u901a\u77e5\uff0cAndroid \u7528\u6236\u5247\u6703\u6536\u5230\u4e00\u689d\u7121\u8072\u7684\u901a\u77e5\u3002",
                     "name": "\u95dc\u9589\u901a\u77e5"
@@ -371,6 +561,10 @@
                     "description": "\u5f71\u50cf\u6a19\u984c\u3002",
                     "name": "\u6a19\u984c"
                 },
+                "config_entry_id": {
+                    "description": "\u4ee3\u8868 Telegram \u6a5f\u5668\u4eba\u50b3\u9001\u7167\u7247\u8a2d\u5b9a\u689d\u76ee\u3002",
+                    "name": "\u8a2d\u5b9a\u689d\u76ee ID\u3002"
+                },
                 "disable_notification": {
                     "description": "\u975c\u97f3\u50b3\u9001\u8a0a\u606f\u3002iOS \u7528\u6236\u8207 Web \u7528\u6236\u5c07\u4e0d\u6703\u6536\u5230\u901a\u77e5\uff0cAndroid \u7528\u6236\u5247\u6703\u6536\u5230\u4e00\u689d\u7121\u8072\u7684\u901a\u77e5\u3002",
                     "name": "\u95dc\u9589\u901a\u77e5"
@@ -437,6 +631,10 @@
                     "description": "\u5982\u679c\u8a72\u6295\u7968\u5141\u8a31\u591a\u9078\u4f5c\u7b54\u3002",
                     "name": "\u5141\u8a31\u591a\u9078\u4f5c\u7b54"
                 },
+                "config_entry_id": {
+                    "description": "\u4ee3\u8868 Telegram \u6a5f\u5668\u4eba\u50b3\u9001\u6295\u7968\u8a2d\u5b9a\u689d\u76ee\u3002",
+                    "name": "\u8a2d\u5b9a\u689d\u76ee ID\u3002"
+                },
                 "disable_notification": {
                     "description": "\u975c\u97f3\u50b3\u9001\u8a0a\u606f\u3002iOS \u7528\u6236\u8207 Web \u7528\u6236\u5c07\u4e0d\u6703\u6536\u5230\u901a\u77e5\uff0cAndroid \u7528\u6236\u5247\u6703\u6536\u5230\u4e00\u689d\u7121\u8072\u7684\u901a\u77e5\u3002",
                     "name": "\u95dc\u9589\u901a\u77e5"
@@ -487,6 +685,10 @@
                     "description": "\u5b9a\u7fa9\u4f7f\u7528\u7684\u8eab\u4efd\u9a57\u8b49\u65b9\u5f0f\u3002\u8a2d\u5b9a\u70ba `digest` \u4ee5\u4f7f\u7528 HTTP \u6458\u8981\u8eab\u4efd\u9a57\u8b49\uff0c\u6216 `bearer_token` \u70ba OAuth 2.0 \u64c1\u6709\u8005\u6b0a\u6756\u8eab\u4efd\u9a57\u8b49\u3002\u9810\u8a2d\u503c\u70ba `basic`\u3002",
                     "name": "\u9a57\u8b49\u65b9\u5f0f"
                 },
+                "config_entry_id": {
+                    "description": "\u4ee3\u8868 Telegram \u6a5f\u5668\u4eba\u50b3\u9001\u8cbc\u5716\u8a2d\u5b9a\u689d\u76ee\u3002",
+                    "name": "\u8a2d\u5b9a\u689d\u76ee ID\u3002"
+                },
                 "disable_notification": {
                     "description": "\u975c\u97f3\u50b3\u9001\u8a0a\u606f\u3002iOS \u7528\u6236\u8207 Web \u7528\u6236\u5c07\u4e0d\u6703\u6536\u5230\u901a\u77e5\uff0cAndroid \u7528\u6236\u5247\u6703\u6536\u5230\u4e00\u689d\u7121\u8072\u7684\u901a\u77e5\u3002",
                     "name": "\u95dc\u9589\u901a\u77e5"
@@ -557,6 +759,10 @@
                     "description": "\u5f71\u7247\u6a19\u984c\u3002",
                     "name": "\u6a19\u984c"
                 },
+                "config_entry_id": {
+                    "description": "\u4ee3\u8868 Telegram \u6a5f\u5668\u4eba\u50b3\u9001\u5f71\u7247\u8a2d\u5b9a\u689d\u76ee\u3002",
+                    "name": "\u8a2d\u5b9a\u689d\u76ee ID\u3002"
+                },
                 "disable_notification": {
                     "description": "\u975c\u97f3\u50b3\u9001\u8a0a\u606f\u3002iOS \u7528\u6236\u8207 Web \u7528\u6236\u5c07\u4e0d\u6703\u6536\u5230\u901a\u77e5\uff0cAndroid \u7528\u6236\u5247\u6703\u6536\u5230\u4e00\u689d\u7121\u8072\u7684\u901a\u77e5\u3002",
                     "name": "\u95dc\u9589\u901a\u77e5"
@@ -627,6 +833,10 @@
                     "description": "\u8a9e\u97f3\u8a0a\u606f\u6a19\u984c\u3002",
                     "name": "\u6a19\u984c"
                 },
+                "config_entry_id": {
+                    "description": "\u4ee3\u8868 Telegram \u6a5f\u5668\u4eba\u50b3\u9001\u8a9e\u97f3\u8a0a\u606f\u8a2d\u5b9a\u689d\u76ee\u3002",
+                    "name": "\u8a2d\u5b9a\u689d\u76ee ID\u3002"
+                },
                 "disable_notification": {
                     "description": "\u975c\u97f3\u50b3\u9001\u8a0a\u606f\u3002iOS \u7528\u6236\u8207 Web \u7528\u6236\u5c07\u4e0d\u6703\u6536\u5230\u901a\u77e5\uff0cAndroid \u7528\u6236\u5247\u6703\u6536\u5230\u4e00\u689d\u7121\u8072\u7684\u901a\u77e5\u3002",
                     "name": "\u95dc\u9589\u901a\u77e5"
@@ -681,6 +891,32 @@
                 }
             },
             "name": "\u50b3\u9001\u8a9e\u97f3"
+        },
+        "set_message_reaction": {
+            "description": "\u8a2d\u5b9a\u6a5f\u5668\u4eba\u5c0d\u7d66\u5b9a\u8a0a\u606f\u7684\u53cd\u61c9\u3002",
+            "fields": {
+                "chat_id": {
+                    "description": "\u5305\u542b\u8a72\u8a0a\u606f\u7684\u804a\u5929\u5ba4 ID\u3002",
+                    "name": "\u804a\u5929\u5ba4 ID"
+                },
+                "config_entry_id": {
+                    "description": "\u4ee3\u8868 Telegram \u6a5f\u5668\u4eba\u8a2d\u5b9a\u8a0a\u606f\u53cd\u61c9\u689d\u76ee\u3002",
+                    "name": "\u8a2d\u5b9a\u689d\u76ee ID\u3002"
+                },
+                "is_big": {
+                    "description": "\u53cd\u61c9\u52d5\u756b\u662f\u5426\u61c9\u8a72\u70ba\u5927\u578b\u3002",
+                    "name": "\u5927\u578b\u52d5\u756b"
+                },
+                "message_id": {
+                    "description": "\u6b32\u53cd\u61c9\u8a0a\u606f ID\u3002",
+                    "name": "\u8a0a\u606f ID"
+                },
+                "reaction": {
+                    "description": "\u4f7f\u7528 Emoji \u53cd\u61c9\u3002",
+                    "name": "\u53cd\u61c9"
+                }
+            },
+            "name": "\u8a2d\u5b9a\u8a0a\u606f\u53cd\u61c9"
         }
     }
 }

homeassistant/components/telegram_bot/webhooks.py

@@ -1,21 +1,24 @@
 """Support for Telegram bots using webhooks."""
 
-import datetime as dt
 from http import HTTPStatus
-from ipaddress import ip_address
+from ipaddress import IPv4Network, ip_address
 import logging
 import secrets
 import string
 
-from telegram import Update
-from telegram.error import TimedOut
-from telegram.ext import Application, TypeHandler
+from aiohttp.web_response import Response
+from telegram import Bot, Update
+from telegram.error import NetworkError, TelegramError
+from telegram.ext import Application, ApplicationBuilder, TypeHandler
 
-from homeassistant.components.http import HomeAssistantView
-from homeassistant.const import EVENT_HOMEASSISTANT_STOP
+from homeassistant.components.http import HomeAssistantRequest, HomeAssistantView
+from homeassistant.const import CONF_URL
+from homeassistant.core import HomeAssistant
+from homeassistant.exceptions import ConfigEntryNotReady
 from homeassistant.helpers.network import get_url
 
-from . import CONF_TRUSTED_NETWORKS, CONF_URL, BaseTelegramBotEntity
+from .bot import BaseTelegramBot, TelegramBotConfigEntry
+from .const import CONF_TRUSTED_NETWORKS
 
 _LOGGER = logging.getLogger(__name__)
 
@@ -24,7 +27,9 @@ REMOVE_WEBHOOK_URL = ""
 SECRET_TOKEN_LENGTH = 32
 
 
-async def async_setup_platform(hass, bot, config):
+async def async_setup_platform(
+    hass: HomeAssistant, bot: Bot, config: TelegramBotConfigEntry
+) -> BaseTelegramBot | None:
     """Set up the Telegram webhooks platform."""
 
     # Generate an ephemeral secret token
@@ -33,47 +38,57 @@ async def async_setup_platform(hass, bot, config):
 
     pushbot = PushBot(hass, bot, config, secret_token)
 
-    if not pushbot.webhook_url.startswith("https"):
-        _LOGGER.error("Invalid telegram webhook %s must be https", pushbot.webhook_url)
-        return False
-
     await pushbot.start_application()
     webhook_registered = await pushbot.register_webhook()
     if not webhook_registered:
-        return False
+        raise ConfigEntryNotReady("Failed to register webhook with Telegram")
 
-    hass.bus.async_listen_once(EVENT_HOMEASSISTANT_STOP, pushbot.stop_application)
     hass.http.register_view(
         PushBotView(
             hass,
             bot,
             pushbot.application,
-            config[CONF_TRUSTED_NETWORKS],
+            _get_trusted_networks(config),
             secret_token,
         )
     )
-    return True
+    return pushbot
+
 
+def _get_trusted_networks(config: TelegramBotConfigEntry) -> list[IPv4Network]:
+    trusted_networks_str: list[str] = config.data[CONF_TRUSTED_NETWORKS]
+    return [IPv4Network(trusted_network) for trusted_network in trusted_networks_str]
 
-class PushBot(BaseTelegramBotEntity):
+
+class PushBot(BaseTelegramBot):
     """Handles all the push/webhook logic and passes telegram updates to `self.handle_update`."""
 
-    def __init__(self, hass, bot, config, secret_token):
+    def __init__(
+        self,
+        hass: HomeAssistant,
+        bot: Bot,
+        config: TelegramBotConfigEntry,
+        secret_token: str,
+    ) -> None:
         """Create Application before calling super()."""
         self.bot = bot
-        self.trusted_networks = config[CONF_TRUSTED_NETWORKS]
+        self.trusted_networks = _get_trusted_networks(config)
         self.secret_token = secret_token
         # Dumb Application that just gets our updates to our handler callback (self.handle_update)
-        self.application = Application.builder().bot(bot).updater(None).build()
+        self.application = ApplicationBuilder().bot(bot).updater(None).build()
         self.application.add_handler(TypeHandler(Update, self.handle_update))
         super().__init__(hass, config)
 
-        self.base_url = config.get(CONF_URL) or get_url(
+        self.base_url = config.data.get(CONF_URL) or get_url(
             hass, require_ssl=True, allow_internal=False
         )
         self.webhook_url = f"{self.base_url}{TELEGRAM_WEBHOOK_URL}"
 
-    async def _try_to_set_webhook(self):
+    async def shutdown(self) -> None:
+        """Shutdown the app."""
+        await self.stop_application()
+
+    async def _try_to_set_webhook(self) -> bool:
         _LOGGER.debug("Registering webhook URL: %s", self.webhook_url)
         retry_num = 0
         while retry_num < 3:
@@ -83,31 +98,22 @@ class PushBot(BaseTelegramBotEntity):
                     api_kwargs={"secret_token": self.secret_token},
                     connect_timeout=5,
                 )
-            except TimedOut:
+            except TelegramError:
                 retry_num += 1
-                _LOGGER.warning("Timeout trying to set webhook (retry #%d)", retry_num)
+                _LOGGER.warning("Error trying to set webhook (retry #%d)", retry_num)
 
         return False
 
-    async def start_application(self):
+    async def start_application(self) -> None:
         """Handle starting the Application object."""
         await self.application.initialize()
         await self.application.start()
 
-    async def register_webhook(self):
+    async def register_webhook(self) -> bool:
         """Query telegram and register the URL for our webhook."""
         current_status = await self.bot.get_webhook_info()
         # Some logging of Bot current status:
-        last_error_date = getattr(current_status, "last_error_date", None)
-        if (last_error_date is not None) and (isinstance(last_error_date, int)):
-            last_error_date = dt.datetime.fromtimestamp(last_error_date)
-            _LOGGER.debug(
-                "Telegram webhook last_error_date: %s. Status: %s",
-                last_error_date,
-                current_status,
-            )
-        else:
-            _LOGGER.debug("telegram webhook status: %s", current_status)
+        _LOGGER.debug("telegram webhook status: %s", current_status)
 
         result = await self._try_to_set_webhook()
         if result:
@@ -118,16 +124,19 @@ class PushBot(BaseTelegramBotEntity):
 
         return True
 
-    async def stop_application(self, event=None):
+    async def stop_application(self) -> None:
         """Handle gracefully stopping the Application object."""
         await self.deregister_webhook()
         await self.application.stop()
         await self.application.shutdown()
 
-    async def deregister_webhook(self):
+    async def deregister_webhook(self) -> None:
         """Query telegram and deregister the URL for our webhook."""
         _LOGGER.debug("Deregistering webhook URL")
-        await self.bot.delete_webhook()
+        try:
+            await self.bot.delete_webhook()
+        except NetworkError:
+            _LOGGER.error("Failed to deregister webhook URL")
 
 
 class PushBotView(HomeAssistantView):
@@ -137,7 +146,14 @@ class PushBotView(HomeAssistantView):
     url = TELEGRAM_WEBHOOK_URL
     name = "telegram_webhooks"
 
-    def __init__(self, hass, bot, application, trusted_networks, secret_token):
+    def __init__(
+        self,
+        hass: HomeAssistant,
+        bot: Bot,
+        application: Application,
+        trusted_networks: list[IPv4Network],
+        secret_token: str,
+    ) -> None:
         """Initialize by storing stuff needed for setting up our webhook endpoint."""
         self.hass = hass
         self.bot = bot
@@ -145,15 +161,16 @@ class PushBotView(HomeAssistantView):
         self.trusted_networks = trusted_networks
         self.secret_token = secret_token
 
-    async def post(self, request):
+    async def post(self, request: HomeAssistantRequest) -> Response | None:
         """Accept the POST from telegram."""
-        real_ip = ip_address(request.remote)
-        if not any(real_ip in net for net in self.trusted_networks):
-            _LOGGER.warning("Access denied from %s", real_ip)
+        if not request.remote or not any(
+            ip_address(request.remote) in net for net in self.trusted_networks
+        ):
+            _LOGGER.warning("Access denied from %s", request.remote)
             return self.json_message("Access denied", HTTPStatus.UNAUTHORIZED)
         secret_token_header = request.headers.get("X-Telegram-Bot-Api-Secret-Token")
         if secret_token_header is None or self.secret_token != secret_token_header:
-            _LOGGER.warning("Invalid secret token from %s", real_ip)
+            _LOGGER.warning("Invalid secret token from %s", request.remote)
             return self.json_message("Access denied", HTTPStatus.UNAUTHORIZED)
 
         try: