Brand new "/webhook" command.

Author: itorgov

.gitignore

@@ -7,6 +7,7 @@
 .env
 .env.backup
 .phpunit.result.cache
+.DS_Store
 Homestead.json
 Homestead.yaml
 npm-debug.log

README.md

@@ -71,6 +71,10 @@ If you want you can delete added token from the bot by using this command.
 
 This command creates a new menu for managing servers.
 
+### /webhook
+
+If you don't want to provide your API token for managing your Laravel Forge account but want to receive deployment notifications the use this command.
+
 ### /showchatid
 
 Use this command to get an ID of any chat.

app/Integrations/Telegram/Commands/Irazasyed/WebhookCommand.php

@@ -0,0 +1,93 @@
+<?php
+
+namespace App\Integrations\Telegram\Commands\Irazasyed;
+
+use Illuminate\Support\Facades\Cache;
+use Illuminate\Support\Facades\Storage;
+use Telegram\Bot\Exceptions\CouldNotUploadInputFile;
+use Telegram\Bot\FileUpload\InputFile;
+use Telegram\Bot\Objects\Message as MessageObject;
+
+class WebhookCommand extends Command
+{
+    private const IMAGE_CACHE_KEY = 'images-ids:deployment-webhooks-section.png';
+
+    /**
+     * @var string Command name.
+     */
+    protected $name = 'webhook';
+
+    /**
+     * @var string Command description.
+     */
+    protected $description = 'This command returns a webhook URL for receiving deployment notifications without providing an API token.';
+
+    /**
+     * Handle the command.
+     *
+     * @return void
+     */
+    public function handle()
+    {
+        $this->replyWithMessage([
+            'text' => "It's the webhook URL for this chat:\n*{$this->user()->forgeWebhookUrl()}*",
+            'parse_mode' => 'Markdown',
+        ]);
+
+        if (Cache::has(self::IMAGE_CACHE_KEY)) {
+            $this->sendImageUsingFileId();
+        } else {
+            $this->sendImageUsingFile();
+        }
+    }
+
+    /**
+     * Sends a screenshot of Forge's "Deployment Webhooks" section using file ID.
+     * If Telegram will return an error then it will try to send the screenshot using file.
+     *
+     * @return void
+     */
+    private function sendImageUsingFileId(): void
+    {
+        try {
+            $this->sendImage(Cache::get(self::IMAGE_CACHE_KEY));
+        } catch (CouldNotUploadInputFile $exception) {
+            report($exception);
+            $this->sendImageUsingFile();
+        }
+    }
+
+    /**
+     * Sends a screenshot of Forge's "Deployment Webhooks" section using file.
+     * Saves the file ID for using it in the future.
+     *
+     * @return void
+     */
+    private function sendImageUsingFile(): void
+    {
+        $image = InputFile::create(Storage::disk()->path('telegram/deployment-webhooks-section.png'));
+        $response = $this->sendImage($image);
+
+        Cache::forever(
+            self::IMAGE_CACHE_KEY,
+            collect($response->photo)
+                ->pluck('file_id', 'width')
+                ->sortKeysDesc()
+                ->first()
+        );
+    }
+
+    /**
+     * Sends image.
+     *
+     * @param InputFile|string $image
+     * @return MessageObject
+     */
+    private function sendImage($image): MessageObject
+    {
+        return $this->replyWithPhoto([
+            'photo' => $image,
+            'caption' => "Copy that URL and paste it to this section in your Laravel Forge site details.",
+        ]);
+    }
+}

app/Integrations/Telegram/Dialogs/AddTokenDialog.php

@@ -93,7 +93,9 @@ private function askForToken(): void
             $text = 'Let\'s add your first Laravel Forge API token. '.
                 'Go to the [API](https://forge.laravel.com/user/profile#/api) section in your '.
                 'Laravel Forge account settings and generate a new token. '.
-                'Then just send it to me.';
+                "Then just send it to me.\nIf you don't want to provide your token ".
+                'and don\'t want to manage your Laravel Forge account using this bot, '.
+                'but you want to receive deployment notifications then just use the /webhook command.';
         } else {
             $text = 'Send me your Laravel Forge API token.';
         }

app/Integrations/Telegram/IrazasyedTelegramBot.php

@@ -10,6 +10,7 @@
 use App\Integrations\Telegram\Commands\Irazasyed\MenuCommand;
 use App\Integrations\Telegram\Commands\Irazasyed\ShowChatIdCommand;
 use App\Integrations\Telegram\Commands\Irazasyed\StartCommand;
+use App\Integrations\Telegram\Commands\Irazasyed\WebhookCommand;
 use App\Integrations\Telegram\Entities\BotCommand;
 use App\Integrations\Telegram\Entities\CallbackQueryAnswer;
 use App\Integrations\Telegram\Entities\ChatAction;
@@ -55,6 +56,7 @@ public function __construct(string $botApiKey)
                 AddTokenCommand::class,
                 DeleteTokenCommand::class,
                 MenuCommand::class,
+                WebhookCommand::class,
             ]);
 
             if (config('services.telegram.bot.donate_command')) {

storage/app/.gitignore

@@ -1,3 +1,4 @@
 *
 !public/
+!telegram/
 !.gitignore