unni

unni is a Telegram Bot that gives info about events from isamuni

unni is the Sicilian word for where. That is one of the main questions people ask about events: where is it? unni, however, provides more information about events than just where that happen.

unni will serve the events data from isamuni.

commands

This is the list of commands supported by unni

• /help
• /today
• /future

We would love to have other commands, such as /topic or /city, in the future.

Running the Bot Locally

This bot is using the python-telegram-bot library.

The first step to run the bot is to install the required dependencies. You can do this via pip

$ pip install python-telegram-bot --upgrade

Then call the @BotFather within Telegram and use the /newbot command to create a new bot.

Then create a configuration file called unni.cfg that follows this template:

[source]
name = isamuni
url = http://isamuni.it/events.json

[telegram]
token = 2ThisIsGoingToBeAVeryLongTokenFromBotFatherXY

[log]
dir = logs
name = unni_bot.log

[commands]
start = start
help = aiuto, help, h
future = futuri, future
today = oggi, today
subscribe = subscribe, sub
unsubscribe = unsubscribe, unsub

[messages]
welcome = Ciao {user_name}! Io sono {bot_name}
    Usa il comando: /{help_cmd} per maggiori info su come posso aiutarti
help = Unni ti aiuterà a trovare gli eventi tech in Sicilia.
    I comandi disponibili sono:
    - /{today_cmd}
    - /{future_cmd}
    - /{sub_cmd}
    - /{unsub_cmd}
    Unni usa isamuni.it come fonte di dati
failure = Mi dispiace, ma non ho trovato eventi
today = Gli eventi di oggi sono:
future = I prossimi eventi sono:
subscribe = Grazie per esserti iscritto a unni. 
    Verrai notificato ogni {frequency} ore sugli eventi del giorno
subscribe_header = Ciao {user_name}! Se non desideri più ricevere queste notifiche,digita /{unsub_cmd}
subscribe_fail = Sei già registrato a unni
unsubscribe = Unni non ti invierà piú notifiche
unsubscribe_fail = Non ti sei mai registrato per le notifiche di unni

[subscribe]
frequency = 86400

Then run:

$ python unni.py

Now you can call your bot on telegram and have fun!

Run unni via docker and docker-compose

docker

$ docker build -t unni .
$ docker run unni

docker-compose

$ docker-compose build
$ docker-compose up -d # will start container in background

Testing the deployed Bot

You can test it by adding the unni_bot to your Telegram

Info

This project is currently maintained by the PAC Community and it is under the MIT license. Feel free to use and modify it.