システム管理者向けの電報ボット

システム管理者向けの電報ボット。 これは決して完成したプロジェクトではなく、取り組むべきものがあります。 これは、半完成製品であり、各管理者がさまざまなタスクを申請できる一連のテクニックです。









この記事には、いくつかのボットの例と、PowershellのAPIテレグラムを使用した例が含まれています。

既製の管理用テンプレート

ボットAPIの使用方法

1.メッセージを受信する

アドレスでInvoke-WebRequestを実行する必要があります

https://api.telegram.org/bot{}/getUpdates?offset={ ID }&timeout={     }
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

{Token} -BotFatherから受け取ったボットトークン

{ordinal message ID} -最初のメッセージ0の場合、最後の+ 1の後続の番号の場合 。 最後の番号を指定すると、呼び出しごとに最後のメッセージが届きます。

{秒単位で戻る前に待機する時間} -空の構造を返す前にテレグラムが応答を待機する時間。 ボットの遅延を作成するのに適しています。 デバッグを待たないように、ブートで1秒の遅延を使用しました。

出力は、 ConvertFrom-Jsonを使用して解析するJSON構造です



コードリスト＃1

 $ChatTimeout = 1 $UpdateId = 0 $token = "bot token" $URL = "https://api.telegram.org/bot$token/getUpdates?offset=$UpdateId&timeout=$ChatTimeout" $Request = Invoke-WebRequest -Uri $URL -Method Get $content = ConvertFrom-Json $Request.content #    2       $str = $content.result | select -First 1 $str = ($str).message $props = [ordered]@{ ok = $content.ok UpdateId = ($str).update_id Message_ID = $str.message_id first_name = ($str.from).first_name last_name = ($str.from).last_name chat_id = ($str.chat).id text = $str.text } $obj = New-Object -TypeName PSObject -Property $props $obj
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

$ objオブジェクトの出力はメッセージであり、メッセージの送信元です

2.ファイルをダウンロードする

ファイルが転送されると、追加のパラメーターがJSON構造で転送されます 。 ファイルを取得するには、メッセージからfile_idをプルする必要があります。次に、アドレスに移動します。

 https://api.telegram.org/bot{token}/getFile?file_id={file_id  }
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

リクエストは、ダウンロードパスを含むJSON構造を返します。 次に、リンクからファイルをダウンロードします

 https://api.telegram.org/file/bot{token}/{file_path}
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

ファイルが与えられたと仮定すると、それをダウンロードするためのコードは次のようになります。

 $ChatTimeout = 1 $UpdateId = 0 $token = "bot token" $Path = "c:\" #####     $URL = "https://api.telegram.org/bot$token/getUpdates?offset=$UpdateId&timeout=$ChatTimeout" $Request = Invoke-WebRequest -Uri $URL -Method Get $content = ConvertFrom-Json $Request.content #    2       $str = $content.result | select -First 1 $str = ($str).message #####          #          if ( $($str.document).mime_type -eq "image/jpeg" ) { $isJPG = $true } #####   file_name      #    ? if ( $($str.document).file_name -ne $null ) { ###      $DocFileName = ($str.document).file_name $DocFileID = ($str.document).file_id $DocFileSize = ($str.document).file_size #        /getFile $URL = "https://api.telegram.org/bot$token/getFile?file_id=$DocFileID" $RequestFile = Invoke-WebRequest -Uri $URL ###  $RequestFile        foreach ( $JSON in $((ConvertFrom-Json $RequestFile.Content).result) ) { $FilePath = $json.file_path $URL = "https://api.telegram.org/file/bot$token/$FilePath" $FilePath = Split-Path -Leaf $FilePath $OutputFile = "$Path\$FilePath" #    Invoke-WebRequest -Uri $URL -OutFile $OutputFile } }
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

3.何かを書く

テレグラムボットは、2つのマークダウンモードとHTMLテキストマークアップモードをサポートしています。



注： HTMLモードでは、 brタグはサポートされていません





行シーケンス％0Aを使用して行を折り返す



メッセージ送信の例

 $token = " " $hatid = "ID      " $text = " habr" $payload = @{ "parse_mode" = "Markdown"; "disable_web_page_preview" = "True" } $URL = "https://api.telegram.org/bot$token/sendMessage?chat_id=$hatid&text=$text" $request = Invoke-WebRequest -Uri $URL -Method Post ` -ContentType "application/json; charset=utf-8" ` -Body (ConvertTo-Json -Compress -InputObject $payload)
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

たとえば、次のような行を送信するときにこのコードでエラーが発生した場合：

 "$FDownload : file name is ""$($JSON.file_path)""; size $($json.file_size) kb"
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

より複雑な送信方法を使用できます。

 $token = " " $chat_id = "ID chata" $text = "" $markdown = $true $preview_mode = "True" if ($markdown) { $markdown_mode = "Markdown" } else {$markdown_mode = ""} $payload = @{ "chat_id" = $chat_id; "text" = $text "parse_mode" = $markdown_mode; "disable_web_page_preview" = $preview_mode; } $URL = "https://api.telegram.org/bot$token/sendMessaget" $request = Invoke-WebRequest -Uri $URL ` -Method Post -ContentType "application/json; charset=utf-8" ` -Body (ConvertTo-Json -Compress -InputObject $payload)
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

誰もがファイルをアップロードする方法を知っている場合-破棄、追加します。