docs(generic): add home assistant example (#336)

Author: piksel

docs/examples/generic.md

@@ -0,0 +1,19 @@
+# Examples
+
+Examples of service URLs that can be used with [the generic service](../../services/generic) together with common service providers.
+
+## Home Assistant
+
+The service URL needs to be:
+```
+generic://HAIPAddress:HAPort/api/webhook/WebhookIDFromHA?template=json
+```
+
+And, if you need http://
+```
+generic://HAIPAddress:HAPort/api/webhook/WebhookIDFromHA?template=json&disabletls=yes
+```
+
+Then, in HA, use `{{ trigger.json.message }}` to get the message sent from the JSON.
+
+_Credit [@JeffCrum1](https://github.com/JeffCrum1), source: [https://github.com/containrrr/shoutrrr/issues/325#issuecomment-1460105065]_

docs/services/generic.md

@@ -4,6 +4,8 @@ supports receiving the message via a POST request.
 Usually, this requires customization on the receiving end to interpret the payload that it receives, and might
 not be a viable approach.
 
+Common examples for use with service providers can be found under [examples](../examples/generic.md).
+
 ## JSON template
 By using the built in `JSON` template (`template=json`) you can create a generic JSON payload. The keys used for `title` and `message` can be overriden
 by supplying the params/query values `titleKey` and `messageKey`.
@@ -26,6 +28,9 @@ would become
 generic+https://example.com/api/v1/postStuff
 ```
 
+!!! note
+    Any query variables added to the URL will be escaped so that they can be forwarded to the remote server. That means that you cannot use `?template=json` with the  `generic+https://`, just use `generic://` instead!
+
 ## Forwarded query variables
 All query variables that are not listed in the [Query/Param Props](#queryparam_props) section will be
 forwarded to the target endpoint.
@@ -41,4 +46,4 @@ If you need to pass a query variable that _is_ reserved, you can prefix it with
 
 ## URL Format
 
---8<-- "docs/services/generic/config.md"
+--8<-- "docs/services/generic/config.md"

mkdocs.yml

@@ -54,6 +54,8 @@ nav:
       - Generic Webhook: 'services/generic.md'
   - Guides:
       - Slack: 'guides/slack/index.md'
+  - Examples:
+      - Generic Webhook: 'examples/generic.md'
   - Advanced usage:
       - Proxy: 'proxy.md'