From d526faf712df69bf7cda3f3d8fb96751d2296317 Mon Sep 17 00:00:00 2001
From: Mark Glasgow <markglasgow@gmail.com>
Date: Fri, 18 Mar 2022 13:11:11 +0000
Subject: [PATCH] Updated Section Telegram (basic) (markdown)

---
 Section-Telegram-(basic).md | 91 +++++++++++++++++++++++++++----------
 1 file changed, 68 insertions(+), 23 deletions(-)

diff --git a/Section-Telegram-(basic).md b/Section-Telegram-(basic).md
index 45b054a..aa9504e 100644
--- a/Section-Telegram-(basic).md
+++ b/Section-Telegram-(basic).md
@@ -8,28 +8,6 @@ MessageFormat="HTMLNick"
 IgnoreMessages="^/" #Ignore bot command spam
 ```
 
-Here is an example gateway bridging `Discord`<>`Telegram`
-
-
-```toml
-[[gateway]]
-name="YourUniqueGateWayName"
-enable=true
-
-    [[gateway.inout]]
-    account="telegram.mytelegram"
-    channel="-100xxx"
-
-    [[gateway.inout]]
-    account="discord.mydiscord"
-    channel="channel-name" 
-```
-The easiest way to retrieve your channel id is to navigate to https://web.telegram.org/ and simply copy the numbers at the end of the hyperlink into the `xxx` position in the example snippet above. 
-
-
-To add more nodes to this bridge, you simply need to add additional `[[gateway.inout]]` fields.
-
-
 ## Retrieving your chat number from Matterbridge
 ### Setup
 Matterbridge can output your chat number as debug information. Here's how.
@@ -74,4 +52,71 @@ Matterbridge can output your chat number as debug information. Here's how.
 > **BotFather**: Success! The new status is: DISABLED. /help
 
 
-(copied from [this stack overflow answer](https://stackoverflow.com/a/45441585))
\ No newline at end of file
+(copied from [this stack overflow answer](https://stackoverflow.com/a/45441585))
+
+
+## Tutorial
+
+This basic example will guide you through getting started on your first Telegram bridge. 
+
+### 1. Speak to the BotFather. 
+
+Message the [BotFather](https://t.me/BotFather) bot and run the `/newbot` command to get started. Once you pick a name it will provide you with a `token` used to access the HTTP API.
+
+**Set Privacy:**
+
+> **You**: /setprivacy
+> 
+> **BotFather**: Choose a bot to change group messages settings.
+> 
+> **You**: @your_name_bot
+> 
+> **BotFather**: 'Enable' - your bot will only receive messages that either start with the '/' symbol or mention the bot by username.
+>
+> - 'Disable' - your bot will receive all messages that people send to groups.
+> - Current status is: ENABLED
+>
+> **You**: Disable
+> 
+> **BotFather**: Success! The new status is: DISABLED. /help
+
+
+### 2. Add your config 
+
+Here is an example gateway bridging `Discord`<>`Telegram`
+
+```toml
+# / 
+# SERVERS
+# / 
+[telegram]
+    [telegram.mytelegram]
+        Token="token" 
+        RemoteNickFormat="<{NICK}> " # How your message will be bridged. 
+        MessageFormat="HTMLNick :"
+        QuoteFormat="{MESSAGE} (re @{QUOTENICK}: {QUOTEMESSAGE})"
+        QuoteLengthLimit=46 # Truncuate long quotes to prevent spammy bridged messages
+        IgnoreMessages="^/" # Don't bridge bot commands (as the responses will not be bridged)
+
+# / 
+# GATEWAYS
+# / 
+[[gateway]]
+name="YourUniqueGateWayName"
+enable=true
+
+    [[gateway.inout]]
+    account="telegram.mytelegram"
+    channel="-100xxx"
+
+    [[gateway.inout]]
+    account="discord.mydiscord"
+    channel="channel-name" 
+```
+
+The easiest way to retrieve your channel id is to navigate to https://web.telegram.org/ and simply copy the numbers at the end of the hyperlink into the `xxx` position in the example snippet above. 
+
+
+To add more nodes to this bridge, you simply need to add additional `[[gateway.inout]]` fields.
+
+Make sure to test your config with the `-debug` flag after each change. 
\ No newline at end of file