jeans/home-assistant.io
jeans/home-assistant.io
1
0
Fork 0
mirror of https://github.com/home-assistant/home-assistant.io.git synced 2025-07-23 01:06:52 +00:00
Code Issues Packages Projects Releases Wiki Activity

Update alexa flash briefings for new console layout and password (#13751)

Browse Source
This commit is contained in:
Thomas Hollstegge 2020-06-23 17:58:38 +02:00 committed by GitHub
parent 8c0da67f92
commit 68dfd8da2c
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 16 additions and 12 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

28
source/_integrations/alexa.flash_briefings.markdown
View File

@ -33,6 +33,7 @@ Here's an example configuration of a Flash briefing skill that will tell you who
{% raw %}# Example configuration.yaml entry
alexa:
flash_briefings:
password: YOUR_PASSWORD
whoishome:
- title: Who's at home?
text: >
@ -52,26 +53,29 @@ Please refer to the [Amazon documentation][flash-briefing-api-docs] for more inf
### Configuring your Flash Briefing skill
- Log in to [Amazon developer console][amazon-dev-console]
- Click the Alexa navigation tab at the top of the console
- Click on the "Get Started >" button under "Alexa Skills Kit"
- Click the yellow "Add a new skill" button in the top right
- Click on the "Create Alexa Skills" button
- Click the blue "Console" button in the top right
- Click the light blue "Create Skill" button in the top right
- Skill Information
- For Skill Type select "Flash Briefing Skill API"
- You can enter whatever name you want
- Hit "Next"
- Interaction Model
- Nothing to do here
- Configuration
- For "Choose a model" select "Flash Briefing"
- Hit "Create Skill" in the top right corner
- Flash Briefing
- Enter a custom error message, like "This skill is currently not available."
- Add new feed
- For URL, enter `https://YOUR_HOST/api/alexa/flash_briefings/BRIEFING_ID?api_password=YOUR_API_PASSWORD` where `BRIEFING_ID` is the key you entered in your configuration (such as `whoishome` in the above example). **NOTE:** Do not use a non-standard HTTP or HTTPS port, AWS will not connect to it.
- For Preamble, enter "From Home Assistant" (or anything you like)
- For Name, enter "Home Assistant"
- Choose Content type "Text"
- Select a genre, e.g. "Other"
- For Feed, enter `https://YOUR_HOST/api/alexa/flash_briefings/BRIEFING_ID?password=YOUR_PASSWORD` where `BRIEFING_ID` is the key you entered in your configuration (such as `whoishome` in the above example). **NOTE:** Do not use a non-standard HTTP or HTTPS port, AWS will not connect to it.
- You can use this [specially sized Home Assistant logo][large-icon] as the Feed Icon
- All other settings are up to you
- Hit "Next"
- Hit "Add"
- Hit "Save" in the top right corner
- Test
- Having passed all validations to reach this screen, you can now click on "< Back to All Skills" as your flash briefing is now available as in "Development" service.
- To invoke your flash briefing, open the Alexa app on your phone or go to the [Alexa Settings Site][alexa-settings-site], open the "Skills" configuration section, select "Your Skills", scroll to the bottom, tap on the Flash Briefing Skill you just created, enable it, then manage Flash Briefing and adjust ordering as necessary. Finally ask your Echo for your "news","flash briefing", or "briefing".
[amazon-dev-console]: https://developer.amazon.com
[amazon-dev-console]: https://developer.amazon.com/alexa
[flash-briefing-api]: https://developer.amazon.com/docs/flashbriefing/understand-the-flash-briefing-skill-api.html
[flash-briefing-api-docs]: https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/flash-briefing-skill-api-feed-reference
[large-icon]: /images/integrations/alexa/alexa-512x512.png