Skip to content

Conversation

@hanwg
Copy link
Contributor

@hanwg hanwg commented Nov 7, 2025

Proposed change

Preview: https://deploy-preview-41664--home-assistant-docs.netlify.app/integrations/telegram_bot/#prerequisites

Note:
Telegram and Telegram bot integrations are separate integrations.

Context of the change:

  1. In the past, the Telegram and Telegram bot integrations are dependent on each other.
    However, this is no longer the case as the Telegram bot integration can function on its own entirely since 2025.7.
  2. The Telegram integration uses the legacy notify platform which has been marked for deprecation in 2025.11.
    The plan is to redirect Telegram to Telegram bot after the deprecation (2026.5).

Changes:

  1. Added a warning to the Telegram integration for the deprecation. The intend is to discourage users from using an integration that has been marked for deprecation and to direct them to the Telegram bot integration. This helps the user to avoid unnecessary migrations.
  2. Updated the Telegram bot integration category to Notifications to better reflect the current nature of the integration.
  3. Updated the examples in the Telegram bot integration so that they use the correct actions instead of deprecated ones.

Type of change

  • Spelling, grammar or other readability improvements (current branch).
  • Adjusted missing or incorrect information in the current documentation (current branch).
  • Added documentation for a new integration I'm adding to Home Assistant (next branch).
  • Added documentation for a new feature I'm adding to Home Assistant (next branch).
  • Removed stale or deprecated documentation.

Additional information

  • Link to parent pull request in the codebase:
  • Link to parent pull request in the Brands repository:
  • This PR fixes or closes issue: fixes #

Checklist

  • This PR uses the correct branch, based on one of the following:
    • I made a change to the existing documentation and used the current branch.
    • I made a change that is related to an upcoming version of Home Assistant and used the next branch.
  • The documentation follows the Home Assistant documentation standards.

@home-assistant home-assistant bot added the current This PR goes into the current branch label Nov 7, 2025
@netlify
Copy link

netlify bot commented Nov 7, 2025

Deploy Preview for home-assistant-docs ready!

Name Link
🔨 Latest commit 0c8ebf7
🔍 Latest deploy log https://app.netlify.com/projects/home-assistant-docs/deploys/690dcb416ddcd600083c4243
😎 Deploy Preview https://deploy-preview-41664--home-assistant-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@hanwg hanwg marked this pull request as ready for review November 7, 2025 10:58
@hanwg hanwg changed the title Apdate pre-requisites for Telegram bot Update pre-requisites for Telegram bot Nov 8, 2025
@hanwg hanwg marked this pull request as draft November 8, 2025 15:00
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

current This PR goes into the current branch

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant