Yandex.Alice och Telegram-bot på PHP med enhetlig funktionalitet

God dag.

Det finns många artiklar om Telegram-botar, men få skriver om färdigheterna för Alice, och jag har inte hittat någon information om hur man gör en enhetlig bot, så jag ville dela med mig av min erfarenhet av hur man skapar en enkel Telegram-bot och en Yandex.Alice färdighet för en webbplats med en gemensam funktionalitet.

Så, hur man ställer upp en webbserver och får ssl-certifikat jag kommer inte att gå in på, det finns redan tillräckligt med information om detta.

Skapa en Telegram-bot

Först skapar vi en Telegram-bot, för detta går vi till Telegram och hittar boten BotFather.

Välj /newbot

Ange namnet på boten som den kommer att svara på, och sedan skriver vi in botens användarnamn, i svar får vi en token för att hantera boten, vi antecknar denna nyckel, den kommer att vara användbar senare.

Nästa steg är att informera Telegram-servrarna om vilken server de ska skicka data från boten till. För detta skapar vi en länk av typen:

https://api.telegram.org/bot___TOKEN___/setWebhook?url=https://____SCRIPTSJÄNG___

___TOKEN___ ersätter vi med vår token från boten, som vi fick tidigare.

____SCRIPTSJÄNG___ ersätter vi med adressen till skriptet på vår server, där databehandling kommer att ske (till exempel www.my_server.ru/webhook_telegram.php).

Det här är ett problem, servern api.telegram.org är blockerad, men man kan göra så här: hyra den billigaste server där det inte finns några begränsningar och ge kommandot från konsolen på den servern

wget ___ADRESS___

Klart, Telegram-boten är skapad och kopplad till din servern.

Skapa en färdighet för Yandex.Alice

Låt oss gå vidare till att skapa en färdighet för Yandex.Alice.

För att skapa en färdighet måste du gå till Yandex.Diagrammer utvecklarens sida. Utvecklarens sida för Yandex.Diagrammer, klicka där på "Skapa dialog" och välj "Färdighet i Alice".

Inställningsdialogen för färdigheten öppnas.

Vi börjar ange inställningarna för färdigheten.

Skriv in namnet på din färdighet.

Aktiveringsnamnet bör väljas mycket noggrant, så att Alice förstår det korrekt, med några nyanser — mobilappen med Alice och högtalare som Yandex.Station eller Irbis A kan uppfatta orden på olika sätt.

Ange sökvägen till skriptet på vår server på samma sätt som för Telegram, men detta kommer att vara skriptet specifikt för Alice, till exempel www.my_server.ru/webhook_alice.php.

Välj rösten som färdigheten ska tala med, jag gillar verkligen Alice rösten.

Om arbetet endast planeras att fungera på mobila enheter eller i webbläsare, välj då "Behöver en enhet med skärm".

Vi anger nu inställningarna för Alicias färdighetskatalog. Om du planerar att använda ett aktiveringsord — varumärket, behöver du verifiera varumärkets webbplats via tjänsten webmaster.yandex.ru.

Inställningarna är klara, vi går vidare till skripten.

Telegram-botskript

Låt oss börja med skriptet för Telegram.

Vi ansluter biblioteket som kommer att hantera meddelanden från boten och Alicia:

include_once 'webhook_parse.php';

Vi ställer in token för vår bot:

$tg_bot_token = "_____YOUR_BOT_TOKEN_____";

Vi hämtar data:

$request = file_get_contents('php://input');
$request = json_decode($request, TRUE);

Vi bryter ner datan i variabler:

if (!$request)
{
  die();
    // Något felmeddelande (request är inte giltig JSON)
}
else if (!isset($request['update_id']) || !isset($request['message']))
{
  die();
    // Något felmeddelande (request har inget meddelande)
}
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);
}

Nu kan vi arbeta med variablerna:

$tokens — här finns nu alla ord som användaren skrev

$user_id — här är användarens id

$msg_chat_id — chatten där boten fick kommandot

$msg_user_name — användarens namn

Därefter anropar vi funktionen Parse_Tokens för behandling:

$Out_Str = Parse_Tokens($tokens);

Och skickar svaret:

Send_Out($user_id, $Out_Str);

