home-assistant.io/source/_components/telegram_bot.broadcast.markdown
Stuart McCroden 72631830da Standardize example configuration blocks (#6953)
* Standardized values in the example configuration

Removed what appear to be an actual API key from the example configuration.yaml block. And, replaced with values as described in the [developer docs](https://developers.home-assistant.io/docs/en/documentation_standards.html#component-and-platform-pages)

* Standardize example configuration-ecobee

* Standardize example configuration-coinbase

* Standardize example configuration-google assistant

* Standardize example configuration-cloudflare

* Standardize example configuration-cloudflare

* Standardize example configuration-habitica

* Standardize example configuration-ifttt

* Standardize example configuration-openalpr

* Standardize example configuration-multiple

* Standardize example configuration-instapush

* Standardize example configuration-llamalab

* Standardize example configuration-notify

* Standardize example configuration-mailgun

* Standardize example configuration-MULTIPLE

* Standardize example configuration-rtm

* Standardize example configuration-spotcrime

* Standardize example configuration-trafikverket

* Standardize example configuration-uk transport

* Standardize example configuration-wunderground

* Standardize example configuration-wsdot

* Standardize example configuration-telegram

* Standardize example configuration-tts

* Standardize example configuration-tts, vultr

* Replace email entry

* Replace IP address

* Place email address
2018-10-19 22:52:25 +02:00

1.5 KiB

layout, title, description, date, sidebar, comments, sharing, footer, logo, ha_category, ha_release
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.

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 user in the user_id Telegram format enabled to interact to 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: 'html' or 'markdown'." required: false default: markdown type: string 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.