homeassistant 2025.7.0b0__py3-none-any.whl → 2025.7.0b2__py3-none-any.whl

homeassistant/components/telegram_bot/bot.py

@@ -287,24 +287,32 @@ class TelegramNotificationService:
             inline_message_id = msg_data["inline_message_id"]
         return message_id, inline_message_id
 
-    def _get_target_chat_ids(self, target: Any) -> list[int]:
+    def get_target_chat_ids(self, target: int | list[int] | None) -> list[int]:
         """Validate chat_id targets or return default target (first).
 
         :param target: optional list of integers ([12234, -12345])
         :return list of chat_id targets (integers)
         """
         allowed_chat_ids: list[int] = self._get_allowed_chat_ids()
-        default_user: int = allowed_chat_ids[0]
-        if target is not None:
-            if isinstance(target, int):
-                target = [target]
-            chat_ids = [t for t in target if t in allowed_chat_ids]
-            if chat_ids:
-                return chat_ids
-            _LOGGER.warning(
-                "Disallowed targets: %s, using default: %s", target, default_user
+
+        if target is None:
+            return [allowed_chat_ids[0]]
+
+        chat_ids = [target] if isinstance(target, int) else target
+        valid_chat_ids = [
+            chat_id for chat_id in chat_ids if chat_id in allowed_chat_ids
+        ]
+        if not valid_chat_ids:
+            raise ServiceValidationError(
+                "Invalid chat IDs",
+                translation_domain=DOMAIN,
+                translation_key="invalid_chat_ids",
+                translation_placeholders={
+                    "chat_ids": ", ".join(str(chat_id) for chat_id in chat_ids),
+                    "bot_name": self.config.title,
+                },
             )
-        return [default_user]
+        return valid_chat_ids
 
     def _get_msg_kwargs(self, data: dict[str, Any]) -> dict[str, Any]:
         """Get parameters in message data kwargs."""
@@ -414,9 +422,9 @@ class TelegramNotificationService:
         """Send one message."""
         try:
             out = await func_send(*args_msg, **kwargs_msg)
-            if not isinstance(out, bool) and hasattr(out, ATTR_MESSAGEID):
+            if isinstance(out, Message):
                 chat_id = out.chat_id
-                message_id = out[ATTR_MESSAGEID]
+                message_id = out.message_id
                 self._last_message_id[chat_id] = message_id
                 _LOGGER.debug(
                     "Last message ID: %s (from chat_id %s)",
@@ -424,7 +432,7 @@ class TelegramNotificationService:
                     chat_id,
                 )
 
-                event_data = {
+                event_data: dict[str, Any] = {
                     ATTR_CHAT_ID: chat_id,
                     ATTR_MESSAGEID: message_id,
                 }
@@ -437,10 +445,6 @@ class TelegramNotificationService:
                 self.hass.bus.async_fire(
                     EVENT_TELEGRAM_SENT, event_data, context=context
                 )
-            elif not isinstance(out, bool):
-                _LOGGER.warning(
-                    "Update last message: out_type:%s, out=%s", type(out), out
-                )
         except TelegramError as exc:
             _LOGGER.error(
                 "%s: %s. Args: %s, kwargs: %s", msg_error, exc, args_msg, kwargs_msg
@@ -460,7 +464,7 @@ class TelegramNotificationService:
         text = f"{title}\n{message}" if title else message
         params = self._get_msg_kwargs(kwargs)
         msg_ids = {}
-        for chat_id in self._get_target_chat_ids(target):
+        for chat_id in self.get_target_chat_ids(target):
             _LOGGER.debug("Send message in chat ID %s with params: %s", chat_id, params)
             msg = await self._send_msg(
                 self.bot.send_message,
@@ -488,7 +492,7 @@ class TelegramNotificationService:
         **kwargs: dict[str, Any],
     ) -> bool:
         """Delete a previously sent message."""
-        chat_id = self._get_target_chat_ids(chat_id)[0]
+        chat_id = self.get_target_chat_ids(chat_id)[0]
         message_id, _ = self._get_msg_ids(kwargs, chat_id)
         _LOGGER.debug("Delete message %s in chat ID %s", message_id, chat_id)
         deleted: bool = await self._send_msg(
@@ -513,7 +517,7 @@ class TelegramNotificationService:
         **kwargs: dict[str, Any],
     ) -> Any:
         """Edit a previously sent message."""
-        chat_id = self._get_target_chat_ids(chat_id)[0]
+        chat_id = self.get_target_chat_ids(chat_id)[0]
         message_id, inline_message_id = self._get_msg_ids(kwargs, chat_id)
         params = self._get_msg_kwargs(kwargs)
         _LOGGER.debug(
@@ -620,7 +624,7 @@ class TelegramNotificationService:
 
         msg_ids = {}
         if file_content:
-            for chat_id in self._get_target_chat_ids(target):
+            for chat_id in self.get_target_chat_ids(target):
                 _LOGGER.debug("Sending file to chat ID %s", chat_id)
 
                 if file_type == SERVICE_SEND_PHOTO:
@@ -738,7 +742,7 @@ class TelegramNotificationService:
 
         msg_ids = {}
         if stickerid:
-            for chat_id in self._get_target_chat_ids(target):
+            for chat_id in self.get_target_chat_ids(target):
                 msg = await self._send_msg(
                     self.bot.send_sticker,
                     "Error sending sticker",
@@ -769,7 +773,7 @@ class TelegramNotificationService:
         longitude = float(longitude)
         params = self._get_msg_kwargs(kwargs)
         msg_ids = {}
-        for chat_id in self._get_target_chat_ids(target):
+        for chat_id in self.get_target_chat_ids(target):
             _LOGGER.debug(
                 "Send location %s/%s to chat ID %s", latitude, longitude, chat_id
             )
@@ -803,7 +807,7 @@ class TelegramNotificationService:
         params = self._get_msg_kwargs(kwargs)
         openperiod = kwargs.get(ATTR_OPEN_PERIOD)
         msg_ids = {}
-        for chat_id in self._get_target_chat_ids(target):
+        for chat_id in self.get_target_chat_ids(target):
             _LOGGER.debug("Send poll '%s' to chat ID %s", question, chat_id)
             msg = await self._send_msg(
                 self.bot.send_poll,
@@ -826,12 +830,12 @@ class TelegramNotificationService:
 
     async def leave_chat(
         self,
-        chat_id: Any = None,
+        chat_id: int | None = None,
         context: Context | None = None,
         **kwargs: dict[str, Any],
     ) -> Any:
         """Remove bot from chat."""
-        chat_id = self._get_target_chat_ids(chat_id)[0]
+        chat_id = self.get_target_chat_ids(chat_id)[0]
         _LOGGER.debug("Leave from chat ID %s", chat_id)
         return await self._send_msg(
             self.bot.leave_chat, "Error leaving chat", None, chat_id, context=context
@@ -839,14 +843,14 @@ class TelegramNotificationService:
 
     async def set_message_reaction(
         self,
-        chat_id: int,
         reaction: str,
+        chat_id: int | None = None,
         is_big: bool = False,
         context: Context | None = None,
         **kwargs: dict[str, Any],
     ) -> None:
         """Set the bot's reaction for a given message."""
-        chat_id = self._get_target_chat_ids(chat_id)[0]
+        chat_id = self.get_target_chat_ids(chat_id)[0]
         message_id, _ = self._get_msg_ids(kwargs, chat_id)
         params = self._get_msg_kwargs(kwargs)
 

homeassistant/components/telegram_bot/config_flow.py

@@ -22,7 +22,7 @@ from homeassistant.config_entries import (
 )
 from homeassistant.const import CONF_API_KEY, CONF_PLATFORM, CONF_URL
 from homeassistant.core import callback
-from homeassistant.data_entry_flow import AbortFlow
+from homeassistant.data_entry_flow import AbortFlow, section
 from homeassistant.helpers import config_validation as cv
 from homeassistant.helpers.issue_registry import IssueSeverity, async_create_issue
 from homeassistant.helpers.network import NoURLAvailableError, get_url
@@ -58,6 +58,7 @@ from .const import (
     PLATFORM_BROADCAST,
     PLATFORM_POLLING,
     PLATFORM_WEBHOOKS,
+    SECTION_ADVANCED_SETTINGS,
     SUBENTRY_TYPE_ALLOWED_CHAT_IDS,
 )
 
@@ -81,8 +82,15 @@ STEP_USER_DATA_SCHEMA: vol.Schema = vol.Schema(
                 autocomplete="current-password",
             )
         ),
-        vol.Optional(CONF_PROXY_URL): TextSelector(
-            config=TextSelectorConfig(type=TextSelectorType.URL)
+        vol.Required(SECTION_ADVANCED_SETTINGS): section(
+            vol.Schema(
+                {
+                    vol.Optional(CONF_PROXY_URL): TextSelector(
+                        config=TextSelectorConfig(type=TextSelectorType.URL)
+                    ),
+                },
+            ),
+            {"collapsed": True},
         ),
     }
 )
@@ -98,8 +106,15 @@ STEP_RECONFIGURE_USER_DATA_SCHEMA: vol.Schema = vol.Schema(
                 translation_key="platforms",
             )
         ),
-        vol.Optional(CONF_PROXY_URL): TextSelector(
-            config=TextSelectorConfig(type=TextSelectorType.URL)
+        vol.Required(SECTION_ADVANCED_SETTINGS): section(
+            vol.Schema(
+                {
+                    vol.Optional(CONF_PROXY_URL): TextSelector(
+                        config=TextSelectorConfig(type=TextSelectorType.URL)
+                    ),
+                },
+            ),
+            {"collapsed": True},
         ),
     }
 )
@@ -197,6 +212,9 @@ class TelgramBotConfigFlow(ConfigFlow, domain=DOMAIN):
         import_data[CONF_TRUSTED_NETWORKS] = ",".join(
             import_data[CONF_TRUSTED_NETWORKS]
         )
+        import_data[SECTION_ADVANCED_SETTINGS] = {
+            CONF_PROXY_URL: import_data.get(CONF_PROXY_URL)
+        }
         try:
             config_flow_result: ConfigFlowResult = await self.async_step_user(
                 import_data
@@ -293,10 +311,15 @@ class TelgramBotConfigFlow(ConfigFlow, domain=DOMAIN):
     ) -> ConfigFlowResult:
         """Handle a flow to create a new config entry for a Telegram bot."""
 
+        description_placeholders: dict[str, str] = {
+            "botfather_username": "@BotFather",
+            "botfather_url": "https://t.me/botfather",
+        }
         if not user_input:
             return self.async_show_form(
                 step_id="user",
                 data_schema=STEP_USER_DATA_SCHEMA,
+                description_placeholders=description_placeholders,
             )
 
         # prevent duplicates
@@ -305,7 +328,6 @@ class TelgramBotConfigFlow(ConfigFlow, domain=DOMAIN):
 
         # validate connection to Telegram API
         errors: dict[str, str] = {}
-        description_placeholders: dict[str, str] = {}
         bot_name = await self._validate_bot(
             user_input, errors, description_placeholders
         )
@@ -328,7 +350,7 @@ class TelgramBotConfigFlow(ConfigFlow, domain=DOMAIN):
                 data={
                     CONF_PLATFORM: user_input[CONF_PLATFORM],
                     CONF_API_KEY: user_input[CONF_API_KEY],
-                    CONF_PROXY_URL: user_input.get(CONF_PROXY_URL),
+                    CONF_PROXY_URL: user_input["advanced_settings"].get(CONF_PROXY_URL),
                 },
                 options={
                     # this value may come from yaml import
@@ -390,12 +412,20 @@ class TelgramBotConfigFlow(ConfigFlow, domain=DOMAIN):
         """Handle config flow for webhook Telegram bot."""
 
         if not user_input:
+            default_trusted_networks = ",".join(
+                [str(network) for network in DEFAULT_TRUSTED_NETWORKS]
+            )
+
             if self.source == SOURCE_RECONFIGURE:
+                suggested_values = dict(self._get_reconfigure_entry().data)
+                if CONF_TRUSTED_NETWORKS not in self._get_reconfigure_entry().data:
+                    suggested_values[CONF_TRUSTED_NETWORKS] = default_trusted_networks
+
                 return self.async_show_form(
                     step_id="webhooks",
                     data_schema=self.add_suggested_values_to_schema(
                         STEP_WEBHOOKS_DATA_SCHEMA,
-                        self._get_reconfigure_entry().data,
+                        suggested_values,
                     ),
                 )
 
@@ -404,9 +434,7 @@ class TelgramBotConfigFlow(ConfigFlow, domain=DOMAIN):
                 data_schema=self.add_suggested_values_to_schema(
                     STEP_WEBHOOKS_DATA_SCHEMA,
                     {
-                        CONF_TRUSTED_NETWORKS: ",".join(
-                            [str(network) for network in DEFAULT_TRUSTED_NETWORKS]
-                        ),
+                        CONF_TRUSTED_NETWORKS: default_trusted_networks,
                     },
                 ),
             )
@@ -440,7 +468,9 @@ class TelgramBotConfigFlow(ConfigFlow, domain=DOMAIN):
             data={
                 CONF_PLATFORM: self._step_user_data[CONF_PLATFORM],
                 CONF_API_KEY: self._step_user_data[CONF_API_KEY],
-                CONF_PROXY_URL: self._step_user_data.get(CONF_PROXY_URL),
+                CONF_PROXY_URL: self._step_user_data[SECTION_ADVANCED_SETTINGS].get(
+                    CONF_PROXY_URL
+                ),
                 CONF_URL: user_input.get(CONF_URL),
                 CONF_TRUSTED_NETWORKS: user_input[CONF_TRUSTED_NETWORKS],
             },
@@ -455,12 +485,8 @@ class TelgramBotConfigFlow(ConfigFlow, domain=DOMAIN):
         description_placeholders: dict[str, str],
     ) -> None:
         # validate URL
-        if CONF_URL in user_input and not user_input[CONF_URL].startswith("https"):
-            errors["base"] = "invalid_url"
-            description_placeholders[ERROR_FIELD] = "URL"
-            description_placeholders[ERROR_MESSAGE] = "URL must start with https"
-            return
-        if CONF_URL not in user_input:
+        url: str | None = user_input.get(CONF_URL)
+        if url is None:
             try:
                 get_url(self.hass, require_ssl=True, allow_internal=False)
             except NoURLAvailableError:
@@ -470,6 +496,11 @@ class TelgramBotConfigFlow(ConfigFlow, domain=DOMAIN):
                     "URL is required since you have not configured an external URL in Home Assistant"
                 )
                 return
+        elif not url.startswith("https"):
+            errors["base"] = "invalid_url"
+            description_placeholders[ERROR_FIELD] = "URL"
+            description_placeholders[ERROR_MESSAGE] = "URL must start with https"
+            return
 
         # validate trusted networks
         csv_trusted_networks: list[str] = []
@@ -505,9 +536,19 @@ class TelgramBotConfigFlow(ConfigFlow, domain=DOMAIN):
                 step_id="reconfigure",
                 data_schema=self.add_suggested_values_to_schema(
                     STEP_RECONFIGURE_USER_DATA_SCHEMA,
-                    self._get_reconfigure_entry().data,
+                    {
+                        **self._get_reconfigure_entry().data,
+                        SECTION_ADVANCED_SETTINGS: {
+                            CONF_PROXY_URL: self._get_reconfigure_entry().data.get(
+                                CONF_PROXY_URL
+                            ),
+                        },
+                    },
                 ),
             )
