home-assistant.io/source/_components/telegram_bot.broadcast.markdown
Jorim Tielemans ac4baf0a8d Various things - t (#7020)
Add missing titles
Remove trailing spaces
Fix grammar
 - login -> log in
 - show how a entry -> shows how an entry
Mention default and minimal value (telldus) or link to add-on which is mentioned (tellstick)
2018-10-23 11:09:36 +02:00

1.6 KiB

layout title description date sidebar comments sharing footer logo ha_category ha_release
page Telegram broadcast Telegram support to send messages only 2017-06-24 11:20 true false true true telegram.png Notifications 0.48

Telegram implementation to support sending messages only. Your Home Assistant instance does not have to be exposed to the Internet and there is no polling to receive messages sent to the bot.

{% linkable_title Configuration %}

To integrate this into Home Assistant, add the following section to your configuration.yaml file:

# Example configuration.yaml entry
telegram_bot:
  - platform: broadcast
    api_key: YOUR_API_KEY
    allowed_chat_ids:
      - 12345
      - 67890

{% configuration %} allowed_chat_ids: description: A list of users in the user_id Telegram format that are authorized to interact with the webhook. required: true type: list api_key: description: The API token of your bot. required: true type: string parse_mode: description: Default parser for messages if not explicit in message data, either html or markdown. required: false type: string default: "markdown" proxy_url: description: Proxy url if working behind one (socks5://proxy_ip:proxy_port). required: false type: string proxy_params: description: Proxy configuration parameters, as dict, if working behind a proxy (username, password, etc.). required: false type: string {% endconfiguration %}

To get your chat_id and api_key follow the instructions here.