From 519ca9b0695be207cd6eb52b4548c7891e266acd Mon Sep 17 00:00:00 2001 From: Jameson_UK <1040621+jamesonuk@users.noreply.github.com> Date: Tue, 9 Sep 2025 21:45:44 +0100 Subject: [PATCH 1/5] fix typo in url --- source/_integrations/alexa_devices.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_integrations/alexa_devices.markdown b/source/_integrations/alexa_devices.markdown index 6092bb35a087..73b49d18bfba 100644 --- a/source/_integrations/alexa_devices.markdown +++ b/source/_integrations/alexa_devices.markdown @@ -103,7 +103,7 @@ This action essentially allows you to control Alexa using text commands rather t #### Action `alexa_devices.send_sound` -This action allows you to play one of the built-in Alexa sounds. The full list of sounds is available in [Amazon's documentation (needs authentication)](https://alexa.amazom.com/api/behaviors/entities?skillId=amzn1.ask.1p.sound) +This action allows you to play one of the built-in Alexa sounds. The full list of sounds is available in [Amazon's documentation (needs authentication)](https://alexa.amazon.com/api/behaviors/entities?skillId=amzn1.ask.1p.sound) | Data attribute | Optional | Description | | -------------- | -------- | ----------------------------------------- | From 2df9b52892e9e6a691c7b5b07d881d41201c924d Mon Sep 17 00:00:00 2001 From: Jameson_UK <1040621+jamesonuk@users.noreply.github.com> Date: Wed, 5 Nov 2025 10:53:22 +0000 Subject: [PATCH 2/5] alexa_devices updates --- source/_integrations/alexa_devices.markdown | 39 +++++++++++++++++---- 1 file changed, 32 insertions(+), 7 deletions(-) diff --git a/source/_integrations/alexa_devices.markdown b/source/_integrations/alexa_devices.markdown index 73b49d18bfba..8d078c36217b 100644 --- a/source/_integrations/alexa_devices.markdown +++ b/source/_integrations/alexa_devices.markdown @@ -139,6 +139,28 @@ data: text_command: whats the time ``` +### Set volume + +{% note %} +Once media player functionality is supported you will be able to achieve this through standard media player actions. +{% endnote %} + +```yaml +action: alexa_devices.send_text_command +data: + device_id: 037d79c1af96c67ba57ebcae560fb18e + text_command: volume 7 +``` + +### Control devices in Alexa + +```yaml +action: alexa_devices.send_text_command +data: + device_id: 037d79c1af96c67ba57ebcae560fb18e + text_command: turn study lights off +``` + ### Play BBC Radio 6 ```yaml @@ -196,7 +218,7 @@ The **Alexa Devices** {% term integration %} provides the following entities: - Binary sensor - main and Bluetooth connectivity - Notify - Speak and Announce notifications -- Sensor - temperature and illuminance sensors +- Sensor - temperature, illuminance, and motion sensors - Switch - Do not disturb ## Known limitations @@ -205,17 +227,20 @@ This integration requires multifactor authentication using an authentication app ## Troubleshooting -### Can’t set up the integration +### Sensors unavailable + +#### Symptom: "Too many requests" + +You see something similar to -#### Symptom: "Not found" +- `Error retrieving devices state: Too many requests for path ['listEndpoints']` +- `Error retrieving data: CannotRetrieveData('Request failed: Bad Request')` -When trying to set up the integration, the form shows the message "Not found". +In logs. ##### Description -This appears to indicate that your Alexa devices aren't owned by you, but are connected through Amazon Family. -This setup isn't supported by the Alexa Mobile app, so it's not supported by this integration. -Move the devices to your primary account. +This is down to rate limits applied by Amazon. We are looking to reduce these errors but if they are causing you an issue you can disable polling for the integration which will stop these errors, this will however stop DND, sensors and connectivity from being updated but speech, announcements and text commands will continue to work. ## Removing the integration From ce7429bec09bcbb43655340db156bb1d8fdb3f7d Mon Sep 17 00:00:00 2001 From: Jameson_UK <1040621+jamesonuk@users.noreply.github.com> Date: Thu, 6 Nov 2025 18:09:04 +0000 Subject: [PATCH 3/5] add additional troubleshooting notes --- source/_integrations/alexa_devices.markdown | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/source/_integrations/alexa_devices.markdown b/source/_integrations/alexa_devices.markdown index 8d078c36217b..22bfecbd26c2 100644 --- a/source/_integrations/alexa_devices.markdown +++ b/source/_integrations/alexa_devices.markdown @@ -227,6 +227,22 @@ This integration requires multifactor authentication using an authentication app ## Troubleshooting +### Unable to Setup + +#### Symptom: "CannotAuthenticate" + +##### Description + +You will see `MFA OTP code not found on login page` or `Cannot find "auth-mfa-otpcode" in html source` in the logs when trying to setup the integration. This is because the authentication details are incorrect. + +You need to ensure you are: + +- using the right credentials (The ones you would use to login to the Alexa app and Amazon shopping site) +- setup to use app based 2FA +- not setup to receive SMS 2FA codes + +To test this you should login to your local amazon shopping site in incognition/private mode in your browser and check you are are prompted for the OTP code from you authenticator app and you are able to login sucessfully. + ### Sensors unavailable #### Symptom: "Too many requests" From b695df356c892aa1b646677ef86ed56ab5e55ac4 Mon Sep 17 00:00:00 2001 From: Jameson_UK <1040621+jamesonuk@users.noreply.github.com> Date: Fri, 7 Nov 2025 17:42:53 +0000 Subject: [PATCH 4/5] copilot suggestions --- source/_integrations/alexa_devices.markdown | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/source/_integrations/alexa_devices.markdown b/source/_integrations/alexa_devices.markdown index 22bfecbd26c2..f11dfcb85a45 100644 --- a/source/_integrations/alexa_devices.markdown +++ b/source/_integrations/alexa_devices.markdown @@ -227,21 +227,21 @@ This integration requires multifactor authentication using an authentication app ## Troubleshooting -### Unable to Setup +### Unable to setup #### Symptom: "CannotAuthenticate" ##### Description -You will see `MFA OTP code not found on login page` or `Cannot find "auth-mfa-otpcode" in html source` in the logs when trying to setup the integration. This is because the authentication details are incorrect. +You will see `MFA OTP code not found on login page` or `Cannot find "auth-mfa-otpcode" in html source` in the logs when trying to set up the integration. This is because the authentication details are incorrect. You need to ensure you are: -- using the right credentials (The ones you would use to login to the Alexa app and Amazon shopping site) -- setup to use app based 2FA -- not setup to receive SMS 2FA codes +- using the right credentials (The ones you would use to log in to the Alexa app and Amazon shopping site) +- set up to use app based 2FA +- not set up to receive SMS 2FA codes -To test this you should login to your local amazon shopping site in incognition/private mode in your browser and check you are are prompted for the OTP code from you authenticator app and you are able to login sucessfully. +To test this you should log in to your local Amazon shopping site in incognito/private mode in your browser and check you are prompted for the OTP code from your authenticator app, and you are able to log in successfully. ### Sensors unavailable @@ -256,7 +256,7 @@ In logs. ##### Description -This is down to rate limits applied by Amazon. We are looking to reduce these errors but if they are causing you an issue you can disable polling for the integration which will stop these errors, this will however stop DND, sensors and connectivity from being updated but speech, announcements and text commands will continue to work. +This happens because of rate limits applied by Amazon. We are working to reduce these errors. If these errors are causing you issues, you can disable polling for the integration. Disabling polling will stop these errors, but it will also stop DND, sensors, and connectivity from being updated. However, speech, announcements, and text commands will continue to work. ## Removing the integration From e13fbcae56af714a639fc44eb5e7dbcf25bd878a Mon Sep 17 00:00:00 2001 From: Jameson_UK <1040621+jamesonuk@users.noreply.github.com> Date: Fri, 7 Nov 2025 18:05:00 +0000 Subject: [PATCH 5/5] minor addition to warning --- source/_integrations/alexa_devices.markdown | 2 ++ 1 file changed, 2 insertions(+) diff --git a/source/_integrations/alexa_devices.markdown b/source/_integrations/alexa_devices.markdown index 29d5dae3255c..b547344e352c 100644 --- a/source/_integrations/alexa_devices.markdown +++ b/source/_integrations/alexa_devices.markdown @@ -44,6 +44,8 @@ There is support for the following device families within Home Assistant: This integration requires multifactor authentication using an authentication app (such as Microsoft Authenticator, for example). To enable MFA, in your Amazon account settings select **Login & Security** > **2-step verification** > **Backup methods** > **Add new app**. See [Amazon's documentation](https://www.amazon.com/gp/help/customer/display.html?nodeId=G9MX9LXNWXFKMJYU) for more information. +You must ensure the authenticator app is setup as your preferred method for 2FA. + {% endwarning %} {% include integrations/config_flow.md %}