home-assistant / home-assistant.io

:blue_book: Home Assistant User documentation
https://www.home-assistant.io
Other
4.98k stars 7.29k forks source link

Request: Explain differences between "telegram" and "telegram_bot" integrations #32027

Open TinkerTob opened 7 months ago

TinkerTob commented 7 months ago

Feedback

https://www.home-assistant.io/integrations/telegram "was introduced in Home Assistant 0.7.5, and it's used by 480 active installations." https://www.home-assistant.io/integrations/telegram_bot "was introduced in Home Assistant 0.42, and it's used by 5.6% of the active installations." (15.085 users)

The "telegram" integration seems to be newer and much less used. The only description of its purpose is: "uses Telegram to deliver notifications from Home Assistant to your Telegram application(s)." That makes it look like an alternative to telegram_bot. Only when reading further, it becomes apparent that it's dependent on telegram_bot. That was a WTF moment for me.

"uses Telegram to deliver notifications from Home Assistant to your Telegram application(s)." - can't telegram_bot do this on it's own? I don't think the 14.5k users that use telegram_bot without "telegram" are missing out on notifications... What's the purpose of the "telegram" integration then? The instructions seem much better, but apart from that I still don't know what it can do that "telegram_bot" can't.

I'm pretty confused right now. It would be great if someone in the know could clarify the documentation. And maybe it should be discussed wether it makes sense that the 480-users addon to the telegram_bot integration (?) uses the prominent "telegram" name while the 15k-users main integration "telegram_bot" sounds like an optional addon.

Thank you! :)

URL

https://www.home-assistant.io/integrations/telegram/

Version

2024.3.3

Additional information

No response

Fifoustrut commented 7 months ago

I wanted to add Telegram integration to my fresh home assistant installation and faced the same issue: What Telegram integration should I use?