From eda0d479099bfeac6b5293b908518ed9b3b26808 Mon Sep 17 00:00:00 2001 From: Zerocool <35503951+TonyAntoun@users.noreply.github.com> Date: Fri, 7 Feb 2025 01:54:38 +0200 Subject: [PATCH 1/2] Create telegram.mdx Docs to add the telegram bot provider to Postiz --- pages/providers/telegram.mdx | 67 ++++++++++++++++++++++++++++++++++++ 1 file changed, 67 insertions(+) create mode 100644 pages/providers/telegram.mdx diff --git a/pages/providers/telegram.mdx b/pages/providers/telegram.mdx new file mode 100644 index 0000000..707d97e --- /dev/null +++ b/pages/providers/telegram.mdx @@ -0,0 +1,67 @@ +--- +title: Telegram +description: How to add Telegram to your system +--- + +import {Steps, Callout} from "nextra/components"; + + + +### Step 1 Create a Telegram Bot +1. Open Telegram and message [@BotFather](https://t.me/botfather). +2. Click Start +3. Click Menu + - click "Create a new bot" + - Enter a name for your bot (e.g., `MyPostizBot`). + +![Name Bot](https://github.com/user-attachments/assets/974c1ad3-4648-4d41-8d20-22b6e8cb0bc8) + - Choose a unique username ending with "bot" (e.g., `MyPostizBot_bot`). + +![Unique Bot Name](https://github.com/user-attachments/assets/e4824ed2-c812-4a03-b43a-bf4f680eff23) + +Once your bot is created, **BotFather** will give you an **API Token**. Keep it safe—you’ll need it later. + +![Bot Token](https://github.com/user-attachments/assets/71bdc32c-36d5-45cd-b0d8-08d5eefcaadc) + +### Step 2: Configure Bot Group Permissions (optional but recommended) +1. Click on "Menu" +2. Click on "Edit your bots" +3. Select your bot +4. Click on "Bot Settings" + +![Bot Settings](https://github.com/user-attachments/assets/908924ee-2567-4c13-bfeb-52f5684680a3) + +5. Click on "Group Privacy" + +![Group Privacy](https://github.com/user-attachments/assets/6a756212-7af3-437f-88fe-74ca5579666d) + +6. if "Privacy mode" is enabled, turn it off (it is enabled by default) + + +### Step 3: Add Your Bot to Telegram Groups or Channels +1. Navigate to your group/channel +2. Add your bot to your group/channel +3. The bot requires these permissions to work with Postiz: + - access to messages || so the bot can read messages sent in the group/channel + - Send Text Messages || so the bot can send messages + - Send Media || so the bot can send media + + +**INFO:** While not strictly required, making your bot an `admin` is **recommended**. It will give the bot all the permissions needed and make the setup easier and faster. + + +### Step 4: Add Bot Token to Your Application +In your `.env` file, add the **Telegram Bot Name** (Without the @) and the **Telegram Bot API Token** that you received from **BotFather** in Step 1: + +```env +TELEGRAM_BOT_NAME="MyPostizBot_bot" +TELEGRAM_TOKEN="MyPostizBot token" +``` + + +**INFO:** If you are using Docker Compose, include the `NTBA_FIX_350: 1` variable directly in your `docker-compose.yml`. +see [Node Telegram Bot API](https://github.com/yagop/node-telegram-bot-api/blob/master/doc/usage.md#file-options-metadata) for reference. + + +You should be able to connect your group/channel to Postiz now! + From 6ab3b37db9bf1fb36363de6bc439f1f0deb46beb Mon Sep 17 00:00:00 2001 From: Zerocool <35503951+TonyAntoun@users.noreply.github.com> Date: Fri, 7 Feb 2025 01:57:55 +0200 Subject: [PATCH 2/2] Update telegram.mdx --- pages/providers/telegram.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pages/providers/telegram.mdx b/pages/providers/telegram.mdx index 707d97e..2ace426 100644 --- a/pages/providers/telegram.mdx +++ b/pages/providers/telegram.mdx @@ -7,7 +7,7 @@ import {Steps, Callout} from "nextra/components"; -### Step 1 Create a Telegram Bot +### Step 1: Create a Telegram Bot 1. Open Telegram and message [@BotFather](https://t.me/botfather). 2. Click Start 3. Click Menu