v1.0.0

Author: jaycee0610

README.md

@@ -1,2 +1,123 @@
-# Basic Telegram Sender PHP
- Telegram Group Message Sender
+# 🚀 Basic Telegram Sender PHP
+
+A simple PHP script to send messages to a Telegram group using a bot. 🤖
+
+## 📥 Installation
+
+1. **Clone the Repository:**
+   ```sh
+   git clone https://github.com/jaycee0610/Basic-Telegram-Sender-PHP.git
+   cd Basic-Telegram-Sender-PHP
+   ```
+
+2. **Install Dependencies:**
+   ```sh
+   composer require rootscratch/telegram
+   ```
+
+## 🛠️ Setup Guide
+
+### 📌 Step 1: Create a Telegram Bot
+- Open Telegram and search for `@BotFather`. 🤖
+- Start a chat with `@BotFather` and create a new bot.
+- Once created, you will receive a **bot token**. Save this token for later use. 🔑
+
+### 📌 Step 2: Create a Group and Add the Bot
+- Create a new Telegram group.
+- Add your bot to the group.
+- Send any message in the group to initialize it. 🆕
+
+### 📌 Step 3: Get the List of Updates
+To retrieve the updates for your bot, use the following API request:
+```
+https://api.telegram.org/bot<YourBOTToken>/getUpdates
+```
+**Example:**
+```
+https://api.telegram.org/bot123456789:jbd78sadvbdy63d37gda37bd8/getUpdates
+```
+
+### 📌 Step 4: Find the Chat ID
+Look for the "chat" object in the API response:
+```json
+{
+    "update_id": 8393,
+    "message": {
+        "message_id": 3,
+        "from": {
+            "id": 7474,
+            "first_name": "AAA"
+        },
+        "chat": {
+            "id": -<group_ID>,
+            "title": "<Group name>"
+        },
+        "date": 25497,
+        "new_chat_participant": {
+            "id": 71, 
+            "first_name": "NAME",
+            "username": "YOUR_BOT_NAME"
+        }
+    }
+}
+```
+- The `id` inside the "chat" object is your **Group Chat ID** and always starts with `-`. 🆔
+- Use this ID when sending messages to the group. 📩
+
+**Note:**
+If you created a new group and the API response only returns:
+```json
+{"ok": true, "result": []}
+```
+Try removing and re-adding the bot to the group. 🔄
+
+## 🚀 Usage
+
+1. **Modify `index.php`:**
+   ```php
+   require_once 'vendor/autoload.php';
+
+   use Rootscratch\Telegram\Send;
+
+   Send::telegram_token('your-bot-token-here');
+   Send::telegram_chat_id('-your-chat-id-here');
+   $message = 'Hello, Telegram!';
+
+   try {
+       $send = Send::SendGroup($message);
+       echo json_encode($send);
+   } catch (\Exception $e) {
+       echo json_encode(['error' => $e->getMessage()]);
+   }
+   ```
+
+2. **Run the script:**
+   ```sh
+   php index.php
+   ```
+
+## 📡 API Response Example
+```json
+{
+    "ok": true,
+    "result": {
+        "message_id": 123,
+        "chat": {
+            "id": -1001234567890,
+            "title": "My Telegram Group"
+        },
+        "text": "Hello, Telegram!"
+    }
+}
+```
+
+## ⚠️ Troubleshooting
+- If you get `{"ok":true,"result":[]}` when retrieving updates, try removing and re-adding the bot to the group. 🔄
+- Make sure the bot has permission to send messages in the group. ✅
+
+## 📜 License
+This project is licensed under the MIT License. 📝
+
+## 👨‍💻 Author
+[John Natividad](https://github.com/jaycee0610) ✨
+

composer.json

@@ -0,0 +1,18 @@
+{
+    "name": "rootscratch/telegram",
+    "description": "Telegram Group Message Sender PHP",
+    "type": "library",
+    "license": "MIT",
+    "autoload": {
+        "psr-4": {
+            "Rootscratch\\Telegram\\": "src/"
+        }
+    },
+    "authors": [
+        {
+            "name": "John Christian Natividad",
+            "email": "jaycee@rootscratch.com"
+        }
+    ],
+    "require": {}
+}

example.php

@@ -0,0 +1,17 @@
+<?php
+
+require_once 'vendor/autoload.php';
+
+use Rootscratch\Telegram\Send;
+
+Send::telegram_token('token');
+Send::telegram_chat_id('chat_id');
+$message = 'message';
+
+
+try {
+    $send = Send::SendGroup($message);
+    echo json_encode($send);
+} catch (\Exception $e) {
+    echo json_encode(['error' => $e->getMessage()]);
+}

src/Send.php

@@ -0,0 +1,57 @@
+<?php
+
+namespace Rootscratch\Telegram;
+
+class Send
+{
+
+    private static $token;
+    private static $chat_id;
+
+    public static function telegram_token($token)
+    {
+        self::$token = $token;
+    }
+
+    public static function telegram_chat_id($chat_id)
+    {
+        self::$chat_id = $chat_id;
+    }
+
+    public static function SendGroup($message)
+    {
+        if (empty(self::$token) || empty(self::$chat_id)) {
+            throw new \Exception('Token and User ID must be set before sending a message.');
+        }
+
+        $request_params = [
+            'chat_id' => self::$chat_id,
+            'text' => $message
+        ];
+
+        $request_url = 'https://api.telegram.org/bot' . self::$token . '/sendMessage?' . http_build_query($request_params);
+        $context = stream_context_create(['http' => ['ignore_errors' => true]]);
+        $data = file_get_contents($request_url, false, $context);
+
+        $responseHeaders = $http_response_header;
+        $responseCode = null;
+        if (isset($responseHeaders[0])) {
+            preg_match('{HTTP\/\S*\s(\d{3})}', $responseHeaders[0], $match);
+            $responseCode = $match[1];
+        }
+
+        if ($responseCode == 404) {
+            throw new \Exception('HTTP request failed! HTTP/1.1 404 Not Found');
+        }
+
+        if ($data === false) {
+            throw new \Exception('Failed to get contents from URL');
+        }
+
+        $decodedData = json_decode($data, true);
+        if (json_last_error() !== JSON_ERROR_NONE) {
+            throw new \Exception('JSON decode error: ' . json_last_error_msg());
+        }
+        return $decodedData;
+    }
+}

vendor/autoload.php

@@ -0,0 +1,25 @@
+<?php
+
+// autoload.php @generated by Composer
+
+if (PHP_VERSION_ID < 50600) {
+    if (!headers_sent()) {
+        header('HTTP/1.1 500 Internal Server Error');
+    }
+    $err = 'Composer 2.3.0 dropped support for autoloading on PHP <5.6 and you are running '.PHP_VERSION.', please upgrade PHP or use Composer 2.2 LTS via "composer self-update --2.2". Aborting.'.PHP_EOL;
+    if (!ini_get('display_errors')) {
+        if (PHP_SAPI === 'cli' || PHP_SAPI === 'phpdbg') {
+            fwrite(STDERR, $err);
+        } elseif (!headers_sent()) {
+            echo $err;
+        }
+    }
+    trigger_error(
+        $err,
+        E_USER_ERROR
+    );
+}
+
+require_once __DIR__ . '/composer/autoload_real.php';
+
+return ComposerAutoloaderInitabead489068f30226339bea3ef0f174a::getLoader();