Azioni

Differenze tra le versioni di "MontellugTelegramBot"

Da MontelLUG WIKI.
 
(5 versioni intermedie di 2 utenti non mostrate)
Riga 8: Riga 8:
 
* ''orari'' , visualizza i prossimi appuntamenti in sede
 
* ''orari'' , visualizza i prossimi appuntamenti in sede
 
* ''tessera'' , spiega qual è la procedura per iscriversi
 
* ''tessera'' , spiega qual è la procedura per iscriversi
 +
 +
Il sistema memorizza solo le richieste che non riesce a capire, per il tempo minimo necessario, al fine di poter migliorare il software.
  
 
== Come posso usarlo ==
 
== Come posso usarlo ==
−
Se hai uno smartphone, devi installare Telegram e poi aprire una chat con l'utente MontellugBot.
+
Se hai uno smartphone, devi installare Telegram e poi aprire una chat con l'utente @MontellugBot.
  
 
== Come funziona? ==
 
== Come funziona? ==
Riga 26: Riga 28:
 
* collegare il vostro bot alla vostra pagina php (modificate i parametri necessari):
 
* collegare il vostro bot alla vostra pagina php (modificate i parametri necessari):
 
https://api.telegram.org/bot01234567:tanticarattericasuali/setWebhook?url=https://vostro_server.it/nome_segreto.php
 
https://api.telegram.org/bot01234567:tanticarattericasuali/setWebhook?url=https://vostro_server.it/nome_segreto.php
 +
 +
== Controllare il BOT da Bash ==
 +
 +
Inviare messaggi di testo: script send_telegram_message.sh
 +
<pre>
 +
<nowiki>
 +
#!/bin/sh
 +
# TELEGRAM_BOT_API_TOKEN="9703794947:ABGqfiE_prpXfyvkwFzqfpzr7KtXVbtJcP"
 +
# CHAT_ID="-942536909"
 +
 +
/usr/bin/curl -s -X POST \
 +
https://api.telegram.org/bot$TELEGRAM_BOT_API_TOKEN/sendMessage \
 +
-d chat_id="$CHAT_ID" -d text="Messaggio dal BOT: $1 $2 $3 $4" > /dev/null
 +
</nowiki>
 +
</pre>
 +
 +
 +
Inviare foto: script send_telegram_photo.sh
 +
<pre>
 +
<nowiki>
 +
#!/bin/sh
 +
# TELEGRAM_BOT_API_TOKEN="9703794947:ABGqfiE_prpXfyvkwFzqfpzr7KtXVbtJcP"
 +
# CHAT_ID="-942536909"
 +
 +
/usr/bin/curl -s -X \
 +
POST https://api.telegram.org/bot$TELEGRAM_BOT_API_TOKEN/sendPhoto \
 +
-F chat_id="$CHAT_ID" -F photo=@"$1" \
 +
-F caption="Invio foto: $2" > /dev/null
 +
</nowiki>
 +
</pre>
 +
 +
 +
Inviare file: script send_telegram_document.sh
 +
<pre>
 +
<nowiki>
 +
#!/bin/sh
 +
# TELEGRAM_BOT_API_TOKEN="9703794947:ABGqfiE_prpXfyvkwFzqfpzr7KtXVbtJcP"
 +
# CHAT_ID="-942536909"
 +
 +
/usr/bin/curl -s -X \
 +
POST https://api.telegram.org/bot$TELEGRAM_BOT_API_TOKEN/sendDocument \
 +
-F chat_id="$CHAT_ID" -F document=@"$1" \
 +
-F caption="Invio file: $2" > /dev/null
 +
</nowiki>
 +
</pre>

Versione attuale delle 21:56, 9 mag 2023

Cosa è e cosa fa

Un "bot telegram" è una sorta di utente virtuale con il quale si può chattare tramite il client Telegram. A rispondere non sarà una persona ma un software e l'interazione che si può avere dipende dallo sviluppatore che ha creato il bot (il nostro è semplicissimo). Al momento le funzioni disponibili sono:

  • distro , consiglia qualche distribuzione per neofiti
  • iban , visualizza le coordinate bancarie per poter pagare la tessera o per le donazioni :-)
  • logo , visualizza il logo del MontelLug
  • sw <software_proprietario>, consente di trovare le alternative libere ai software proprietari, es. 'sw office' > LibreOffice
  • orari , visualizza i prossimi appuntamenti in sede
  • tessera , spiega qual è la procedura per iscriversi

Il sistema memorizza solo le richieste che non riesce a capire, per il tempo minimo necessario, al fine di poter migliorare il software.

Come posso usarlo

Se hai uno smartphone, devi installare Telegram e poi aprire una chat con l'utente @MontellugBot.

Come funziona?

Per fare un bot si possono usare diversi linguaggi di programmazione. Per semplicità e portabilità abbiamo scelto php. Per non partire da zero abbiamo scelto di usare la classe di Gabriele Grillo disponibile a questo indirizzo:

https://github.com/Eleirbag89/TelegramBotPHP

In sostanza bisogna seguire questi semplici passaggi:

  • installare Telegram
  • avviare una chat con il bot "BotFather"
  • tramite BotFather creare il bot <vostro_nome>
  • BotFather vi darà un codice di accesso alle API del tipo 01234567:tanticarattericasuali
  • in un vostro server accessibile via https, copiare il file telegram.php e creare un file <nome_segreto>.php che risponderà alle richieste effettive degli utenti
  • collegare il vostro bot alla vostra pagina php (modificate i parametri necessari):

https://api.telegram.org/bot01234567:tanticarattericasuali/setWebhook?url=https://vostro_server.it/nome_segreto.php

Controllare il BOT da Bash

Inviare messaggi di testo: script send_telegram_message.sh 


#!/bin/sh
# TELEGRAM_BOT_API_TOKEN="9703794947:ABGqfiE_prpXfyvkwFzqfpzr7KtXVbtJcP"
# CHAT_ID="-942536909"

/usr/bin/curl -s -X POST \
https://api.telegram.org/bot$TELEGRAM_BOT_API_TOKEN/sendMessage \
-d chat_id="$CHAT_ID" -d text="Messaggio dal BOT: $1 $2 $3 $4" > /dev/null


Inviare foto: script send_telegram_photo.sh 


#!/bin/sh
# TELEGRAM_BOT_API_TOKEN="9703794947:ABGqfiE_prpXfyvkwFzqfpzr7KtXVbtJcP"
# CHAT_ID="-942536909"

/usr/bin/curl -s -X \
POST https://api.telegram.org/bot$TELEGRAM_BOT_API_TOKEN/sendPhoto \
-F chat_id="$CHAT_ID" -F photo=@"$1" \
-F caption="Invio foto: $2" > /dev/null


Inviare file: script send_telegram_document.sh 


#!/bin/sh
# TELEGRAM_BOT_API_TOKEN="9703794947:ABGqfiE_prpXfyvkwFzqfpzr7KtXVbtJcP"
# CHAT_ID="-942536909"

/usr/bin/curl -s -X \
POST https://api.telegram.org/bot$TELEGRAM_BOT_API_TOKEN/sendDocument \
-F chat_id="$CHAT_ID" -F document=@"$1" \
-F caption="Invio file: $2" > /dev/null
Estratto da "index.php?title=MontellugTelegramBot&oldid=24445"