Dobar dan.
Postoji mnogo članaka o Telegram botovima, ali malo ko piše o veštinama za Alisu, a informacija o tome kako napraviti jedinstvenog bota nisam mogao da pronađem, pa sam odlučio da podelim svoje iskustvo o tome kako napraviti jednostavnog Telegram bota i veštinu Yandex.Alice za sajt koji ima jedinstvenu funkcionalnost.
Dakle, kako podići veb-server i dobiti ssl sertifikat neću pričati, o tome je dovoljno napisano.
Kreiranje Telegram bota
Prvo ćemo napraviti Telegram bota, za to idemo u Telegram i tražimo bota BotFather.


Biramo /newbot

Unosimo naziv bota po kojem će se javljati, zatim unosimo ime bota, u odgovoru dobijamo token za upravljanje botom, beležimo ovu šifru, biće nam potrebna kasnije.

Sledeći korak je obavestiti Telegram servere na koji server slati podatke od bota. Za to pravimo link u obliku:
https://api.telegram.org/bot___TOKEN___/setWebhook?url=https://____PUT_DO_SCRIPT-a___
___TOKEN___ zamenjujemo našim tokenom od bota, dobijenim ranije
____PUT_DO_SCRIPT-a___ zamenjujemo adresom skripte na našem serveru, gde će se vršiti obrada podataka (na primer, www.moj_server.ru/webhook_telegram.php).
Tu je problem, server api.telegram.org je pod blokadom, ali može se učiniti ovako: iznajmiti najjeftiniji server server gde nema ograničenja i dati iz konzole tog servera komandu
wget ___DOBIJENA_ADRESA___
Sve, Telegram bot je napravljen i povezan sa vašim serveru.
Kreiranje veštine za Yandex.Alicu
Prelazimo na kreiranje veštine za Yandex.Alicu.
Za izradu veštine potrebno je otići na stranicu za programere Yandex.Dijalozi stranicu za programere Yandex.Dijalozi, kliknuti na "Kreirati dijalog" i odabrati "Veština u Alisi".

Otvorit će se dijalog za podešavanje veštine.

Počinjemo unositi podešavanja veštine.
Unosimo ime vaše veštine.

Aktivacijsko ime treba pažljivo birati kako bi Alisa pravilno razumela, od sitnica – mobilna aplikacija sa Alisom i uređaji poput Yandex.Stanice ili Irbis A mogu različito razumeti reči.
Unosimo put do skripte na našem serveru na sličan način kao za Telegram, ali to će biti skripta isključivo za Alisu, na primer www.moj_server.ru/webhook_alice.php.

Biramo glas kojim će veština govoriti, meni se više dopada glas Alise.

Ako se planira rad samo na mobilnim uređajima ili u pretraživaču, biramo „Potrebno je uređaj sa ekranom“.
Zatim unosimo podešavanja za katalog veština Alise. Ako planirate da koristite reč za aktivaciju — brend, potrebno je da verifikujete vebsajt brenda na servisu webmaster.yandex.ru.

