Salve a tutti,
qualche tempo fa avevamo pubblicato una guida per creare un bot su Telegram in python (clicca qui se ancora non l'hai letta). Viste le potenzialità dei bot (noi ce ne siamo fatti svariati per diversi usi), pensavamo fosse carino fare una seconda parte aggiungendo delle funzionalità in più.
Nel primo articolo, avevamo già visto qualche riga di codice per mostrare il funzionamento e l'utilizzo del message loop e dell'handle con l'invio di messaggi e immagini da python verso il client.
Oggi invece vedremo come aggiungere i comandi e i pulsanti e attribuirgli una certa funzionalità e le ormai immancabili emoji.
Creiamo dunque un nuovo bot Telegram come abbiamo già visto in precedenza e facciamoci qualche test 🙂
Prima di procedere però aggiorniamo telepot (se già installato)
sudo pip install telepot --upgrade
oppure se si ha easy_install
easy_install --upgrade telepot
Comandi
I comandi sono delle richieste predefinite che facciamo al bot e hanno la particolarità di avere come primo carattere "/". Un esempio pratico è /newbot che ci è servito su BotFather per creare il nuovo bot.
Vediamo come aggiungerli. Entriamo nella conversazione di BotFather e diamo il comando /mybots. Appariranno tutti i bot che abbiamo creato. Selezioniamo il bot a cui vogliamo aggiungere comandi e poi Edit Bot e infine Edit Commands.
Creiamo due comandi
- /myip che restituirà l'IP pubblico del server su cui gira il nostro script in python
- /sendinfo che restituirà le informazioni dell'utente
Per fare ciò inviamo come risposta al bot
myip - Restituisce l'IP pubblico del server
sendinfo - Restituisce le informazioni utente
e riavviamo Telegram per rendere effettive le modifiche
NB: quando si aggiungono comandi in un secondo momento, quelli vecchi vanno comunque riscritti.
Ora che vediamo un po' di codice, ne approfitto per mostrarvi un metodo diverso di impostare il message loop, utile successivamente. Il codice è molto semplice ma ve l'ho commentato per chiarire eventuali dubbi.
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 |
import telepot from telepot.loop import MessageLoop from pprint import pprint import time import json from urllib2 import urlopen TOKEN="XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" #da sostituire def on_chat_message(msg): pprint(msg) #display del messaggio che manda l'utente content_type, chat_type, chat_id = telepot.glance(msg) #get dei parametri della conversazione e del tipo di messaggio command = msg['text'] #get del comando inviato if command == '/myip': my_ip = urlopen('http://ip.42.pl/raw').read() #get dell'IP bot.sendMessage(chat_id, my_ip) elif command == '/getinfo': info=json.dumps(bot.getUpdates(),sort_keys=True, indent=4) #get delle info e tramite json.dump formattiamo il messaggio bot.sendMessage(chat_id,info) bot = telepot.Bot(TOKEN) MessageLoop(bot, {'chat': on_chat_message}).run_as_thread(); # in caso di chat, esegui il metodo on_chat_message. Ci sono altre modalità che vedremo in futuro print('Listening ...') while 1: time.sleep(10) |
Pulsanti (inline Keyboard)
Quando abbiamo modificato i comandi, ci sono apparsi dei pulsanti che ci hanno permesso di selezionare il bot e poi altre impostazioni. Questo strumento prende il nome di inline Keyboard e adesso vediamo come sfruttarlo.
Creiamo due pulsanti per fare le stesse cose dei comandi del paragrafo precedente e un pulsante supplementare che ci restituisce l'ora con un messaggio a comparsa.
Il codice è organizzato in due metodi: on_chat_message che gestisce i messaggi che arrivano dall'utente compresa anche la creazione della keyboard e on_callback_query che permette invece di gestire le risposte dei pulsanti. Per impostare la callback, la aggiungiamo nel main loop in questo modo
|
1 |
MessageLoop(bot, {'chat': on_chat_message, 'callback_query': on_callback_query}).run_as_thread() |
Mostriamo brevemente la sintassi per generare la keyboard. L'oggetto per crearla si chiama InlineKeyboardMarkup e come parametro gli passiamo inline_keboard=['''Array di array di InlineKeyboardButton''']. Ogni InlineKeyboardButton ha un valore text che è la label che apparirà nel pulsante e callback_data che è il valore che utilizzeremo per capire, nella funzione on_callback_query, quale dei pulsanti è stato premuto.
|
1 2 3 4 5 |
keyboard = InlineKeyboardMarkup(inline_keyboard=[ [InlineKeyboardButton(text='IP', callback_data='ip'), InlineKeyboardButton(text='Info', callback_data='info')], [InlineKeyboardButton(text='Time', callback_data='time')], ]) |
È possibile naturalmente impostare il layout dei pulsanti della tastiera. Nel nostro caso avremo un layout di questo tipo
Quindi gli "array di primo livello" rappresentano le righe. Nel nostro esempio infatti si può vedere che abbiamo due righe: la prima con due pulsanti mentre la seconda con uno solo:
[
[InlineKeyboardButton(...),InlineKeyboardButton(...)],
[InlineKeyboardButton(...)]
]
Ecco il codice completo.
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 |
import telepot from telepot.loop import MessageLoop from telepot.namedtuple import InlineKeyboardMarkup, InlineKeyboardButton from pprint import pprint import time import datetime import json from urllib2 import urlopen TOKEN="XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" #da sostituire def on_chat_message(msg): content_type, chat_type, chat_id = telepot.glance(msg) keyboard = InlineKeyboardMarkup(inline_keyboard=[ [InlineKeyboardButton(text='IP', callback_data='ip'), InlineKeyboardButton(text='Info', callback_data='info')], [InlineKeyboardButton(text='Time', callback_data='time')], ]) bot.sendMessage(chat_id, 'Use inline keyboard', reply_markup=keyboard) def on_callback_query(msg): query_id, chat_id, query_data = telepot.glance(msg, flavor='callback_query') print('Callback Query:', query_id, chat_id, query_data) if query_data=='ip': my_ip = urlopen('http://ip.42.pl/raw').read() bot.sendMessage(chat_id, my_ip) elif query_data=='info': info=json.dumps(bot.getUpdates(),sort_keys=True, indent=4) bot.sendMessage(chat_id, info) elif query_data=='time': ts = time.time() bot.answerCallbackQuery(query_id, text=datetime.datetime.fromtimestamp(ts).strftime('%H:%M:%S')) #messaggio a comparsa bot = telepot.Bot(TOKEN) MessageLoop(bot, {'chat': on_chat_message, 'callback_query': on_callback_query}).run_as_thread() print('Listening ...') while 1: time.sleep(10) |
Inviando quindi un qualsiasi messaggio, otterremo in risposta la tastiera. Per esercizio potreste provare a creare due comandi che generano due diversi tipi di tastiera 😉
Emoji
Ultima cosina per aggiungere giusto un tocco in più 🙂
Aggiungiamo le emoji ai nostri pulsanti o ai nostri messaggi installiamo l'apposito pacchetto
sudo pip install emoji.
Per mettere l'emoji all'etichetta di un pulsante utilizziamo emoji.emojize. Ad esempio per aggiungere l'emoji dell'orologio al pulsante che ci da l'ora, dovremo sostituire all'apposito campo text dell'InlineKeyboardButton
emoji.emojize('Time :watch:', use_aliases=True)
Tutti gli alias sono reperibili a questo indirizzo
https://www.webpagefx.com/tools/emoji-cheat-sheet/
Al momento è tutto!
Se volete ulteriori info sull'API di Telegram vi consiglio di visitare la documentazione di telepot nonché fonte di questo articolo.
Per richieste e consigli, come sempre, non esitate a lasciarci un commento.