+        user_input[CONF_PROXY_URL] = user_input[SECTION_ADVANCED_SETTINGS].get(
+            CONF_PROXY_URL
+        )
 
         errors: dict[str, str] = {}
         description_placeholders: dict[str, str] = {}
@@ -523,7 +564,12 @@ class TelgramBotConfigFlow(ConfigFlow, domain=DOMAIN):
                 step_id="reconfigure",
                 data_schema=self.add_suggested_values_to_schema(
                     STEP_RECONFIGURE_USER_DATA_SCHEMA,
-                    user_input,
+                    {
+                        **user_input,
+                        SECTION_ADVANCED_SETTINGS: {
+                            CONF_PROXY_URL: user_input.get(CONF_PROXY_URL),
+                        },
+                    },
                 ),
                 errors=errors,
                 description_placeholders=description_placeholders,

homeassistant/components/telegram_bot/const.py

@@ -7,7 +7,7 @@ DOMAIN = "telegram_bot"
 PLATFORM_BROADCAST = "broadcast"
 PLATFORM_POLLING = "polling"
 PLATFORM_WEBHOOKS = "webhooks"
-
+SECTION_ADVANCED_SETTINGS = "advanced_settings"
 SUBENTRY_TYPE_ALLOWED_CHAT_IDS = "allowed_chat_ids"
 
 CONF_BOT_COUNT = "bot_count"