Sa podešavanjima smo završili, prelazimo na skripte.
Skripta Telegram-bota
Počnimo sa skriptom za Telegram.
Povezujemo biblioteku koja će obrađivati poruke od bota i Alise:
include_once 'webhook_parse.php';
Postavljamo token našeg bota:
$tg_bot_token = "_____YOUR_BOT_TOKEN_____";
Dobijamo podatke:
$request = file_get_contents('php://input');
$request = json_decode($request, TRUE);
Razlažemo podatke na promenljive:
if (!$request)
{
die();
// Neka greška (zahtev nije validan JSON)
}
else if (!isset($request['update_id']) || !isset($request['message']))
{
die();
// Neka greška (zahtev nema poruku)
}
else
{
$user_id = $request['message']['from']['id'];
$msg_user_name = $request['message']['from']['first_name'];
$msg_user_last_name = $request['message']['from']['last_name'];
$msg_user_nick_name = $request['message']['from']['username'];
$msg_chat_id = $request['message']['chat']['id'];
$msg_text = $request['message']['text'];
$msg_text = mb_strtolower($msg_text, 'UTF-8');
$tokens = explode(" ", $msg_text);
}
Sada možemo raditi sa promenljivama:
$tokens — ovde su sve reči koje je korisnik unio
$user_id — ovde je id korisnika
$msg_chat_id — chat u kojem je bot primio komandu
$msg_user_name — ime korisnika
Zatim, pozivamo funkciju Parse_Tokens za obradu:
$Out_Str = Parse_Tokens($tokens);
I šaljemo odgovor:
Send_Out($user_id, $Out_Str);
Funkcija Send_Out je jednostavna i izgleda ovako:
function Send_Out($user_id, $text, $is_end = true)
{
global $tg_bot_token;
if (strlen($user_id) < 1 || strlen($text) < 1) {return;}
$json = file_get_contents('https://api.telegram.org/bot' . $tg_bot_token . '/sendMessage?chat_id=' . $user_id . '&text=' . $text);
}
Skripta veštine za Yandex.Alice
Sada prelazimo na skriptu za Alisu, ona je gotovo identična onoj za Telegram.
Takođe povezujemo biblioteku koja će obrađivati poruke od bota i Alise, plus biblioteku sa klasama za Alisu:
include_once 'classes_alice.php';
include_once 'webhook_parse.php';
Dobijamo podatke:
$data = json_decode(trim(file_get_contents('php://input')), true);
Razlažemo podatke na promenljive:
ako (isset($data['request']))
{
//original_utterance
ako (isset($data['meta']))
{
$data_meta = $data['meta'];
ako (isset($data_meta['client_id'])) {$client_id = $data_meta['client_id'];}
}
ako (isset($data['request']))
{
$data_req = $data['request'];
ako (isset($data_req['original_utterance']))
{
$original_utterance = $data_req['original_utterance'];
}
ako (isset($data_req['command'])) {$data_msg = $data_req['command'];}
ako (isset($data_req['nlu']))
{
$data_nlu = $data_req['nlu'];
ako (isset($data_nlu['tokens'])) {$tokens = $data_nlu['tokens'];}
// $data_token_count = count($data_tokens);
}
}
ako (isset($data['session']))
{
$data_session = $data['session'];
ako (isset($data_session['new'])) {$data_msg_new = $data_session['new'];}
ako (isset($data_session['message_id'])) {$data_msg_id = $data_session['message_id'];}
ako (isset($data_session['session_id'])) {$data_msg_sess_id = $data_session['session_id'];}
ako (isset($data_session['skill_id'])) {$skill_id = $data_session['skill_id'];}
ako (isset($data_session['user_id'])) {$user_id = $data_session['user_id'];}
}
}
Ovdje je manje potrebnih varijabli:
$tokens — ovde su sve reči koje je korisnik unio
$user_id — ovde je id korisnika
Yandex konstantno pinguje objavljene vještine, pa sam dodao liniju da odmah izađem iz skripte, ne pokrećući punu obradu poruke:
ako (strpos($tokens[0], "ping") > -1) {Send_Out("pong", "", true);}
Pozivamo funkciju Parse_Tokens za obradu, ona je ista kao za Telegram:
$Out_Str = Parse_Tokens($tokens);
I šaljemo odgovor:
Send_Out($user_id, $Out_Str);
Funkcija Send_Out ovdje je malo složenija:
function Send_Out($user_id, $out_text, $out_tts = "", $is_end = false)
{
global $data_msg_sess_id, $user_id;
//////////// GENERATE BASE OF OUT ////////////
$Data_Out = new Alice_Data_Out();
$Data_Out->response = new Alice_Response();
$Data_Out->session = new Alice_Session();
//////////// GENERATE BASE OF OUT End ////////////
//////////// OUT MSG GENERATE ////////////
$Data_Out->session->session_id = $data_msg_sess_id;;
$Data_Out->session->user_id = $user_id;
$Data_Out->response->text = $out_text;
$Data_Out->response->tts = $out_tts;
ako (strlen($out_tts) response->tts = $out_text;}
$Data_Out->response->end_session = $is_end;
header('Content-Type: application/json');
print(json_encode($Data_Out, JSON_HEX_TAG | JSON_HEX_AMP | JSON_HEX_APOS | JSON_HEX_QUOT));
die();
}
Završili smo skriptu za Alisu.
Samu skriptu za obradu Parse_Tokens sam napravio isključivo za primjer, vi možete raditi bilo kakve provjere i obrade u njoj.
function Parse_Tokens($tokens)
{
$out = "";
// uradi nešto s tokenima //
$out = "Vaš unos " . count($tokens) . " riječi: " . implode($tokens, " ");
return $out;
}
Ako vam je potrebna komunikacija s korisnikom složenijeg tipa od pitanja i odgovora, potrebno je sačuvati u bazi (npr. mysql) $user_id korisnika i već primljene podatke od korisnika i analizirati ih u funkciji Parse_Tokens.
To je zapravo gotovo sve, ako je sve urađeno ispravno, Telegram bot je već dostupan, Alisovu vještinu možete provjeriti dialogs.yandex.ru/developer, prelazeći u svoju novu vještinu na karticu testiranje.

Ako sve ispravno radi, možete poslati vještinu na moderaciju, klikajući na dugme "Na moderaciju".
Sada imate dva bota za različite platforme koja rade na isti način.
Dokumentacija za uslugu Yandex.Dialogs ovde
Potpuni skripti su objavljeni na github-u preuzeti.
Izvor: habr.com
