From 6e9f615a9570a1016326766644f8738e01e7f93d Mon Sep 17 00:00:00 2001
From: Arne Moor <arne@moor-service.ch>
Date: Sat, 6 Dec 2025 02:49:17 +0100
Subject: [PATCH] docs: update allowFrom examples with Telegram identifiers

- Update Full Configuration example to include Telegram identifiers
- Expand allowFrom documentation to show all supported formats
- Add note about telegram: prefix requirement in allowFrom lists
- Show examples of telegram usernames, phone numbers, and numeric IDs
---
 docs/configuration.md | 21 ++++++++++++++++++---
 1 file changed, 18 insertions(+), 3 deletions(-)

diff --git a/docs/configuration.md b/docs/configuration.md
index 693127f54..f905edf02 100644
--- a/docs/configuration.md
+++ b/docs/configuration.md
@@ -27,7 +27,9 @@ CLAWDIS uses a JSON configuration file at `~/.clawdis/clawdis.json`.
   "inbound": {
     "allowFrom": [
       "+436769770569",
-      "+447511247203"
+      "+447511247203",
+      "telegram:@username",
+      "telegram:+436769770569"
     ],
     "groupChat": {
       "requireMention": true,
@@ -75,12 +77,25 @@ CLAWDIS uses a JSON configuration file at `~/.clawdis/clawdis.json`.
 
 ### `inbound.allowFrom`
 
-Array of E.164 phone numbers allowed to trigger the AI. Use `["*"]` to allow everyone (dangerous!).
+Array of identifiers allowed to trigger the AI. Use `["*"]` to allow everyone (dangerous!).
+
+Supports multiple identifier formats:
+- E.164 phone numbers for WhatsApp: `"+436769770569"`
+- Telegram usernames: `"telegram:@username"`
+- Telegram phone numbers: `"telegram:+436769770569"`
+- Telegram numeric IDs: `"telegram:123456789"`
 
 ```json
-"allowFrom": ["+436769770569", "+447511247203"]
+"allowFrom": [
+  "+436769770569",
+  "+447511247203",
+  "telegram:@username",
+  "telegram:+436769770569"
+]
 ```
 
+**Note:** The `telegram:` prefix is automatically added by the system when receiving messages. You must include it in your allowFrom list for Telegram users.
+
 ### `inbound.groupChat`
 
 | Key | Type | Default | Description |