Funktionen Send_Out är enkel och ser ut så här:

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);
}

Skriptet för färdigheten till Yandex.Alice

Nu går vi vidare till skriptet för Alice, det är nästan detsamma som för Telegram.

Vi ansluter också biblioteket som kommer att hantera meddelanden från boten och Alicia, plus biblioteket med klasser för Alice:

include_once 'classes_alice.php';
include_once 'webhook_parse.php';

Vi hämtar data:

$data = json_decode(trim(file_get_contents('php://input')), true);

Vi bryter ner datan i variabler:

if (isset($data['request']))
{

//original_utterance


  if (isset($data['meta']))
  {
    $data_meta = $data['meta'];
    if (isset($data_meta['client_id'])) {$client_id = $data_meta['client_id'];}
  }

  if (isset($data['request']))
  {
    $data_req = $data['request'];

    if (isset($data_req['original_utterance']))
    {
      $original_utterance = $data_req['original_utterance'];
    }


    if (isset($data_req['command'])) {$data_msg = $data_req['command'];}
    if (isset($data_req['nlu']))
    {
      $data_nlu = $data_req['nlu'];
      if (isset($data_nlu['tokens'])) {$tokens = $data_nlu['tokens'];}
//      $data_token_count = count($data_tokens);
    }
  }
  if (isset($data['session']))
  {
    $data_session = $data['session'];
    if (isset($data_session['new'])) {$data_msg_new = $data_session['new'];}
    if (isset($data_session['message_id'])) {$data_msg_id = $data_session['message_id'];}
    if (isset($data_session['session_id'])) {$data_msg_sess_id = $data_session['session_id'];}
    if (isset($data_session['skill_id'])) {$skill_id = $data_session['skill_id'];}
    if (isset($data_session['user_id'])) {$user_id = $data_session['user_id'];}
  }
}

Här finns något färre nödvändiga variabler:

$tokens — här finns nu alla ord som användaren skrev

$user_id — här är användarens id

Yandex pingar ständigt publicerade färdigheter, och jag har lagt till en rad för att omedelbart avbryta skriptet utan att köra en fullständig meddelandehantering:

  if (strpos($tokens[0], "ping") > -1)     {Send_Out("pong", "", true);}

Vi kallar funktionen Parse_Tokens för bearbetning, den är densamma som för Telegram:

$Out_Str = Parse_Tokens($tokens);

Och skickar svaret:

Send_Out($user_id, $Out_Str);

Funktionen Send_Out här är lite mer komplex:

function Send_Out($user_id, $out_text, $out_tts = "", $is_end = false)
{
  global $data_msg_sess_id, $user_id;

  /////////// GENERERA BAS FÖR UTE ////////
    $Data_Out = new Alice_Data_Out();
    $Data_Out->response = new Alice_Response();
    $Data_Out->session = new Alice_Session();
  /////////// GENERERA BAS FÖR UTE Slut ////////

  /////////// UTE MSG GENERERA ////////
  $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;

  if (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();
}

Skriptet för Alice är klart.

Själva behandlingsskriptet Parse_Tokens är gjort som ett exempel, du kan göra vilka kontroller och bearbetningar som helst där.

function Parse_Tokens($tokens)
{
  $out = "";
  // gör något med tokens //
  $out =  "Du har angivit " . count($tokens) . " ord: " . implode($tokens, " ");
  return $out;
}

Om du behöver mer komplex kommunikation med användaren än fråga-svar, då måste du spara användarens $user_id i databasen (till exempel mysql) samt redan erhållna data från användaren och analysera dem i funktionen Parse_Tokens.

Det är nästan allt, om allt är gjort korrekt är Telegram-boten redan tillgänglig, färdigheten för Alice kan kontrolleras dialogs.yandex.ru/developer, genom att gå till din nya färdighet på fliken testning.

Om allt fungerar korrekt kan du skicka färdigheten för moderering genom att trycka på knappen "För moderering".

Nu har du två botar för olika plattformar som fungerar på samma sätt.

Dokumentation för tjänsten Yandex.Dialoger ). Ett typiskt exempel på användning:

Fullständiga skript ligger på github ladda ner.

Källa: habr.com