🚀 release: v1.0.0-beta.3

.env.railway

@@ -0,0 +1,13 @@
+PLATFORM_REDIS_URL="${{"Redis (Platform)".REDIS_URL}}" # Auto-configured Redis for bot data storage
+POSTGRES_PASSWORD="${{"Postgres (Platform)".POSTGRES_PASSWORD}}" # Auto-configured database password
+POSTGRES_USER="${{"Postgres (Platform)".POSTGRES_USER}}" # Auto-configured database username
+POSTGRES_URL="${{"Postgres (Platform)".DATABASE_URL}}" # Auto-configured PostgreSQL connection URL
+NODE_ENV="production" # Environment mode (keep as production for Railway)
+WEBHOOK_POLL_INTERVAL="1000" # How often to check for agent replies (milliseconds)
+DATABASE_SSL_VALIDATE="true" # Enable secure database connections (recommended)
+TELEGRAM_BOT_TOKEN="" # Get from @BotFather on Telegram - REQUIRED
+UNTHREAD_API_KEY="" # Get from Unthread dashboard API settings - REQUIRED
+UNTHREAD_SLACK_CHANNEL_ID="" # Target Slack channel ID from Unthread - REQUIRED
+UNTHREAD_WEBHOOK_SECRET="" # Webhook secret from Unthread dashboard - REQUIRED
+WEBHOOK_REDIS_URL="" # Redis URL for webhook processing (optional for basic bot)
+COMPANY_NAME="" # Your company name (optional - used in ticket formatting)

.gitignore

@@ -3,9 +3,10 @@
 # =============================================================================
 
 # ======= Environment & Configuration =======
-# Ignore all .env files except the example template
+# Ignore all .env files except templates
 .env*
 !.env.example
+!.env.railway
 
 # ======= Build Output & Dependencies =======
 # Node.js

README.md

@@ -77,7 +77,11 @@ The **Official Unthread Telegram Bot** creates a seamless bridge between your cu
 
 3. **Deploy Instantly**
 
-   **Option A: Docker (Recommended)**
+   **Option A: Railway (One-Click Deploy)**
+
+   [![deploy on railway](https://railway.com/button.svg)](https://railway.com/deploy/unthread-telegram-bo?referralCode=dTwT-i)
+
+   **Option B: Docker (Recommended)**
 
    ```bash
    # Clone and setup
@@ -90,7 +94,7 @@ The **Official Unthread Telegram Bot** creates a seamless bridge between your cu
    docker compose up -d
    ```
 
-   **Option B: Manual Installation**
+   **Option C: Manual Installation**
 
    ```bash
    # Clone and setup
@@ -109,6 +113,15 @@ The **Official Unthread Telegram Bot** creates a seamless bridge between your cu
    - Send `/start` to see if it responds
    - Try creating a ticket with `/support`
 
+## 🚂 One-Click Deploy
+
+Deploy instantly to Railway with a single click:
+
+[![deploy on railway](https://railway.com/button.svg)](https://railway.com/deploy/unthread-telegram-bo?referralCode=dTwT-i)
+
+> [!TIP]
+> Deploying using Railway directly supports this project's ongoing development and maintenance! 🚀
+
 ### **📋 Required Configuration**
 
 Edit your `.env` file with these required values:
@@ -240,7 +253,7 @@ There are several ways you can support this project:
 
 - [Become a sponsor](https://github.com/sponsors/wgtechlabs) and get some perks! 💖
 - [Buy me a coffee](https://buymeacoffee.com/wgtechlabs) if you just love what I do! ☕
-- Deploy using the [Railway Template](https://railway.com/template/nVHIjj?referralCode=dTwT-i) which directly supports the ongoing development! 🛠️
+- Deploy using the [Railway Template](https://railway.com/deploy/unthread-telegram-bo?referralCode=dTwT-i) which directly supports the ongoing development! 🛠️
 
 ## ⭐ GitHub Star Nomination
 

package.json

@@ -1,6 +1,6 @@
 {
   "name": "unthread-telegram-bot",
-  "version": "1.0.0-beta.2",
+  "version": "1.0.0-beta.3",
   "description": "Turn private Telegram groups into real-time support ticket hubs — powered by Unthread.io.",
   "keywords": [
     "telegram",

src/config/env.ts

@@ -8,7 +8,7 @@
  * - TELEGRAM_BOT_TOKEN: Telegram Bot API authentication token
  * - UNTHREAD_API_KEY: Unthread platform API key for ticket creation
  * - UNTHREAD_SLACK_CHANNEL_ID: Target Slack channel for ticket routing
- * - UNTHREAD_WEBHOOK_SECRET: Secret for webhook signature verification
+ * - UNTHREAD_WEBHOOK_SECRET: Secret for webhook signature verification (required for full integration)
  * - PLATFORM_REDIS_URL: Redis connection for bot state management
  * - WEBHOOK_REDIS_URL: Redis connection for webhook event processing
  * - POSTGRES_URL: PostgreSQL database connection for persistent storage