From e411cb4747f371935469f0d5102ea3c258a39c4b Mon Sep 17 00:00:00 2001
From: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com>
Date: Wed, 28 Jun 2023 21:58:30 +0200
Subject: [PATCH] Voice control: add some troubleshooting steps (#27999)

* Voice control: add some troubleshooting steps

* Add speech-to-text troubleshooting steps
---
 source/voice_control/troubleshooting.markdown | 28 ++++++++++++++++---
 1 file changed, 24 insertions(+), 4 deletions(-)

diff --git a/source/voice_control/troubleshooting.markdown b/source/voice_control/troubleshooting.markdown
index e402d4cb04e..fb4beea83bd 100644
--- a/source/voice_control/troubleshooting.markdown
+++ b/source/voice_control/troubleshooting.markdown
@@ -6,7 +6,7 @@ This section lists a few steps that may help you troubleshoot issues with Assist
 
 ## View debug information
 
-1. Go to **Settings** > **Voice assistants**.
+1. Go to {% my voice_assistants title="**Settings** > **Voice assistants**" %}.
 1. From the list of assistants, select your assistant.
    ![Select your assistant](/images/assist/assistant-select.png)
 1. In the dialog, select **Debug**.
@@ -25,9 +25,29 @@ This section lists a few steps that may help you troubleshoot issues with Assist
 ![Open the pipeline debug dialog](/images/assist/assistant-debug-pipeline-02.png)
 1. Check if it worked.
 ![Open the pipeline debug dialog](/images/assist/assistant-debug-pipeline-03.png)
-   * If the phrase does not work, try a variant. For example, if *Turn off the light* doesn't work, try: *Turn off the lights in the kitchen*.
-   * Check if your phrase is [supported](/voice_control/builtin_sentences/).
-   * Make sure you are using the name of the area as it is defined in Home Assistant. If you have a room called *bathroom*, the phrase *Turning on the lights in the bath* won’t work.
+
+## If the phrase did not work, even without voice
+
+1. Try a variant. For example, if *Turn off the light* doesn't work, try: *Turn off the lights in the kitchen*.
+1. Check if the phrase is [supported](/voice_control/builtin_sentences/).
+1. Check if the devices are exposed to Assist.
+   * Under {% my voice_assistants title="**Settings** > **Voice assistants**" %}, open the **Expose** tab.
+   * If you do not see the device in the list, select **Expose entities** and add the device.
+1. If the phrase includes an area, make sure the device is added to that area.
+   * Under **{% my integrations title="Settings > Devices & Services" %}**, on the integration, select devices.
+   * From the list of devices, select the device of interest.
+   * In the top right corner, select the pencil item.
+   * Add the device to that area.
+1. Make sure you are using the name of the area exactly as it is defined in Home Assistant.
+
+## If the phrase worked with Assist, but not with voice
+
+1. [Open the debug view](#view-debug-information).
+1. If you see that speech-to-text failed:
+   - Go back to your voice assistant.
+   - Under **Speech-to-text**, check if there are multiple variants supported for your language.
+   - Try out different language variants. It could be that recognition works better with one of the variants.
+
 
 ## I do not see any assistant