From 29dfb1655a80a27d363dce448686b6b9cc3b1ed3 Mon Sep 17 00:00:00 2001 From: azogue Date: Sat, 24 Jun 2017 11:19:15 +0200 Subject: [PATCH 1/3] add telegram_bot/onlysend doc for #8186 --- source/_components/telegram_bot.markdown | 1 + .../telegram_bot.onlysend.markdown | 37 +++++++++++++++++++ 2 files changed, 38 insertions(+) create mode 100644 source/_components/telegram_bot.onlysend.markdown diff --git a/source/_components/telegram_bot.markdown b/source/_components/telegram_bot.markdown index 058d6e5f296a..d247765436b7 100644 --- a/source/_components/telegram_bot.markdown +++ b/source/_components/telegram_bot.markdown @@ -17,6 +17,7 @@ Use Telegram on your mobile or desktop device to send and receive messages or co This component creates notification services to send, or edit previously sent, messages from a [Telegram Bot account](https://core.telegram.org/bots) configured either with the [polling](/components/telegram_bot.polling/) method or with the [webhooks](/components/telegram_bot.webhooks/) one, and trigger events when receiving messages. +If you don't need to receive messages, you can use the [onlysend](/components/telegram_bot.onlysend/) platform instead. ### {% linkable_title Notification services %} Available services: `send_message`, `send_photo`, `send_document`, `send_location`, `edit_message`, `edit_replymarkup`, `edit_caption`, `answer_callback_query`. diff --git a/source/_components/telegram_bot.onlysend.markdown b/source/_components/telegram_bot.onlysend.markdown new file mode 100644 index 000000000000..9879a354010a --- /dev/null +++ b/source/_components/telegram_bot.onlysend.markdown @@ -0,0 +1,37 @@ +--- +layout: page +title: "Telegram onlysend" +description: "Telegram support to send messages only" +date: 2017-06-24 11:20 +sidebar: true +comments: false +sharing: true +footer: true +logo: telegram.png +ha_category: Telegram chatbot +ha_release: 0.48 +--- + +Telegram implementation to support **sending messages only**. Your Home Assistant does not have to be exposed to the Internet and there is no polling to receive messages sent to Bot. + +To integrate this into Home Assistant, add the following section to your `configuration.yaml` file: + +```yaml +# Example configuration.yaml entry + +telegram_bot: + - platform: onlysend + api_key: + allowed_chat_ids: + - 12345 + - 67890 +``` + +Configuration variables: + +- **allowed_chat_ids** (*Required*): A list of user in the `user_id` Telegram format enabled to interact to webhook +- **api_key** (*Required*): The API token of your bot. +- **parse_mode** (*Optional*): Default parser for messages if not explicit in message data: 'html' or 'markdown'. Default is 'markdown'. + +To get your `chat_id` and `api_key` follow the instructions [here](/components/notify.telegram/). + From 365fb09f4d7ee199d216b7c1fcacacab46b32551 Mon Sep 17 00:00:00 2001 From: azogue Date: Mon, 26 Jun 2017 11:52:37 +0200 Subject: [PATCH 2/3] change of platform name and small rewrite --- ...ot.onlysend.markdown => telegram_bot.broadcast.markdown} | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) rename source/_components/{telegram_bot.onlysend.markdown => telegram_bot.broadcast.markdown} (84%) diff --git a/source/_components/telegram_bot.onlysend.markdown b/source/_components/telegram_bot.broadcast.markdown similarity index 84% rename from source/_components/telegram_bot.onlysend.markdown rename to source/_components/telegram_bot.broadcast.markdown index 9879a354010a..5bfa018b732b 100644 --- a/source/_components/telegram_bot.onlysend.markdown +++ b/source/_components/telegram_bot.broadcast.markdown @@ -1,6 +1,6 @@ --- layout: page -title: "Telegram onlysend" +title: "Telegram broadcast" description: "Telegram support to send messages only" date: 2017-06-24 11:20 sidebar: true @@ -12,7 +12,7 @@ ha_category: Telegram chatbot ha_release: 0.48 --- -Telegram implementation to support **sending messages only**. Your Home Assistant does not have to be exposed to the Internet and there is no polling to receive messages sent to Bot. +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: @@ -20,7 +20,7 @@ To integrate this into Home Assistant, add the following section to your `config # Example configuration.yaml entry telegram_bot: - - platform: onlysend + - platform: broadcast api_key: allowed_chat_ids: - 12345 From d2e235996fc81ecc404bd7585a6b167d1238fb75 Mon Sep 17 00:00:00 2001 From: azogue Date: Mon, 26 Jun 2017 12:29:08 +0200 Subject: [PATCH 3/3] fix new platform name --- source/_components/telegram_bot.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_components/telegram_bot.markdown b/source/_components/telegram_bot.markdown index d247765436b7..56c699c8c8e3 100644 --- a/source/_components/telegram_bot.markdown +++ b/source/_components/telegram_bot.markdown @@ -17,7 +17,7 @@ Use Telegram on your mobile or desktop device to send and receive messages or co This component creates notification services to send, or edit previously sent, messages from a [Telegram Bot account](https://core.telegram.org/bots) configured either with the [polling](/components/telegram_bot.polling/) method or with the [webhooks](/components/telegram_bot.webhooks/) one, and trigger events when receiving messages. -If you don't need to receive messages, you can use the [onlysend](/components/telegram_bot.onlysend/) platform instead. +If you don't need to receive messages, you can use the [broadcast](/components/telegram_bot.broadcast/) platform instead. ### {% linkable_title Notification services %} Available services: `send_message`, `send_photo`, `send_document`, `send_location`, `edit_message`, `edit_replymarkup`, `edit_caption`, `answer_callback_query`.