cv4pve-botgram

ProxmoxVE Api

     ______                _                      __
    / ____/___  __________(_)___ _   _____  _____/ /_
   / /   / __ \/ ___/ ___/ / __ \ | / / _ \/ ___/ __/
  / /___/ /_/ / /  (__  ) / / / / |/ /  __(__  ) /_
  \____/\____/_/  /____/_/_/ /_/|___/\___/____/\__/


  Telegram bot for Proxmox VE                    (Made in Italy)

  cv4pve-botgram is a part of suite cv4pve.
  For more information visit https://www.corsinvest.it/cv4pve

Usage:
  cv4pve-botgram [options]

Options:
  --api-token <api-token>     Api token format 'USER@REALM!TOKENID=UUID'. Require Proxmox VE 6.2 or later
  --username <username>       User name <username>@<realm>
  --password <password>       The password. Specify 'file:path_file' to store password in file.
  --validate-certificate      Validate SSL Certificate Proxmox VE node.
  --host <host> (REQUIRED)    The host name host[:port],host1[:port],host2[:port]
  --token <token> (REQUIRED)  Telegram API token bot
  --chatsId <chatsId>         Telegram Chats Id valid for communication (comma separated)
  --version                   Show version information
  -?, -h, --help              Show help and usage information

Copyright and License

Copyright: Corsinvest Srl For licensing details please visit LICENSE.md

Commercial Support

This software is part of a suite of tools called cv4pve-tools. If you want commercial support, visit the site

Introduction

Telegram for Proxmox VE.

this software aims to simplify the management of Proxmox VE single node or cluster using. The reasons are:

• do not use graphical interface (GUI)
• access to simplified operations
• using Telegram application
• access using chat mobile
• Support multiple host for HA in --host parameter es. host[:port],host1[:port],host2[:port]
• Check-Update and Upgrade application

Main features

• Completely written in C#
• Use native api REST Proxmox VE (library C#)
• Independent os (Windows, Linux, Macosx)
• Installation unzip file extract binary
• Not require installation in Proxmox VE
• Execute out side Proxmox VE
• Call Api Get,Set,Create,Delete
• Alias command
• Documentation generated at runtime from server
• Complex output to document in chat
• Valid ChatsId for communication
• Use Api token --api-token parameter
• Validate certificate SSL, default not validate

Api token

From version 6.2 of Proxmox VE is possible to use Api token. This feature permit execute Api without using user and password. If using Privilege Separation when create api token remember specify in permission.

Set up your bot in Telegram

You don’t need to write any code for this. In fact, you don’t even need your computer! Go to the telegram app on your phone and…

• Search for the “botfather” telegram bot (he’s the one that’ll assist you with creating and managing your bot)

• Type /help to see all possible commands the botfather can handle

• Click on or type /newbot to create a new bot.

Follow instructions and make a new name for your bot. If you are making a bot just for experimentation, it can be useful to namespace your bot by placing your name before it in its username, since it has to be a unique name. Although, its screen name can be whatever you like. I have chosen “Frank Test PVE Bot” as the screen name and “frank_test_pve_bot” as its username.

• Congratulations! You have created your first bot. You should see a new API token generated for it (for example, in the previous picture, you can see my newly generated token is 707587383:AAHD9DVwXrBxz8wyOl0DWLdbzl8skkffhRo). Now you can search for your newly created bot on telegram :

Configuration

E.g. install on linux 64

Download last package e.g. Debian cv4pve-botgram-linux-x64.zip, on your os and install:

root@debian:~# unzip cv4pve-botgram-linux-x64.zip

This tool need basically no configuration.

root@debian:~# cv4pve-botgram --host=192.168.0.100 --username=root@pam --password=fagiano --token 707587383:AAHD9DVwXrBxz8wyOl0DWLdbzl8skkffhRo

Use

In telegram open chat and execute /help command. Web Chat Telegram