Okay, let's set up this Telegram bot. We'll use the `telegram-bot-sdk` library for easier interaction with the Telegram API. 1. **Create Project Structure:** bash mkdir telegram-group-scorer cd telegram-group-scorer composer require irazasyed/telegram-bot-sdk touch config.php webhook.php setWebhook.php scores.json mkdir src touch src/ScoreStorage.php 2. **Define Files:** { "name": "codephp/telegram-group-scorer", "description": "A Telegram bot to score groups based on message ID upon joining.", "type": "project", "require": { "php": "^8.1", "irazasyed/telegram-bot-sdk": "^3.9" }, "autoload": { "psr-4": { "App\\": "src/" } }, "authors": [ { "name": "CodePHP", "role": "Developer" } ] } filePath = $filePath; $this->loadScores(); } private function loadScores(): void { if (!file_exists($this->filePath)) { // Attempt to create the file if it doesn't exist if (file_put_contents($this->filePath, json_encode([])) === false) { error_log("Failed to create score file: " . $this->filePath); // Handle error appropriately, maybe throw an exception throw new Exception("Could not create score file: " . $this->filePath); } $this->scores = []; return; } $content = file_get_contents($this->filePath); if ($content === false) { error_log("Failed to read score file: " . $this->filePath); // Handle error throw new Exception("Could not read score file: " . $this->filePath); } $decoded = json_decode($content, true); if (json_last_error() !== JSON_ERROR_NONE) { error_log("Failed to decode score file JSON: " . json_last_error_msg()); // Handle error, maybe backup the corrupt file and start fresh $this->scores = []; // Start with empty scores if file is corrupt return; } $this->scores = is_array($decoded) ? $decoded : []; } private function saveScores(): bool { $json = json_encode($this->scores, JSON_PRETTY_PRINT); if ($json === false) { error_log("Failed to encode scores to JSON: " . json_last_error_msg()); return false; } if (file_put_contents($this->filePath, $json) === false) { error_log("Failed to write scores to file: " . $this->filePath); return false; } return true; } public function hasScore(int|string $chatId): bool { return isset($this->scores[(string)$chatId]); } public function getScore(int|string $chatId): ?int { return $this->scores[(string)$chatId] ?? null; } public function setScore(int|string $chatId, int $score): bool { if ($this->hasScore($chatId)) { // Score already exists, do not overwrite for this bot's logic return false; } $this->scores[(string)$chatId] = $score; return $this->saveScores(); } } getWebhookUpdate(); // Process only message updates if ($update->getMessage()) { $message = $update->getMessage(); $chat = $message->getChat(); $chatId = $chat->getId(); $messageId = $message->getMessageId(); // ID of the current message // Check if the bot was added to the chat $newMembers = $message->getNewChatMembers(); if (!empty($newMembers)) { $botInfo = $telegram->getMe(); $botId = $botInfo->getId(); foreach ($newMembers as $member) { if ($member->getId() === $botId) { // The bot was just added! if (!$storage->hasScore($chatId)) { // Use the message ID of the "join" event as the score $score = $messageId; if ($storage->setScore($chatId, $score)) { // Optionally notify the group $groupName = $chat->getTitle() ?? ('Group ' . $chatId); $telegram->sendMessage([ 'chat_id' => $chatId, 'text' => "Hello! 👋 This group has been assigned a score based on its join event: " . $score . ". This is a one-time action.", ]); error_log("Scored group {$groupName} ({$chatId}) with score: {$score}"); } else { error_log("Failed to save score for chat {$chatId}."); } } else { // Bot was added, but group already has a score (maybe re-added?) error_log("Bot re-added to chat {$chatId}, score already exists."); // Optionally send a message saying it's already scored $existingScore = $storage->getScore($chatId); $telegram->sendMessage([ 'chat_id' => $chatId, 'text' => "Welcome back! This group was already scored: " . $existingScore, ]); } // Exit loop once bot is found break; } } } // --- Add other command/message handling logic here if needed --- /* elseif ($message->has('text')) { $text = $message->getText(); if ($text === '/getscore') { if ($storage->hasScore($chatId)) { $score = $storage->getScore($chatId); $telegram->sendMessage(['chat_id' => $chatId, 'text' => 'Current score for this group: ' . $score]); } else { $telegram->sendMessage(['chat_id' => $chatId, 'text' => 'This group has not been scored yet.']); } } } */ } // end if ($update->getMessage()) } catch (\Telegram\Bot\Exceptions\TelegramSDKException $e) { // Log Telegram SDK specific errors error_log("Telegram SDK Exception: " . $e->getMessage()); // Consider more detailed logging or error handling } catch (\Throwable $e) { // Catch any other errors error_log("General Error: " . $e->getMessage() . " in " . $e->getFile() . " on line " . $e->getLine()); } // Respond to Telegram quickly to avoid timeouts, even if nothing was done // Sending an empty 200 OK is usually sufficient http_response_code(200); echo json_encode(['status' => 'ok']); // Optional response body TELEGRAM_WEBHOOK_URL]; // --- If using secret token, add it here --- /* if (isset($secretToken)) { $params['secret_token'] = $secretToken; echo "Setting webhook with secret token...\n"; } */ // --- $response = $telegram->setWebhook($params); if ($response) { echo "Webhook set successfully to: " . TELEGRAM_WEBHOOK_URL . "\n"; // Fetch webhook info to confirm $webhookInfo = $telegram->getWebhookInfo(); echo "Current webhook info:\n"; print_r($webhookInfo->toArray()); } else { echo "Failed to set webhook.\n"; } } catch (\Telegram\Bot\Exceptions\TelegramSDKException $e) { echo "Error setting webhook: " . $e->getMessage() . "\n"; } catch (\Throwable $e) { echo "General Error: " . $e->getMessage() . "\n"; } {} /vendor/ /scores.json config.php 3. **Configuration:** * Edit `config.php` and replace `'YOUR_BOT_TOKEN'` with the token you got from BotFather. * Replace `'https://yourdomain.com/path/to/webhook.php'` with the actual, publicly accessible HTTPS URL where you will host the `webhook.php` file. **It must be HTTPS.** 4. **Deployment:** * Upload all these files (except potentially `setWebhook.php` after running it) to your web server. Ensure the web server user has write permissions for the `scores.json` file. * Make sure your web server is configured to handle PHP files. 5. **Set the Webhook:** * Run the `setWebhook.php` script *once*. You can do this via SSH (`php setWebhook.php`) or by accessing it temporarily through your browser (ensure the URL in `config.php` is correct first). This tells Telegram where to send updates for your bot. 6. **Add Bot to Group:** * Add your bot to a Telegram group. * When the bot joins, it should trigger the `webhook.php` script. The script will detect the bot joining, record the `message_id` of the join notification in `scores.json` (keyed by the group's `chat_id`), and send a confirmation message to the group. It will only do this the first time it's added to that specific group. This setup uses the `message_id` of the "Bot was added" event as the score. This ID increments globally across Telegram, so it acts as a rough proxy for when the group became active enough to add the bot, relative to other events on Telegram.