alexa devices updates

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 |
 | -------------- | -------- | ----------------------------------------- |
@@ -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,36 @@ This integration requires multifactor authentication using an authentication app
 
 ## Troubleshooting
 
-### Can’t set up the integration
+### 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"
+
+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