From 3c03b6057b01632305bb1195b22218c04fb17625 Mon Sep 17 00:00:00 2001
From: Anurag Devanapally <6226493+andeart@users.noreply.github.com>
Date: Tue, 31 Dec 2024 14:30:00 -0800
Subject: [PATCH] Add troubleshooting for Roomba integration (#36631)

---
 source/_integrations/roomba.markdown | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/source/_integrations/roomba.markdown b/source/_integrations/roomba.markdown
index 6c5f4db1601..d56981f0dcb 100644
--- a/source/_integrations/roomba.markdown
+++ b/source/_integrations/roomba.markdown
@@ -88,3 +88,9 @@ Use this credentials in dorita980 lib :)
 ```
 
 Copy the password (everything between `=>` and `<=`, not including leading and trailing whitespace) into the Home Assistant password dialog.
+
+## Troubleshooting
+
+- **Integration wizard shows "Failed to connect" after submitting the password**: Before attempting a factory reset (which can be a cumbersome process), attempt submitting the password in the integration wizard while the Roomba is actively running (i.e. cleaning). Avoid opening the app to start a manual job to help with this. Instead, push the physical clean button on the device directly to start the manual job. This appears to resolve the issue on some models because they answer queries only while actively running.
+
+  If this still does not resolve the issue, factory reset the model.