From 908db7218509790206e133f1ab3f018a89ef78b3 Mon Sep 17 00:00:00 2001
From: "Steven B." <51370195+sdb9696@users.noreply.github.com>
Date: Tue, 10 Sep 2024 14:01:30 +0100
Subject: [PATCH] Ring/event stability (#34644)

* Update ring docs on event stability

* Update typos and tweak wording

* Update wording

* Fix typo

* Tweak wording

* Tiny tweaks

---------

Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com>
---
 source/_integrations/ring.markdown | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/source/_integrations/ring.markdown b/source/_integrations/ring.markdown
index 556b1129ed1..f29068051c1 100644
--- a/source/_integrations/ring.markdown
+++ b/source/_integrations/ring.markdown
@@ -140,6 +140,16 @@ hass.services.call("downloader", "download_file", data)
 
 The event entity captures events like doorbell rings, motion alerts, and intercom unlocking.
 
+### Realtime event stability
+
+If you are experiencing issues with receiving ring alerts, the reason could be that you have too many authenticated devices on your ring account.
+Prior to version 2023.12.0, the Home Assistant ring integration would register a new entry in `Authorized Client Devices` in the `Control Centre` at [ring.com](https://account.ring.com/account/control-center/authorized-devices) every time it restarted.
+If you have been using the ring integration before this, you may have many `Authorized Client Devices` in the `Control Centre` on [ring.com](https://account.ring.com/account/control-center/authorized-devices).
+This can cause issues receiving ring alerts.
+You should delete all authorised devices from [ring.com](https://account.ring.com/account/control-center/authorized-devices) `Control Centre` which are from Home Assistant
+(i.e. do not delete those named `iPhone` or `Android`; Home Assistant authorized devices are named `ring-doorbell:HomeAssistant/something` or `Python`).
+If you have too many `Authorised Client Devices` to delete them individually, it might be easier to `Remove all devices` and then re-authorize your required devices.
+
 ## Sensor
 
 Once you have enabled the [Ring integration](/integrations/ring), you can start using the sensor platform. Currently, it supports doorbell, external chimes and stickup cameras.