Documentation for Launch Request support (home-assistant#3104)

steverhoades · Landrash · commit 9710aae0829d · 2017-08-13T10:12:34.000+02:00
diff --git a/source/_components/alexa.markdown b/source/_components/alexa.markdown
@@ -192,6 +192,29 @@ intent_script:
 
 Now say `Alexa ask homeassistant to run <some script>` and Alexa will run that script for you.
 
+### {% linkable_title Support for Launch Requests %}
+There may be times when you want to respond to a launch request initiated from a command such as "Alexa, Red Alert!".
+
+To start you need to get the skill id:
+
+ - Log in to [Amazon developer console][amazon-dev-console]
+ - Click the Alexa button at the top of the console
+ - Click the Alexa Skills Kit Get Started button
+   - Locate the skill for which you would like Launch Request support
+   - Click the "View Skill ID" link and copy the ID
+
+The configuration is the same as an intent with the exception being you will use your skill ID instead of the intent name.
+```yaml
+intent_script:
+  amzn1.ask.skill.08888888-7777-6666-5555-444444444444:
+    action:
+      service: script.turn_on
+      entity_id: script.red_alert
+    speech:
+      type: plain
+      text: OK
+```
+
 ## {% linkable_title Giving Alexa Some Personality %}
 
 In the examples above, we told Alexa to say `OK` when she successfully completed the task. This is effective but a little dull! We can again use [templates] to spice things up a little.
