You can now create tickets on osTicket directly from Telegram!
You will need pip to install the script requirements. The safer way to get your requirements installed without affecting any other Python project you have is using virtualenv
Use the package manager pip to install the requirements.
git clone https://github.com/saulo-m/telegramticketos.git
cd telegramticketos
virtualenv .venv
source activate .venv/bin/activate
pip install -r requirements.txt
Edit the .env file, located at the project root directory, using your settings, then run this script.
example:
TELEGRAM_APIKEY=121231313:AAaabbbb123 #Telegram API Key. Message @botfather on telegram to get one.
CLIENTS_FILE=users.csv # Semicolon delimited CSV file containing the osTicket Users and their respective e-mail addresses (format: name;email)
TICKETOS_URL=http://example.domain.com/api/tickets.json #URL to osTicket API
MACHINE_IP=172.16.0.1 #IP address of the machine running this script
API_KEY=123BB12313013 #osTicket Api Key - This key should be generated in osTicket and assigned to the same IP address set in MACHINE_IP
To create a new ticket, send a message in the following format:
/newticket Name, Ticket Subject, Issue.
You can also edit a /newticket message and the bot will redo the search using the new parameters.
If your osTicket is integrated with an Active Directory server, you may use the following command in PowerShell to export Active Directory Users to a suitable file.
get-aduser –filter * -property * | Select-object Name, mail | Export-Csv users.csv -Delimiter ";" -NoTypeInformation
IMPORTANT: You can't create tickets for users that don't exist in your osTicket installation, even if you have it integrated with an Active Directory server. You need first to confirm those AD users using the web interface, then you may create tickets directly from Telegram.
Active directory integration.
Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.