home-assistant.io/notify.telegram.markdown at 4077a130eaeee3c63c6ea7a8b50e39c1ac24028c

mirror of https://github.com/home-assistant/home-assistant.io.git synced 2025-07-13 12:26:50 +00:00

Fabian Affolter 034c831324 0.24 (#637 )

* Persistant changed to persistent

* Added log_attributes to the config documentation for statsd (#625)

* Fix AsusWRT docs to prevent SSH key confusion (#623)

pxssh is expecting the path to a private key, not a public key

* add yahoo weather support (#621)

* add yahoo weather

* update with woeid not longer required

* Doc for simplisafe alarm (#613)

* Minor fixes

* Rename the blog post for 0.24

* Initial blog post for 0.24

* Update sensor.apcupsd docs to reflect changes (#617)

* Update sensor.apcupsd docs to reflect changes

* Remove "type:" from configuration

* Add apcupsd sensor breaking change

* Added samsung models to the list of supported Samsung Smart TV's (#630)

* Add IMAP sensor docs

* Add IMAP sensor

* add joaoapps join component and platform. (#633)

* Add join

* Added documentation of the KNX component (#611)

* Added set_brightness to website docs. (#582)

* Added configuration for card order to customize docs

* Added configuration options to docs for the set_brightness command.

* Revert "Added configuration for card order to customize docs"

This reverts commit bd310fbd115c76bc49d994fff4ff3e1a0d0e9540.

* Add new contributors

* Add TP-Link smart plug docs

* Sync with PR

* update service (#634)

* Move KNX docs to right folder

* Fix typos and layout

* Add missing KNX logo

* Fix logo name

* Fix category

* Revert "Added set_brightness to website docs." (#636)

* Add initial KNX docs for binary sensors and switches

* Update title, desc, and date

* Rename blog post

* Update for 0.24

* pyhomematic update 0.1.9

* add example

* Example config (#638)

* Added dynamic entity tracking documentation (#641)

* Change ordering

* Added dynamic entity tracking documentation

* Add more details

* Add sqlalchemy as dep

* Add various db_url

* Added bah2830 configuration (#644)

* update media_player.markdown (#643)

* Rename release blog post

* Add CARTO

* Hide sensor.imap until stable

* Typo edits (#642)

* Update demo

* Minor tweaking

* Add additional example

* Add simple example for renaming

* Make it raw

* Update camera.rpi_camera.markdown (#537)

* Add link to binary version

* Fix indent

* Minor change for #537

* Update date

2016-07-16 21:24:29 +02:00

2.8 KiB

Raw Blame History

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	Instructions how to add Telegram notifications to Home Assistant.	2015-10-09 18:00	true	false	true	true	telegram.png	Notifications	0.7.5

The telegram platform uses Telegram to delivery notifications from Home Assistant to your Android device, your Windows phone, or your iOS device.

The requirements are:

You need a Telegram bot. Please follow those instructions to create one and get the token for your bot. Keep in mind that bots are not allowed to contact users. You need to make the first contact with your user. Meaning that you need to send a message to the bot from your user.
The chat_id of an user.

An easy way to get your chat ID is described below:

import telegram
bot = telegram.Bot(token='YOUR_API_TOKEN')
chat_id = bot.getUpdates()[-1].message.chat_id
print(chat_id)

Another way to retrieve your chat_id is visiting https://api.telegram.org/botYOUR_API_TOKEN/getUpdates.

The result set will include your chat ID as id in the from section:

{
   "ok":true,
   "result":[
      {
         "update_id":254199982,
         "message":{
            "message_id":201,
            "from":{
               "id":123456789,
               "first_name":"Your first name",
...

To enable Telegram notifications in your installation, add the following to your configuration.yaml file:

# Example configuration.yaml entry
notify:
  name: NOTIFIER_NAME
  platform: telegram
  api_key: ABCDEFGHJKLMNOPQRSTUVXYZ
  chat_id: YOUR_CHAT_ID

Configuration variables:

name (Optional): Setting the optional parameter name allows multiple notifiers to be created. The default value is notify. The notifier will bind to the service notify.NOTIFIER_NAME.
api_key (Required): The API token of your bot.
chat_id (Required: The chat ID of your user.

To use notifications, please see the getting started with automation page.

Photo support

...

action:
  service: notify.NOTIFIER_NAME
  data:
    title: test notify
    message: That's a exemple
    data:
      photo:
        - url: http://192.168.1.28/camera.jpg
          username: admin
          password: secrete
        - file: /tmp/picture.jpg
          caption: Picture Title xy
        - url: http://somebla.ie/video.png
          caption: I.e. for a Title

url or file (Required): For local or remote path to a picture
caption (Optional: Picture title
username and password (Optional: For URL they require a basic auth

2.8 KiB Raw Blame History

Photo support

2.8 KiB

Raw Blame History