mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-07-24 01:37:23 +00:00
Document new options for triggering Alexa routines (#21969)
This commit is contained in:
Mike Degatano
GitHub
parent
dce269c0c6
commit
2cc6620e96
@ -41,6 +41,53 @@ Steps to Integrate an Amazon Alexa Smart Home Skill with Home Assistant:
|
|||||||
- [Account Linking](#account-linking)
|
- [Account Linking](#account-linking)
|
||||||
- [Alexa Smart Home Component Configuration](#alexa-smart-home-component-configuration)
|
- [Alexa Smart Home Component Configuration](#alexa-smart-home-component-configuration)
|
||||||
- [Supported Platforms](#supported-platforms)
|
- [Supported Platforms](#supported-platforms)
|
||||||
|
- [Alarm Control Panel](#alarm-control-panel)
|
||||||
|
- [Arming](#arming)
|
||||||
|
- [Disarming](#disarming)
|
||||||
|
- [Alert, Automation, Group](#alert-automation-group)
|
||||||
|
- [Binary Sensor](#binary-sensor)
|
||||||
|
- [Routines](#routines)
|
||||||
|
- [Button, Input Button](#button-input-button)
|
||||||
|
- [Routines](#routines-1)
|
||||||
|
- [Doorbell Announcement](#doorbell-announcement)
|
||||||
|
- [Presence Detection with Binary Sensor](#presence-detection-with-binary-sensor)
|
||||||
|
- [Camera](#camera)
|
||||||
|
- [Climate](#climate)
|
||||||
|
- [Set Thermostat Temperature](#set-thermostat-temperature)
|
||||||
|
- [Thermostat Mode](#thermostat-mode)
|
||||||
|
- [Cover](#cover)
|
||||||
|
- [Open/Close/Raise/Lower](#opencloseraiselower)
|
||||||
|
- [Set Cover Position](#set-cover-position)
|
||||||
|
- [Set Cover Tilt](#set-cover-tilt)
|
||||||
|
- [Garage Doors](#garage-doors)
|
||||||
|
- [Fan](#fan)
|
||||||
|
- [Fan Speed](#fan-speed)
|
||||||
|
- [Fan Preset Mode](#fan-preset-mode)
|
||||||
|
- [Fan Direction](#fan-direction)
|
||||||
|
- [Fan Oscillation](#fan-oscillation)
|
||||||
|
- [Image Processing](#image-processing)
|
||||||
|
- [Presence Detection Notification](#presence-detection-notification)
|
||||||
|
- [Input Number](#input-number)
|
||||||
|
- [Light](#light)
|
||||||
|
- [Brightness](#brightness)
|
||||||
|
- [Color Temperature](#color-temperature)
|
||||||
|
- [Color](#color)
|
||||||
|
- [Lock](#lock)
|
||||||
|
- [Unlocking](#unlocking)
|
||||||
|
- [Media Player](#media-player)
|
||||||
|
- [Change Channel](#change-channel)
|
||||||
|
- [Speaker Volume](#speaker-volume)
|
||||||
|
- [Equalizer Mode](#equalizer-mode)
|
||||||
|
- [Inputs](#inputs)
|
||||||
|
- [Playback State](#playback-state)
|
||||||
|
- [Seek](#seek)
|
||||||
|
- [Scene](#scene)
|
||||||
|
- [Script](#script)
|
||||||
|
- [Sensor](#sensor)
|
||||||
|
- [Switch, Input Boolean](#switch-input-boolean)
|
||||||
|
- [Routines](#routines-2)
|
||||||
|
- [Timer](#timer)
|
||||||
|
- [Vacuum](#vacuum)
|
||||||
- [Alexa Web-Based App](#alexa-web-based-app)
|
- [Alexa Web-Based App](#alexa-web-based-app)
|
||||||
- [Troubleshooting](#troubleshooting)
|
- [Troubleshooting](#troubleshooting)
|
||||||
- [Debugging](#debugging)
|
- [Debugging](#debugging)
|
||||||
@ -409,50 +456,66 @@ Home Assistant supports the following integrations through Alexa using a Smart H
|
|||||||
|
|
||||||
The following integrations are currently supported:
|
The following integrations are currently supported:
|
||||||
|
|
||||||
- [Alarm Control Panel](#alarm-control-panel)
|
- [Requirements](#requirements)
|
||||||
- [Arming](#arming)
|
- [Create an Amazon Alexa Smart Home Skill](#create-an-amazon-alexa-smart-home-skill)
|
||||||
- [Disarming](#disarming)
|
- [Create an AWS Lambda Function](#create-an-aws-lambda-function)
|
||||||
- [Alert, Automation, Group, Input Boolean](#alert-automation-group-input-boolean)
|
- [Create an IAM Role for Lambda](#create-an-iam-role-for-lambda)
|
||||||
- [Binary Sensor](#binary-sensor)
|
- [Add Code to the Lambda Function](#add-code-to-the-lambda-function)
|
||||||
- [Routines](#routines)
|
- [Test the Lambda Function](#test-the-lambda-function)
|
||||||
- [Doorbell Announcement](#doorbell-announcement)
|
- [Configure the Smart Home Service Endpoint](#configure-the-smart-home-service-endpoint)
|
||||||
- [Presence Detection with Binary Sensor](#presence-detection-with-binary-sensor)
|
- [Account Linking](#account-linking)
|
||||||
- [Camera](#camera)
|
- [Alexa Smart Home Component Configuration](#alexa-smart-home-component-configuration)
|
||||||
- [Climate](#climate)
|
- [Supported Platforms](#supported-platforms)
|
||||||
- [Set Thermostat Temperature](#set-thermostat-temperature)
|
- [Alarm Control Panel](#alarm-control-panel)
|
||||||
- [Thermostat Mode](#thermostat-mode)
|
- [Arming](#arming)
|
||||||
- [Cover](#cover)
|
- [Disarming](#disarming)
|
||||||
- [Open/Close/Raise/Lower](#opencloseraiselower)
|
- [Alert, Automation, Group](#alert-automation-group)
|
||||||
- [Set Cover Position](#set-cover-position)
|
- [Binary Sensor](#binary-sensor)
|
||||||
- [Set Cover Tilt](#set-cover-tilt)
|
- [Routines](#routines)
|
||||||
- [Garage Doors](#garage-doors)
|
- [Button, Input Button](#button-input-button)
|
||||||
- [Fan](#fan)
|
- [Routines](#routines-1)
|
||||||
- [Fan Speed](#fan-speed)
|
- [Doorbell Announcement](#doorbell-announcement)
|
||||||
- [Fan Preset Mode](#fan-preset-mode)
|
- [Presence Detection with Binary Sensor](#presence-detection-with-binary-sensor)
|
||||||
- [Fan Direction](#fan-direction)
|
- [Camera](#camera)
|
||||||
- [Fan Oscillation](#fan-oscillation)
|
- [Climate](#climate)
|
||||||
- [Image Processing](#image-processing)
|
- [Set Thermostat Temperature](#set-thermostat-temperature)
|
||||||
- [Presence Detection Notification](#presence-detection-notification)
|
- [Thermostat Mode](#thermostat-mode)
|
||||||
- [Input Number](#input-number)
|
- [Cover](#cover)
|
||||||
- [Light](#light)
|
- [Open/Close/Raise/Lower](#opencloseraiselower)
|
||||||
- [Brightness](#brightness)
|
- [Set Cover Position](#set-cover-position)
|
||||||
- [Color Temperature](#color-temperature)
|
- [Set Cover Tilt](#set-cover-tilt)
|
||||||
- [Color](#color)
|
- [Garage Doors](#garage-doors)
|
||||||
- [Lock](#lock)
|
- [Fan](#fan)
|
||||||
- [Unlocking](#unlocking)
|
- [Fan Speed](#fan-speed)
|
||||||
- [Media Player](#media-player)
|
- [Fan Preset Mode](#fan-preset-mode)
|
||||||
- [Change Channel](#change-channel)
|
- [Fan Direction](#fan-direction)
|
||||||
- [Speaker Volume](#speaker-volume)
|
- [Fan Oscillation](#fan-oscillation)
|
||||||
- [Equalizer Mode](#equalizer-mode)
|
- [Image Processing](#image-processing)
|
||||||
- [Inputs](#inputs)
|
- [Presence Detection Notification](#presence-detection-notification)
|
||||||
- [Playback State](#playback-state)
|
- [Input Number](#input-number)
|
||||||
- [Seek](#seek)
|
- [Light](#light)
|
||||||
- [Scene](#scene)
|
- [Brightness](#brightness)
|
||||||
- [Script](#script)
|
- [Color Temperature](#color-temperature)
|
||||||
- [Sensor](#sensor)
|
- [Color](#color)
|
||||||
- [Switch](#switch)
|
- [Lock](#lock)
|
||||||
- [Timer](#timer)
|
- [Unlocking](#unlocking)
|
||||||
- [Vacuum](#vacuum)
|
- [Media Player](#media-player)
|
||||||
|
- [Change Channel](#change-channel)
|
||||||
|
- [Speaker Volume](#speaker-volume)
|
||||||
|
- [Equalizer Mode](#equalizer-mode)
|
||||||
|
- [Inputs](#inputs)
|
||||||
|
- [Playback State](#playback-state)
|
||||||
|
- [Seek](#seek)
|
||||||
|
- [Scene](#scene)
|
||||||
|
- [Script](#script)
|
||||||
|
- [Sensor](#sensor)
|
||||||
|
- [Switch, Input Boolean](#switch-input-boolean)
|
||||||
|
- [Routines](#routines-2)
|
||||||
|
- [Timer](#timer)
|
||||||
|
- [Vacuum](#vacuum)
|
||||||
|
- [Alexa Web-Based App](#alexa-web-based-app)
|
||||||
|
- [Troubleshooting](#troubleshooting)
|
||||||
|
- [Debugging](#debugging)
|
||||||
|
|
||||||
### Alarm Control Panel
|
### Alarm Control Panel
|
||||||
|
|
||||||
@ -489,9 +552,9 @@ To use the exiting code configured for the Alarm Control Panel the `code` must b
|
|||||||
|
|
||||||
The existing code is never communicated to Alexa from Home Assistant. During disarming, Alexa will ask for a PIN. The PIN spoken to Alexa is relayed to Home Assistant and passed to the `alarm_control_panel.alarm_disarm` service. If the `alarm_control_panel.alarm_disarm` service fails for any reason, it is assumed the PIN was incorrect and reported to Alexa as an invalid PIN.
|
The existing code is never communicated to Alexa from Home Assistant. During disarming, Alexa will ask for a PIN. The PIN spoken to Alexa is relayed to Home Assistant and passed to the `alarm_control_panel.alarm_disarm` service. If the `alarm_control_panel.alarm_disarm` service fails for any reason, it is assumed the PIN was incorrect and reported to Alexa as an invalid PIN.
|
||||||
|
|
||||||
### Alert, Automation, Group, Input Boolean
|
### Alert, Automation, Group
|
||||||
|
|
||||||
Turn on and off Alerts, Automations, Groups, and Input Boolean entities as switches.
|
Turn on and off Alert, Automation, and Group entities as switches.
|
||||||
|
|
||||||
- _"Alexa, turn on the front door alert."_
|
- _"Alexa, turn on the front door alert."_
|
||||||
- _"Alexa, turn off energy saving automations."_
|
- _"Alexa, turn off energy saving automations."_
|
||||||
@ -524,6 +587,26 @@ Alexa Routines can be triggered with Binary Sensors exposed as contact or motion
|
|||||||
|
|
||||||
Use the [Entity Customization Tool](/docs/configuration/customizing-devices/#customization-using-the-ui) to override the `device_class` attribute to expose a `binary_sensor` to Alexa.
|
Use the [Entity Customization Tool](/docs/configuration/customizing-devices/#customization-using-the-ui) to override the `device_class` attribute to expose a `binary_sensor` to Alexa.
|
||||||
|
|
||||||
|
### Button, Input Button
|
||||||
|
|
||||||
|
Activate Buttons and Input Buttons with the button name, or _"turn on"_ utterance. They will appear in the Alexa app as scenes.
|
||||||
|
|
||||||
|
- _"Alexa, Ring Phone."_
|
||||||
|
- _"Alexa, turn on Ring Phone."_
|
||||||
|
|
||||||
|
#### Routines
|
||||||
|
|
||||||
|
Requires [Proactive Events](#proactive-events) enabled.
|
||||||
|
|
||||||
|
Alexa Routines can be triggered when Buttons and Input Buttons are pressed.
|
||||||
|
|
||||||
|
In order to enable this, buttons will appear to have "presence detection" capability. This is what allows this functionality since Alexa does not support button type devices. To trigger a routine when a button is pressed, select the button in the when menu and then select the "Person" capability.
|
||||||
|
|
||||||
|
<p class='img'>
|
||||||
|
<a href='/images/integrations/alexa/alexa_app_button_trigger.png' target='_blank'>
|
||||||
|
<img height='460' src='/images/integrations/alexa/alexa_app_button_trigger.png' alt='Screenshot: Alexa App Button Routine Trigger'/></a>
|
||||||
|
</p>
|
||||||
|
|
||||||
#### Doorbell Announcement
|
#### Doorbell Announcement
|
||||||
|
|
||||||
Requires [Proactive Events](#proactive-events) enabled.
|
Requires [Proactive Events](#proactive-events) enabled.
|
||||||
@ -912,13 +995,26 @@ Only temperature sensors are configured at this time.
|
|||||||
- _"Alexa, what's the upstairs temperature?"_
|
- _"Alexa, what's the upstairs temperature?"_
|
||||||
- _"Alexa, what's the temperature of my ex-girlfriend's heart?"_
|
- _"Alexa, what's the temperature of my ex-girlfriend's heart?"_
|
||||||
|
|
||||||
### Switch
|
### Switch, Input Boolean
|
||||||
|
|
||||||
Support _"turn on"_ and _"turn off"_ utterances.
|
Support _"turn on"_ and _"turn off"_ utterances.
|
||||||
|
|
||||||
- _"Alexa, turn on the vacuum."_
|
- _"Alexa, turn on the vacuum."_
|
||||||
- _"Alexa, turn off the lights."_
|
- _"Alexa, turn off the lights."_
|
||||||
|
|
||||||
|
#### Routines
|
||||||
|
|
||||||
|
Requires [Proactive Events](#proactive-events) enabled.
|
||||||
|
|
||||||
|
Alexa Routines can be triggered when Switches and Input Booleans change state.
|
||||||
|
|
||||||
|
In order to enable this, Switches and Input Booleans will appear as contact sensors in the when menu of Alexa Routines. This is because Alexa does not support triggering routines from switch-type devices, only from contact and motion sensors. In this menu when you select a switch, `Open` corresponds to `on` and `Close` corresponds to `off`.
|
||||||
|
|
||||||
|
<p class='img'>
|
||||||
|
<a href='/images/integrations/alexa/alexa_app_switch_trigger.png' target='_blank'>
|
||||||
|
<img height='460' src='/images/integrations/alexa/alexa_app_switch_trigger.png' alt='Screenshot: Alexa App Switch Routine Trigger'/></a>
|
||||||
|
</p>
|
||||||
|
|
||||||
### Timer
|
### Timer
|
||||||
|
|
||||||
Start a timer with using the _"turn on"_ utterance.
|
Start a timer with using the _"turn on"_ utterance.
|
||||||
|
|||||||
BIN
source/images/integrations/alexa/alexa_app_button_trigger.png
Normal file
BIN
source/images/integrations/alexa/alexa_app_button_trigger.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 77 KiB |
BIN
source/images/integrations/alexa/alexa_app_switch_trigger.png
Normal file
BIN
source/images/integrations/alexa/alexa_app_switch_trigger.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 37 KiB |
Loading…
x
Reference in New Issue
Block a user