Яндекс.Алиса и Telegram бот на PHP с единен функционал

Добър ден.

Има много статии относно Telegram-ботовете, но малко се пише за уменията на Алиса, а информация за това как да се направи единен бот изобщо не намерих, затова реших да споделя опита си за това как да създадете прост Telegram-бот и умение за Яндекс.Алиса за сайт, който има единна функционалност.

И така, как да настроим уеб сървър и да получим ssl-сертификат няма да говоря, по този въпрос е написано достатъчно.

Създаване на Telegram-бот

Първо ще създадем Telegram-бот, за целта отиваме в Telegram и намираме бота BotFather.

Избираем /newbot

Въвеждаме името на бота, по който той ще отговаря, после въвеждаме името на бота, в отговор получаваме токен за управление на бота, запомняме този ключ, той ни е необходим по-късно.

Следващата стъпка е да уведомим сървърите на Telegram, на кой сървър да изпраща данните от бота. За целта правим линк от вида:

https://api.telegram.org/bot___ТОКЕН___/setWebhook?url=https://____ПУТЬ_ДО_СКРПИТА___

___ТОКЕН___ заменяме с нашия токен от бота, получен по-рано

____ПУТЬ_ДО_СКРПИТА___ заменяме с адреса на скрипта на нашия сървър, където ще се извършва обработка на данните (например, www.my_server.ru/webhook_telegram.php).

Тук има проблем, сървърът api.telegram.org е под блокировка, но може да го направите така: наемете най-евтиния сървър там, където няма ограничения и дайте от конзолата на този сървър командата

wget ___ПОЛУЧИВШИ_АДРЕС___

Всичко, Telegram-ботът е създаден и свързан с вашия сървър.

Създаване на умение за Яндекс.Алиса

Да преминем към създаването на умение за Яндекс.Алиса.

За да създадете умение, трябва да отидете на страницата на разработчиците на Яндекс.Диалози страницата на разработчиците на Яндекс.Диалози, там натиснете „Създайте диалог“ и изберете „Умение в Алиса“.

Ще се отвори диалог за настройки на умението.

Започваме да въвеждаме настройките на умението.

Въвеждаме името на вашето умение.

Активираното име трябва да се подбира много внимателно, за да може Алиса да го разбира правилно, от нюансите - мобилното приложение с Алисата и колонките от типа Яндекс.Станция или Irbis A могат да възприемат думите различно.

Въвеждаме пътя до скрипта на нашия сървър също така, както за Telegram, но това ще бъде скрипт именно за Алиса, например www.my_server.ru/webhook_alice.php.

Избираме гласа, с който ще говори умението, на мен ми харесва именно гласът на Алиса.

Ако се предвижда работа само на мобилни устройства или в браузър, избираме „Нужно устройство с екран“.

Следва да въведем настройките за каталога на уменията на Алисa. Ако планирате да използвате за активиране думата — бранд, трябва да преминете верификация на сайта на бранда в сервиза webmaster.yandex.ru.

С настройките всичко е наред, преминаваме към скриптовете.

Скрипт за Telegram-бота

Нека започнем със скрипта за Telegram.

Свързваме библиотеката, където ще се обработват съобщенията от бота и Алисa:

include_once 'webhook_parse.php';

Задаваме токена на нашия бот:

$tg_bot_token = "_____YOUR_BOT_TOKEN_____";

Получаваме данните:

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

Разделяме данните на променливи:

if (!$request)
{
  die();
    // Някаква грешка (заявката не е валиден JSON)
}
else if (!isset($request['update_id']) || !isset($request['message']))
{
  die();
    // Някаква грешка (заявката няма съобщение)
}
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);
}

Сега можем да работим с променливите:

$tokens — тук сега са всички думи, които потребителят е въвел

$user_id — тук е id на потребителя

$msg_chat_id — чатът, в който ботът е получил командата

$msg_user_name — име на потребителя

След това извикваме функцията за обработка Parse_Tokens:

$Out_Str = Parse_Tokens($tokens);

И изпращаме отговор:

Send_Out($user_id, $Out_Str);

функцията Send_Out е проста и изглежда така:

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

Скрипт за умението на Яндекс.Алисa

Сега преминаваме към скрипта за Алисa, той е почти същият като за Telegram.

Също така свързваме библиотеката, където ще се обработват съобщенията от бота и Алисa, плюс библиотеката с класовете за Алисa:

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

Получаваме данните:

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

Разделяме данните на променливи:

ако (isset($data['request']))
{

//original_utterance


  ако (isset($data['meta']))
  {
    $data_meta = $data['meta'];
    ако (isset($data_meta['client_id'])) {$client_id = $data_meta['client_id'];}
  }

  ако (isset($data['request']))
  {
    $data_req = $data['request'];

    ако (isset($data_req['original_utterance']))
    {
      $original_utterance = $data_req['original_utterance'];
    }


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

Тук необходимите променливи са малко по-малко:

$tokens — тук сега са всички думи, които потребителят е въвел

$user_id — тук е id на потребителя

Яндекс постоянно пингва публикуваните умения, и добавих ред, за да излизам веднага от скрипта, без да стартирам пълната обработка на съобщението:

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

Извикваме функцията Parse_Tokens за обработка, той е същият, както за Telegram:

$Out_Str = Parse_Tokens($tokens);

И изпращаме отговор:

Send_Out($user_id, $Out_Str);

Функцията Send_Out тук е малко по-сложна:

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

  //////////// ГЕНЕРИРАЙ БАЗА ЗА ИЗХОД ////////////
    $Data_Out = new Alice_Data_Out();
    $Data_Out->response = new Alice_Response();
    $Data_Out->session = new Alice_Session();
  //////////// ГЕНЕРИРАЙ БАЗА ЗА ИЗХОД КРАЙ ////////////

  //////////// ИЗХОДНО СЪОБЩЕНИЕ ГЕНЕРАЦИЯ ////////////
  $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;

  ако (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();
}

Приключихме скрипта за Алиса.

Самият скрипт за обработка Parse_Tokens е направен чисто за пример, вие ще можете да направите там всякакви проверки и обработки.

function Parse_Tokens($tokens)
{
  $out = "";
  // направи нещо с токените //\n  $out =  "Вашите ентерираните " . count($tokens) . " думи: " . implode($tokens, " ");
  return $out;
}

Ако ви е нужно общуването с потребителя да бъде по-сложно от въпрос-отговор, ще трябва да се запази в база (например mysql) $user_id на потребителя и получените от него данни и да се анализират в функцията Parse_Tokens.

Собствено това е почти всичко, ако всичко е направено правилно, ботът в Telegram вече е достъпен, умението на Алиса може да се провери dialogs.yandex.ru/developer, като преминете към новото си умение на раздела за тестване.

Ако всичко работи правилно, можете да изпратите умението за модерация, като натиснете бутона "На модерация".

Сега имате два бота за различни платформи, които работят по един и същи начин.

Документация за услугата Яндекс.Диалози тук

Пълните скриптове са публикувани в github да се изтегли.

Източник: habr.com