From 4b6358c12ba7c1fb80d4742c001f66d0849fde51 Mon Sep 17 00:00:00 2001 From: Philipp Schmitt Date: Wed, 8 Feb 2017 18:39:42 +0100 Subject: [PATCH] Document the notify.mailgun service (#1989) --- source/_components/notify.mailgun.markdown | 71 +++++++++++++++++++++ source/images/supported_brands/mailgun.png | Bin 0 -> 33218 bytes 2 files changed, 71 insertions(+) create mode 100644 source/_components/notify.mailgun.markdown create mode 100644 source/images/supported_brands/mailgun.png diff --git a/source/_components/notify.mailgun.markdown b/source/_components/notify.mailgun.markdown new file mode 100644 index 00000000000..52f69b5251e --- /dev/null +++ b/source/_components/notify.mailgun.markdown @@ -0,0 +1,71 @@ +--- +layout: page +title: "Mailgun" +description: "Instructions how to add Mailgun mail notifications to Home Assistant." +date: 2017-02-06 16:52 +sidebar: true +comments: false +sharing: true +footer: true +logo: mailgun.png +ha_category: Notifications +ha_release: 0.38 +--- + +The Mailgun notification service allows you to send emails via Mailgun's REST API. + +## {% linkable_title Sample configuration %} + +```yaml +# Example configuration.yaml entry +notify: + - name: NOTIFIER_NAME + platform: mailgun + domain: YOUR_MAILGUN_DOMAIN + token: TOKEN + recipient: RECIPIENT_EMAIL +``` + +Configuration variables: + +- **domain** (*Optional*): This is the domain name to be used when sending out mail. Defaults to the first custom domain you have set up. +- **sandbox** (*Optional*): Whether to use the sandboxed domain for outgoing mail. The `domain` item takes precedence over this. Defaults to `False`. +- **token** (*Required*): This is the API token that has been generated in your Mailgun account. +- **recipient** (*Required*): The email address of the recipient. +- **sender** (*Optional*): The sender's email address. Defaults to `hass@DOMAIN`, where `DOMAIN` is outgoint mail domain, as defined by the `domain` and `sanbox` configuration entries. + +## {% linkable_title Full configuration %} + +A full configuration example for the Mailgun notifier system can look like this: + +```yaml +# Example configuration.yaml entry +notify: + - name: mailgun + platform: mailgun + domain: mg.example.com + sanbox: False + token: 'token-XXXXXXXXX' + recipient: me@example.com +``` + +## {% linkable_title Example automation %} + +The following automation reacts to an event by sending out an email with two attachments. + +```yaml +# Example automation using Mailgun notifications +automation: + trigger: + platform: event + event_type: SPECIAL_EVENT + action: + service: notify.mailgun + data: + title: "Something special has happened" + message: "This a test message from Home Assistant" + data: + images: + - /home/pi/pic_test1.png + - /home/pi/pic_test2.png +``` diff --git a/source/images/supported_brands/mailgun.png b/source/images/supported_brands/mailgun.png new file mode 100644 index 0000000000000000000000000000000000000000..46126e7d30fabdab4c1ff09e4f17b3f7b9332cbc GIT binary patch literal 33218 zcmd42Wk6Kl)<3RD=O7?8#0*F`(hS{Q3P=u!NDtj0IY)*VX+2_n&xj$>|wfEWQm7b0&2_YTfojZ3()YX&>?%cVzdFReu z2tF?6PR6jBKIVtkOWDNB(CxXGFVw^Cj{Gw>8#`uo7pT3RfgSXjzk9EpG=_@B!N|nR zL|aSJ*3E?v`lk<{p9>5_edms}tRD<&>tyG}Y-4Bd;0ginH?)A69iBnJ#v2KM43QUr9{+&uxA%^WQFB zP7v_FlrquQV^(zYuwxeC6XCTL5PZZeCc!5tBKSyLkcU}FKv0-pK$u@pm{(9pQb0md zP=xuP4;UlO@NAzn-m zUQd5lFQ^}{t0&99IVjnA+Il#^yd2zIng4Kv+PHapLBJSI|7C&;>_2Q>J^yhN#$o(^ zP#C`;pTHlJ{@qbq`~SbIi_3p{dwLnz{g1x?D`QV1f0!M=ft{zDw}≤GVPm5e1V} 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 i{|^K;o&-L{dh&79{@v1ZcC!Blt|X@>TP