एक एकल कार्यक्षमता के साथ PHP में Yandex.Alice और Telegram bot

शुभ दोपहर

टेलीग्राम बॉट्स के विषय पर बहुत सारे लेख हैं, लेकिन कुछ ने ऐलिस के लिए कौशल के बारे में लिखा है, और मुझे एक भी बॉट बनाने के बारे में कोई जानकारी नहीं मिली है, इसलिए मैंने अपने अनुभव को साझा करने का फैसला किया कि साइट के लिए एक साधारण टेलीग्राम बॉट और येलैक्स कैसे बनाया जाए। एक ही कार्यशील होना।

इसलिए, मैंने आपको यह नहीं बताया कि वेब सर्वर कैसे बढ़ाएँ और एक ssl प्रमाणपत्र प्राप्त करें, इसके बारे में पर्याप्त लिखा गया है।

टेलीग्राम बॉट बनाना

सबसे पहले, एक टेलीग्राम बॉट बनाएं, इसके लिए टेलीग्राम पर जाएं और वहां बोटफादर बॉट का पता लगाएं।





न्यूबॉट चुनें



हम बॉट का नाम दर्ज करते हैं, जिसके द्वारा यह प्रतिक्रिया करेगा, फिर हम बॉट का नाम दर्ज करते हैं, जवाब में हमें बॉट को नियंत्रित करने के लिए एक टोकन मिलता है, इस कुंजी को लिखें, यह भविष्य में हमारे लिए उपयोगी होगा।



अगला कदम टेलीग्राम सर्वरों को यह बताना है कि किस सर्वर को बॉट से डेटा भेजना है। ऐसा करने के लिए, फॉर्म का लिंक बनाएं:

https: //api.telegram.org/bot______/setWebhook?url=https://_________ 

___ TOKEN ___ पहले से प्राप्त हमारे बॉट टोकन से बदल दें

____ PATH_DO_SCRIPT ___ को हमारे सर्वर पर स्क्रिप्ट के पते से बदल दिया जाता है जहां डेटा संसाधित किया जाएगा (उदाहरण के लिए, www.my_server.ru/webhook_telegram.php )।

एक समस्या है, api.telegram.org सर्वर लॉक है, लेकिन आप ऐसा कर सकते हैं: सबसे सस्ता सर्वर किराए पर लें जहां कोई प्रतिबंध नहीं है और इस सर्वर के कंसोल से कमांड दें

 wget _______ 

यह वही है, टेलीग्राम बॉट आपके सर्वर से बना और जुड़ा हुआ है।

Yandex.Alice के लिए एक कौशल बनाना

आइए Yandex.Alice के लिए कौशल बनाने के लिए आगे बढ़ें।

एक कौशल बनाने के लिए, आपको Yandex.Dialogs डेवलपर्स पृष्ठ, Yandex.Dialogs डेवलपर्स पृष्ठ पर जाने की आवश्यकता है, "संवाद बनाएं" पर क्लिक करें और "ऐलिस में कौशल" चुनें।



कौशल सेटिंग्स संवाद खुलता है।



हम कौशल सेटिंग्स में प्रवेश करना शुरू करते हैं।

अपने कौशल का नाम दर्ज करें।



सक्रियण नाम को बहुत सावधानी से चुना जाना चाहिए ताकि ऐलिस इसे बारीकियों से सही ढंग से समझ सके - ऐलिस के साथ एक मोबाइल एप्लिकेशन और Yandex.Station या Irbis A जैसे कॉलम अलग-अलग तरीकों से शब्दों को देख सकते हैं।

हम अपने सर्वर पर उसी तरह से स्क्रिप्ट पर पथ दर्ज करते हैं जैसे कि टेलीग्राम के लिए, लेकिन यह विशेष रूप से ऐलिस के लिए एक स्क्रिप्ट होगी, उदाहरण के लिए www.my_server.ru/webhook_alice.php ।



हम वह आवाज चुनते हैं जो कौशल बोलेगा, मैं ऐलिस की आवाज पसंद करता हूं।



