Skip to content

telegram_bot: no media support in notify.send_message #158179

Description

@mueslo

The problem

I migrated my telegram actions/services from notify.<old_custom_notifier> to notify.send_message as in the deprecation warning present (which had to be done manually).

Image

However, the notify.send_message endpoint no longer permits photo or video keys as it did previously.

action: notify.send_message
metadata: {}
target:
  entity_id: notify.telegram_bot_<bot_id>_<chat_id>
data:
  photo:
    - url: >-
        https://hostname.tld/path/to/image.jpg
      caption: >-
        my very nice image

results in Error: extra keys not allowed @ data['photo'] - same goes for the previously working video.

The notify documentation clearly states

data yes On platforms who have extended functionality. See your platform page if it is supported.

Since telegram_bot obviously supports sending photo and video and it worked previously, this is a regression, especially since the deprecation warning explicitly tells me to move to notify.send_message.

I have also attempted a nested data payload as previously. This gives the same kind of error with extra keys not allowed @ data['data']

For reference, the previously (and until deprecation still working payload) looks as follows:

action: notify.<old_custom_notifier>
metadata: {}
data:
  message: >-
    some message
  data:
    photo:
      - url: >-
          https://hostname.tld/path/to/image.jpg
        caption: >-
          my very nice image

What version of Home Assistant Core has the issue?

core-2025.12.1

What was the last working version of Home Assistant Core?

No response

What type of installation are you running?

Home Assistant Supervised

Integration causing the issue

telegram_bot

Link to integration documentation on our website

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

Diagnostics information

No response

Example YAML snippet

Anything in the logs that might be useful for us?

Additional information

No response

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Fields

    Priority

    None yet

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions