Imparando il Piaccapi

2018-01-04 18:18:33 #method #forwardMessage
Usa questo metodo per inoltrare un messaggio di ogni genere in una chat.

function forwardMessage($chat_id, $from_chat_id, $message_id, $disable_notification=false){
global $api;
$fields=["chat_id"=>$chat_id, "from_chat_id"=>$from_chat_id, "message_id"=>$message_id, "disable_notification"=>$disable_notification];
$result=run("forwardMessage", $fields, false);
return $result;
}

Parametri
integer or string $chat_id: identificatore unico della chat o dell'utente a cui inviare il messaggio.
integer or string $from_chat_id: identificatore unico della chat originale in cui il messaggio fu inviato.
bool $disable_notification: se true gli utenti riceveranno il messaggio senza alcuna notifica. (Optional)
integer $message_id: id del messaggio da inoltrare.

Esempio

if($messaggio){
forwardMessage($chat_id, $chat_id, $message_id, false);
}

La risposta del bot sarà quella mostrata nella foto qui sotto. ‎ Aprire / Come

2018-01-04 18:09:42 Importante! Le funzioni che seguono utilizzano la funzione run() inviata nel primo post; senza di essa il codice non funzionerà!

#method #sendMessage
Usa questo metodo per inviare messaggi di testo.


$api="Bot token";
function sendMessage($chat_id, $text, $inline_keyboard, $reply_to_message_id=false, $parse_mode="html", $disable_web_page_preview=false, $disable_notification=false){
global $api;
$fields=["chat_id"=>$chat_id, "text"=>$text, "parse_mode"=>$parse_mode, "disable_web_page_preview"=>$disable_web_page_preview, "disable_notification"=>$disable_notification];
if($inline_keyboard) {
$reply_markup=["inline_keyboard"=>$inline_keyboard];
$fields['reply_markup']=json_encode($reply_markup);
}
if($reply_to_message_id) {
$fields['reply_to_message_id']=$reply_to_message_id;
}
$result=run("sendMessage", $fields, false);
return $result;
}

Parametri
integer or string $chat_id : identificatore unico della chat o dell'utente a cui inviare il messaggio.
string $text: testo del messaggio da inviare
array $inline_keyboard: tastiera inline allegata al messaggio (Optional).
Deve essere un array di array, come mostrato qui sotto

$inline_keyboard[]=[["text"=>"Ciao!", "callback_data"=>"1"]];

bool $disable_web_page_preview: disabilita o abilita l'anteprima dei link nel messaggio. (Optional)
bool $disable_notification: se true gli utenti riceveranno il messaggio senza alcuna notifica. (Optional)
$reply_to_message_id integer: id del messaggio a cui si vuole rispondere. (Optional)

Esempio

if($messaggio=="/start"){
$inline_keyboard[]=[["text"=>"Ciao!", "callback_data"=>1]];
sendMessage($idChat, "Ciao $nomeUtente!", $inline_keyboard);
}

La risposta del bot sarà quella mostrata nella foto qui sotto. ‎ Aprire / Come

2018-01-04 17:49:49 Rispondere ad un update
Per "rispondere" agli update telegram mette a disposizione delle API (Application Programming Interface) la cui documentazione è reperibile qui.

I post che seguiranno saranno dedicati alla descrizione dei methods e all'esemplificazione della maggior parte di loro. Aprire / Come

2018-01-04 17:47:06 Elaborazione dati e risposta
Per elaborare i dati è possibile utilizzare qualsiasi strumento il php mette a disposizione - o, addirittura, integrare altri linguaggi di programmazione.

if($message=="/start"){
$risposta="Ciao $nomeUtente! Come va?";
sendMessage($chatID, $risposta);
}

Tralasciando la funzione sendMessage, il codice qui sopra è un esempio di modo di elaborare i dati raccolti dall'update. Aprire / Come

2018-01-04 17:43:45 Ottenere gli updates
Ogni bot telegram si basa sull'ottenimento di updates e le risposte ad essi.
Gli update sono oggetti JSON che i server telegram inviano al link impostato tramite setWebhook - nel caso si utilizzasse getUpdates, l'operazione va eseguita manualmente e non è possibile utilizzare la procedura spiegata di seguito.
Per ottenere ed elaborare un update si utilizza, di norma, il seguente codice:

$content = file_get_contents("php://input");

$content conterrà, come detto prima, un oggetto JSON simile a questo:

{
"update_id": 143871881,
"message": {
"message_id": 35872,
"from": {
"id": 309657717,
"is_bot": false,
"first_name": "Alessandro",
"username": "AlFox02",
"language_code": "it"
},
"chat": {
"id": 309657717,
"first_name": "Alessandro",
"username": "AlFox02",
"type": "private"
},
"date": 1515076706,
"text": "/start",
"entities": [
{
"offset": 0,
"length": 6,
"type": "bot_command"
}
]
}
}

Per poterlo elaborare è necessario convertirlo in un array, utilizzando json_decode();

$content = file_get_contents("php://input");
$update = json_decode($content, true);

A questo punto siamo in grado di ricavare tutte le variabili necessarie allo step successivo: l'elaborazione dati e la risposta!

$messaggio=$update['message']['text'];
$nomeUtente=$update['message']['from']['first_name'];
$idUtente=$update['message']['from']['id'];
$idChat=$update['chat']['id']; Aprire / Come

2018-01-04 14:00:08 La funzione run()
Php mette a disposizioni le funzioni per eseguire la stessa azione più volte nel codice anche a distanza di codice.
Capito come definirle, è semplice creare delle funzioni dedicate ai methods telegram. Qui di seguito riporto una funzione che consiglio di utilizzare per inviare le richieste con metodo GET/POST ai server telegram.


function run($method, $fields, $GET=false){
global $api;
$a=($GET)?"GET":"POST";
$u=curl_init("https://api.telegram.org/bot$api/".$method);
curl_setopt($u,CURLOPT_LOW_SPEED_TIME, 10);
curl_setopt($u, CURLOPT_CUSTOMREQUEST, $a);
curl_setopt($u, CURLOPT_RETURNTRANSFER, true);
curl_setopt($u, CURLOPT_POSTFIELDS, $fields);
$result=curl_exec($u);
if(!$result){
return false;
} else {
return $result;
}
curl_close($u);
}

Parametri
string $method : il methodo telegram da utilizzare (sendMessage, editMessageText, answerInlineQuery...).
array $fields : un array dei parametri della query che verrà effettuata ai server telegram. (esempio: $fields=["chat_id"=>123456789, "text"=>urlencode("Hello World"), "parse_mode"=>"html"]; )
bool $GET : se true, la richiesta ai server verrà effettuata tramite metodo GET altrimenti POST. Di default è impostato su false.

$api rappresenta l'API key del vostro bot. Aprire / Come

2018-01-04 12:57:41 Anno nuovo, vita nuova?
Prima di iniziare a scrivere del futuro del canale, voglio stilare un breve resoconto della sua - seppur breve - vita.
Fondato il 26 giugno 2017, il canale si chiamava "Imparando il Piaccapi" e non "Piaccapi". Il suo obiettivo, che si è andato perdendendo, era quello di insegnare la programmazione in php a quella fetta di utenza telegram che voleva cimentarsi nella creazione di bot.
Certo, una causa nobile che ha riscosso un successo dopo l'altro. A metà luglio "Imparando il Piaccapi" possedeva già 300 iscritti (in meno di 30 giorni di attività). Qualcuno potrebbe obbiettare che altri canali hanno fatto molto meglio in meno tempo. Certo, ma dipende anche dal tipo di canale. Piaccapi non è per tutti.
E' arrivato poi settembre che assieme alla magia estiva si è portato via gran parte dell'attività. Io personalmente avrei continuato a pubblicare post, ma percepivo la scarsa presenza degli utenti, un'attività che piano piano si affievoliva.
A novembre l'ancor giovane "Imparando il Piaccapi" si trasformava in "Piaccapi" abbandonando definitivamente quell'obbiettivo che era stato la causa della sua nascita.
Noto che molti utenti stanno uscendo dal canale. Li capisco, avrei fatto anche io lo stesso. Ma, a volte, un pizzico di fiducia in più viene ricompensato.
Tramite questo messaggio vi prometto che "Piaccapi" tornerà ad essere "Imparando il Piacacpi". Lo scopo? Quello originario ma si presuppone una conoscenza base del php.
il canale diventerà una documentazione completa per esempi dei metodi Telegram. Non vi insegnerò a creare bot ma vi darò gli strumenti giusti per farlo.
Non consegnerò nemmeno #pappapronta, come piace definirla a molti. I codici che invierò non possono da soli costituire un bot telegram.
Detto ciò ringrazio chi, con cui ho avuto il piacere di parlare, mi ha fatto venire in mente questa idea.
Siete pronti per il grande ritorno?

Alessandro Aprire / Come

2018-01-01 02:17:31 Happy new year from @Piaccapi! Aprire / Come