From 73554b7c473d4ab42d495a79afa0c9f68e8fafbc Mon Sep 17 00:00:00 2001 From: giuseppeg88 Date: Sun, 8 Jun 2025 11:43:41 +0000 Subject: [PATCH 1/4] docs: Add manual alarm bad code attempt event --- source/_integrations/manual.markdown | 28 ++++++++++++++++++++++++++++ 1 file changed, 28 insertions(+) diff --git a/source/_integrations/manual.markdown b/source/_integrations/manual.markdown index 3bf9a84598b3..42b19c3b12e4 100644 --- a/source/_integrations/manual.markdown +++ b/source/_integrations/manual.markdown @@ -101,6 +101,34 @@ armed_custom_bypass/armed_home/armed_away/armed_night/armed_vacation/disarmed/tr type: integer {% endconfiguration %} +### Event: `manual_alarm_bad_code_attempt` + +This event is fired when an attempt to change the state of a manual alarm control panel (e.g., arm or disarm) fails due to an invalid code being provided. + +#### Event Data + +| Key | Type | Description | +| --------- | ------ | --------------------------------------------- | +| `entity_id` | `string` | The entity ID of the alarm control panel (e.g., `alarm_control_panel.my_alarm`). | +| `action` | `string` | The attempted action or target state (e.g., `disarmed`, `armed_away`, `armed_home`). | +| `user_id` | `string` | The user ID who initiated the service call (if available). | + +Example automation trigger: + +```yaml +automation: + - alias: "Notify on invalid manual alarm code attempt" + trigger: + platform: event + event_type: manual_alarm_bad_code_attempt + action: + - service: notify.your_notification_service # Replace with your actual notification service + data: + message: > + Invalid alarm code attempt for {{ trigger.event.data.entity_id }} + by user ID {{ trigger.event.data.user_id }} + while attempting action {{ trigger.event.data.action }}. + ## State machine The state machine of the manual alarm integration is complex but powerful. The From d1c916b072803620ebbbf4c09ad1e27399fff632 Mon Sep 17 00:00:00 2001 From: giuseppeg88 Date: Sun, 8 Jun 2025 15:25:56 +0200 Subject: [PATCH 2/4] Update manual.markdown --- source/_integrations/manual.markdown | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/_integrations/manual.markdown b/source/_integrations/manual.markdown index 42b19c3b12e4..03160efd133c 100644 --- a/source/_integrations/manual.markdown +++ b/source/_integrations/manual.markdown @@ -119,8 +119,8 @@ Example automation trigger: automation: - alias: "Notify on invalid manual alarm code attempt" trigger: - platform: event - event_type: manual_alarm_bad_code_attempt + - platform: event + event_type: manual_alarm_bad_code_attempt action: - service: notify.your_notification_service # Replace with your actual notification service data: From 3f3e75851c5b3d5e8bbde6d86b3b1f102d1fecf7 Mon Sep 17 00:00:00 2001 From: giuseppeg88 Date: Sun, 8 Jun 2025 15:53:44 +0200 Subject: [PATCH 3/4] Update manual.markdown --- source/_integrations/manual.markdown | 1 + 1 file changed, 1 insertion(+) diff --git a/source/_integrations/manual.markdown b/source/_integrations/manual.markdown index 03160efd133c..d9170ff9fff9 100644 --- a/source/_integrations/manual.markdown +++ b/source/_integrations/manual.markdown @@ -128,6 +128,7 @@ automation: Invalid alarm code attempt for {{ trigger.event.data.entity_id }} by user ID {{ trigger.event.data.user_id }} while attempting action {{ trigger.event.data.action }}. +``` ## State machine From 8de47a912e0826c444b79374b98546e3404e1f5f Mon Sep 17 00:00:00 2001 From: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> Date: Fri, 7 Nov 2025 05:31:38 +0100 Subject: [PATCH 4/4] tiny style tweaks --- source/_integrations/manual.markdown | 14 ++++++-------- 1 file changed, 6 insertions(+), 8 deletions(-) diff --git a/source/_integrations/manual.markdown b/source/_integrations/manual.markdown index d9170ff9fff9..08e2885ee806 100644 --- a/source/_integrations/manual.markdown +++ b/source/_integrations/manual.markdown @@ -101,17 +101,15 @@ armed_custom_bypass/armed_home/armed_away/armed_night/armed_vacation/disarmed/tr type: integer {% endconfiguration %} -### Event: `manual_alarm_bad_code_attempt` +### Event: Manual alarm bad code attempt -This event is fired when an attempt to change the state of a manual alarm control panel (e.g., arm or disarm) fails due to an invalid code being provided. +The `manual_alarm_bad_code_attempt` event is fired when an attempt to change the state of a manual alarm control panel (for example, arm or disarm) fails because an invalid code was entered. -#### Event Data +#### Event data -| Key | Type | Description | -| --------- | ------ | --------------------------------------------- | -| `entity_id` | `string` | The entity ID of the alarm control panel (e.g., `alarm_control_panel.my_alarm`). | -| `action` | `string` | The attempted action or target state (e.g., `disarmed`, `armed_away`, `armed_home`). | -| `user_id` | `string` | The user ID who initiated the service call (if available). | +- **entity_id** (string): The entity ID of the alarm control panel (for example, `alarm_control_panel.my_alarm`). +- **action** (string): The attempted action or target state (for example, `disarmed`, `armed_away`, `armed_home`). +- **user_id** (string): The user ID who initiated the service call (if available). Example automation trigger: