From 3867353a4fb1b20361a5a52bb0096aaa18041013 Mon Sep 17 00:00:00 2001
From: Kevin Siml <appzer@users.noreply.github.com>
Date: Fri, 5 Jan 2018 17:31:45 +0100
Subject: [PATCH] Update Pushsafer documentation (#4345)

* Update notify.pushsafer.markdown

* Update notify.pushsafer.markdown

* Update notify.pushsafer.markdown

* Update notify.pushsafer.markdown

* Update notify.pushsafer.markdown

* Change format
---
 source/_components/notify.pushsafer.markdown | 71 +++++++++++++++++++-
 1 file changed, 69 insertions(+), 2 deletions(-)

diff --git a/source/_components/notify.pushsafer.markdown b/source/_components/notify.pushsafer.markdown
index 4b003d97d82..a62e213e747 100644
--- a/source/_components/notify.pushsafer.markdown
+++ b/source/_components/notify.pushsafer.markdown
@@ -2,7 +2,7 @@
 layout: page
 title: "Pushsafer"
 description: "Instructions how to add Pushsafer notifications to Home Assistant."
-date: 2017-02-17 20:46
+date: 2018-01-05 11:15
 sidebar: true
 comments: false
 sharing: true
@@ -27,11 +27,78 @@ notify:
     private_key: ABCDEFGHJKLMNOPQRSTUVXYZ
 ```
 
-Configuration variables:
+**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`.
 - **private_key** (*Required*): Your private or alias key. Private key = send the notification to all devices with standard params, alias key send the notification to the devices stored in the alias with predefined params.
 
+### {% linkable_title Examples %}
+
+Message to two devices with formated text.
+
+```json
+{
+  "title": "Test to 2 devices",
+  "message": "Attention [b]bold[/b] text[br][url=https://www.pushsafer.com]Link to Pushsafer[/url]",
+  "target": ["1111", "2222"],
+  "data": {
+    "icon": "2", 
+    "iconcolor": "#FF0000",
+    "sound": "2",
+    "vibration": "1",
+    "url": "https://home-assistant.io/",
+    "urltitle": "Open Home Assistant",
+    "time2live": "0"
+  }
+}
+```
+
+Message to one device with formated text and image from an external URL.
+
+```json
+{
+  "title": "Test to 1 device with image from an url",
+  "message": "Attention [i]italic[/i] Text[br][url=https://home-assistant.io/]Testlink[/url]",
+  "target": ["1111"],
+  "data": {
+    "icon": "14", 
+    "iconcolor": "#FFFF00",
+    "sound": "22",
+    "vibration": "3",
+    "url": "https://home-assistant.io/",
+    "urltitle": "Open Home Assistant",
+    "time2live": "60",
+    "picture1": {
+       "url":"https://home-assistant.io/images/components/alexa/alexa-512x512.png"
+     }
+  }
+}
+```
+
+Message to two devices and one device group with formated text and local image.
+
+```json
+{
+  "title": "Test to 3 devices with local image",
+  "message": "Attention [i]italic[/i] Text[br][url=https://home-assistant.io/]Testlink[/url]",
+  "target": ["1111","2222","gs3333"],
+  "data": {
+    "icon": "20", 
+    "iconcolor": "#FF00FF",
+    "sound": "33",
+    "vibration": "0",
+    "url": "https://home-assistant.io/",
+    "urltitle": "Open Home Assistant",
+    "time2live": "10",
+    "picture1": {
+       "path":"C:\\Users\\Kevin\\AppData\\Roaming\\.homeassistant\\image-760-testimage.jpg"
+     }
+  }
+}
+```
+
+To customize your push-notification you can take a look at the [Pushsafer API description](https://www.pushsafer.com/en/pushapi).
+
 When setting up the application you can use this [icon](https://home-assistant.io/images/favicon-192x192.png).
 
 To use notifications, please see the [getting started with automation page](/getting-started/automation/).