यदि आप केवल मोबाइल उपकरणों या ब्राउज़र पर काम करने की योजना बनाते हैं, तो "स्क्रीन के साथ डिवाइस की आवश्यकता है" चुनें।

अगला, ऐलिस कौशल सूची के लिए सेटिंग्स दर्ज करें। यदि आप सक्रियण के लिए ब्रांड शब्द का उपयोग करने की योजना बनाते हैं, तो आपको webmaster.yandex.ru सेवा में ब्रांड वेबसाइट के सत्यापन से गुजरना होगा।



सेटिंग्स के साथ, स्क्रिप्ट पर जाएं।

टेलीग्राम बॉट लिपि

टेलीग्राम के लिए स्क्रिप्ट के साथ शुरू करते हैं।

हम उस लाइब्रेरी को कनेक्ट करते हैं जहां बॉट और ऐलिस के संदेशों को संसाधित किया जाएगा:

 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(); // Some Error output (request is not valid JSON) } else if (!isset($request['update_id']) || !isset($request['message'])) { die(); // Some Error output (request has not message) } 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); } 

अब आप चर के साथ काम कर सकते हैं:

$ टोकन - अब उपयोगकर्ता द्वारा यहां दर्ज किए गए सभी शब्द

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

Yandex.Alice के लिए कौशल स्क्रिप्ट

अब ऐलिस के लिए स्क्रिप्ट पर चलते हैं, यह लगभग टेलीग्राम के लिए ही है।

हम लाइब्रेरी को भी कनेक्ट करते हैं जहाँ बॉट और ऐलिस के संदेशों को संसाधित किया जाएगा, साथ ही ऐलिस के लिए कक्षाओं के साथ एक पुस्तकालय:

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

हमें डेटा मिलता है:

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

हम डेटा को चर में पार्स करते हैं:

 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'];} } } 

यहां आवश्यक चर कुछ कम हैं:

$ टोकन - अब उपयोगकर्ता द्वारा यहां दर्ज किए गए सभी शब्द

$ user_id - यहाँ उपयोगकर्ता आईडी है

यैंडेक्स लगातार प्रकाशित कौशल को पिंग करता है, और मैंने तुरंत पूर्ण संदेश प्रसंस्करण शुरू किए बिना स्क्रिप्ट से बाहर निकलने के लिए एक रेखा जोड़ी

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

हम प्रसंस्करण के लिए Parse_Tokens फ़ंक्शन कहते हैं, यह टेलीग्राम के लिए समान है:

 $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; ///// 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; if (strlen($out_tts) < 1) {$Data_Out->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 = ""; // do something with tokens // $out = "Your eneter " . count($tokens) . " words: " . implode($tokens, " "); return $out; } 

यदि आपको किसी प्रश्न और उत्तर की तुलना में अधिक जटिल रूप के उपयोगकर्ता के साथ संवाद करने की आवश्यकता है, तो आपको डेटाबेस (उदाहरण के लिए mysql) उपयोगकर्ता के $ user_id और उपयोगकर्ता से पहले से प्राप्त डेटा को सहेजना होगा और उन्हें Parad_Tokens फ़ंक्शन में विश्लेषण करना होगा।

वास्तव में, यह लगभग सभी है, अगर सब कुछ सही ढंग से किया जाता है, तो टेलीग्राम बॉट पहले से ही उपलब्ध है, ऐलिस के कौशल को Dials.yandex.ru/developer द्वारा जांचा जा सकता है, परीक्षण टैब पर आपके नए कौशल पर जा रहा है।



यदि सब कुछ सही ढंग से काम करता है, तो आप "मॉडरेशन" बटन पर क्लिक करके कौशल को मॉडरेशन में भेज सकते हैं।

अब आपके पास अलग-अलग प्लेटफ़ॉर्म के लिए दो बॉट हैं जो समान तरीके से काम करते हैं।

यहाँ Yandex.Dialog सेवा प्रलेखन

पूर्ण स्क्रिप्ट github डाउनलोड पर पोस्ट की गई हैं।

अपडेट: कक्षाओं में सब कुछ लपेटा और जीथब पर रिपॉजिटरी को अपडेट किया