homeassistant/components/telegram_bot/strings.json

@@ -2,17 +2,25 @@
   "config": {
     "step": {
       "user": {
-        "title": "Telegram bot setup",
-        "description": "Create a new Telegram bot",
+        "description": "To create a Telegram bot, follow these steps:\n\n1. Open Telegram and start a chat with [{botfather_username}]({botfather_url}).\n1. Send the command `/newbot`.\n1. Follow the instructions to create your bot and get your API token.",
         "data": {
           "platform": "Platform",
-          "api_key": "[%key:common::config_flow::data::api_key%]",
-          "proxy_url": "Proxy URL"
+          "api_key": "[%key:common::config_flow::data::api_token%]"
         },
         "data_description": {
           "platform": "Telegram bot implementation",
-          "api_key": "The API token of your bot.",
-          "proxy_url": "Proxy URL if working behind one, optionally including username and password.\n(socks5://username:password@proxy_ip:proxy_port)"
+          "api_key": "The API token of your bot."
+        },
+        "sections": {
+          "advanced_settings": {
+            "name": "Advanced settings",
+            "data": {
+              "proxy_url": "Proxy URL"
+            },
+            "data_description": {
+              "proxy_url": "Proxy URL if working behind one, optionally including username and password.\n(socks5://username:password@proxy_ip:proxy_port)"
+            }
+          }
         }
       },
       "webhooks": {
@@ -30,12 +38,21 @@
         "title": "Telegram bot setup",
         "description": "Reconfigure Telegram bot",
         "data": {
-          "platform": "[%key:component::telegram_bot::config::step::user::data::platform%]",
-          "proxy_url": "[%key:component::telegram_bot::config::step::user::data::proxy_url%]"
+          "platform": "[%key:component::telegram_bot::config::step::user::data::platform%]"
         },
         "data_description": {
-          "platform": "[%key:component::telegram_bot::config::step::user::data_description::platform%]",
-          "proxy_url": "[%key:component::telegram_bot::config::step::user::data_description::proxy_url%]"
+          "platform": "[%key:component::telegram_bot::config::step::user::data_description::platform%]"
+        },
+        "sections": {
+          "advanced_settings": {
+            "name": "[%key:component::telegram_bot::config::step::user::sections::advanced_settings::name%]",
+            "data": {
+              "proxy_url": "[%key:component::telegram_bot::config::step::user::sections::advanced_settings::data::proxy_url%]"
+            },
+            "data_description": {
+              "proxy_url": "[%key:component::telegram_bot::config::step::user::sections::advanced_settings::data_description::proxy_url%]"
+            }
+          }
         }
       },
       "reauth_confirm": {
@@ -895,6 +912,12 @@
     "missing_allowed_chat_ids": {
       "message": "No allowed chat IDs found. Please add allowed chat IDs for {bot_name}."
     },
+    "invalid_chat_ids": {
+      "message": "Invalid chat IDs: {chat_ids}. Please configure the chat IDs for {bot_name}."
+    },
+    "failed_chat_ids": {
+      "message": "Failed targets: {chat_ids}. Please verify that the chat IDs for {bot_name} have been configured."
+    },
     "missing_input": {
       "message": "{field} is required."
     },

homeassistant/components/telegram_bot/translations/bg.json

@@ -22,7 +22,6 @@
             },
             "user": {
                 "data": {
-                    "api_key": "API \u043a\u043b\u044e\u0447",
                     "platform": "\u041f\u043b\u0430\u0442\u0444\u043e\u0440\u043c\u0430"
                 }
             },

homeassistant/components/telegram_bot/translations/cs.json

@@ -24,29 +24,46 @@
             },
             "reconfigure": {
                 "data": {
-                    "platform": "Platforma",
-                    "proxy_url": "Adresa URL proxy serveru"
+                    "platform": "Platforma"
                 },
                 "data_description": {
-                    "platform": "Implementace bota Telegram",
-                    "proxy_url": "Adresa URL proxy serveru, pokud za n\u00edm pracuje, voliteln\u011b v\u010detn\u011b u\u017eivatelsk\u00e9ho jm\u00e9na a hesla. (socks5://username:password@proxy_ip:proxy_port)"
+                    "platform": "Implementace bota Telegram"
                 },
                 "description": "P\u0159enastavit bota Telegram",
+                "sections": {
+                    "advanced_settings": {
+                        "data": {
+                            "proxy_url": "Adresa URL proxy serveru"
+                        },
+                        "data_description": {
+                            "proxy_url": "Adresa URL proxy serveru, pokud za n\u00edm pracuje, voliteln\u011b v\u010detn\u011b u\u017eivatelsk\u00e9ho jm\u00e9na a hesla. (socks5://username:password@proxy_ip:proxy_port)"
+                        },
+                        "name": "Pokro\u010dil\u00e1 nastaven\u00ed"
+                    }
+                },
                 "title": "Nastavit bota Telegram"
             },
             "user": {
                 "data": {
-                    "api_key": "Kl\u00ed\u010d API",
-                    "platform": "Platforma",
-                    "proxy_url": "Adresa URL proxy serveru"
+                    "api_key": "Token API",
+                    "platform": "Platforma"
                 },
                 "data_description": {
                     "api_key": "Token API va\u0161eho bota.",
-                    "platform": "Implementace bota Telegram",
-                    "proxy_url": "Adresa URL proxy serveru, pokud za n\u00edm pracuje, voliteln\u011b v\u010detn\u011b u\u017eivatelsk\u00e9ho jm\u00e9na a hesla. (socks5://username:password@proxy_ip:proxy_port)"
-                },
-                "description": "Vytvo\u0159it nov\u00e9ho bota Telegram",
-                "title": "Nastavit bota Telegram"
+                    "platform": "Implementace bota Telegram"
+                },
+                "description": "Chcete-li vytvo\u0159it Telegram bota, postupujte takto:\n \n1. Otev\u0159ete Telegram a zahajte chat s [{botfather_username}]({botfather_url}).\n2. Ode\u0161lete p\u0159\u00edkaz \"/newbot\".\n3. Postupujte podle pokyn\u016f k vytvo\u0159en\u00ed bota a z\u00edsk\u00e1n\u00ed API tokenu.",
+                "sections": {
+                    "advanced_settings": {
+                        "data": {
+                            "proxy_url": "Adresa URL proxy serveru"
+                        },
+                        "data_description": {
+                            "proxy_url": "Adresa URL proxy serveru, pokud za n\u00edm pracuje, voliteln\u011b v\u010detn\u011b u\u017eivatelsk\u00e9ho jm\u00e9na a hesla. (socks5://username:password@proxy_ip:proxy_port)"
+                        },
+                        "name": "Pokro\u010dil\u00e1 nastaven\u00ed"
+                    }
+                }
             },
             "webhooks": {
                 "data": {
@@ -89,12 +106,18 @@
         "allowlist_external_dirs_error": {
             "message": "Cesta k souboru nebyla nastavena v allowlist_external_dirs."
         },
+        "failed_chat_ids": {
+            "message": "Ne\u00fasp\u011b\u0161n\u00e9 c\u00edle: {chat_ids}. Ov\u011b\u0159te, zda byla nastavena ID chat\u016f pro {bot_name}."
+        },
         "failed_to_load_file": {
             "message": "Nepoda\u0159ilo se na\u010d\u00edst soubor: {error}"
         },
         "failed_to_load_url": {
             "message": "Nepoda\u0159ilo se na\u010d\u00edst URL: {error}"
         },
+        "invalid_chat_ids": {
+            "message": "Neplatn\u00e1 ID chatu: {chat_ids}. Nastavte ID chat\u016f pro {bot_name}."
+        },
         "missing_allowed_chat_ids": {
             "message": "Nebyla nalezena \u017e\u00e1dn\u00e1 povolen\u00e1 ID chatu. P\u0159idejte povolen\u00e9 ID chatu pro {bot_name}."
         },

homeassistant/components/telegram_bot/translations/de.json

@@ -24,29 +24,46 @@
             },
             "reconfigure": {
                 "data": {
-                    "platform": "Plattform",
-                    "proxy_url": "Proxy-URL"
+                    "platform": "Plattform"
                 },
                 "data_description": {
-                    "platform": "Implementierung des Telegram-Bots",
-                    "proxy_url": "Proxy-URL, wenn du mit einem Proxy arbeitest, optional mit Benutzernamen und Passwort (socks5://benutzername:passwort@proxy_ip:proxy_port)"
+                    "platform": "Implementierung des Telegram-Bots"
                 },
                 "description": "Telegram-Bot neu konfigurieren",
+                "sections": {
+                    "advanced_settings": {
+                        "data": {
+                            "proxy_url": "Proxy-URL"
+                        },
+                        "data_description": {
+                            "proxy_url": "URL des Proxy, wenn hinter einem gearbeitet wird, optional einschlie\u00dflich Benutzername und Passwort.\n(socks5://benutzername:passwort@proxy_ip:proxy_port)"
+                        },
+                        "name": "Erweiterte Einstellungen"
+                    }
+                },
                 "title": "Einrichtung des Telegram-Bots"
             },
             "user": {
                 "data": {
-                    "api_key": "API-Schl\u00fcssel",
-                    "platform": "Plattform",
-                    "proxy_url": "Proxy-URL"
+                    "api_key": "API-Token",
+                    "platform": "Plattform"
                 },
                 "data_description": {
                     "api_key": "Das API-Token deines Bots.",
-                    "platform": "Implementierung des Telegram-Bots",
-                    "proxy_url": "Proxy-URL, wenn du mit einem Proxy arbeitest, optional mit Benutzernamen und Passwort (socks5://benutzername:passwort@proxy_ip:proxy_port)"
-                },
-                "description": "Einen neuen Telegram-Bot erstellen",
-                "title": "Einrichtung des Telegram-Bots"
+                    "platform": "Implementierung des Telegram-Bots"
+                },
+                "description": "So erstellst du einen Telegram-Bot:\n\n1. \u00d6ffne Telegram und beginne einen Chat mit [{botfather_username}]({botfather_url}).\n1. Sende den Befehl `/newbot`.\n1. Folge den Anweisungen, um deinen Bot zu erstellen und dein API-Token zu erhalten.",
+                "sections": {
+                    "advanced_settings": {
+                        "data": {
+                            "proxy_url": "Proxy-URL"
+                        },
+                        "data_description": {
+                            "proxy_url": "URL des Proxy, wenn hinter einem gearbeitet wird, optional einschlie\u00dflich Benutzername und Passwort.\n(socks5://benutzername:passwort@proxy_ip:proxy_port)"
+                        },
+                        "name": "Erweiterte Einstellungen"
+                    }
+                }
             },
             "webhooks": {
                 "data": {
@@ -89,12 +106,18 @@
         "allowlist_external_dirs_error": {
             "message": "Der Dateipfad wurde in allowlist_external_dirs nicht konfiguriert."
         },
+        "failed_chat_ids": {
+            "message": "Fehlgeschlagene Ziele: {chat_ids}. Bitte \u00fcberpr\u00fcfe, ob die Chat-IDs f\u00fcr {bot_name} konfiguriert wurden."
+        },
         "failed_to_load_file": {
             "message": "Datei konnte nicht geladen werden: {error}"
         },
         "failed_to_load_url": {
             "message": "URL konnte nicht geladen werden: {error}"
         },
+        "invalid_chat_ids": {
+            "message": "Ung\u00fcltige Chat-IDs: {chat_ids}. Bitte konfiguriere die Chat-IDs f\u00fcr {bot_name}."
+        },
         "missing_allowed_chat_ids": {
             "message": "Keine zul\u00e4ssigen Chat-IDs gefunden. Bitte f\u00fcge zul\u00e4ssige Chat-IDs f\u00fcr {bot_name} hinzu."
         },