Yandex.Cloud で Telegram ボットを構築する

今日は廃材を使って組み立てていきます Yandex.Cloud 電報ボット を使用して Yandexクラウド機能 （または Yandexの機能 - 略して）そして Yandex オブジェクト ストレージ （または オブジェクトストレージ - 明確にするために）。 コードがオンになります Node.js。 ただし、厄介な状況が XNUMX つあります。たとえば、次のような組織があります。 ロスコムツェンズル (検閲はロシア連邦憲法第 29 条で禁止されています)、ロシアのインターネットプロバイダーがリクエストを送信することを許可しません。 電報API поадресу： https://api.telegram.org/。 そうですね、私たちはしません - いいえ、いいえ。 結局のところ、私たちのバッグにはいわゆるものが入っています。 Webhook — 彼らの協力を得て、私たちは特定のアドレスにリクエストを行うのではなく、単に私たちへのリクエストに対する応答としてリクエストを送信するだけです。 つまり、オデッサのように、質問には質問で答えるのです。 それが理由です 電報API 私たちのコードには現れません。

免責事項この記事で言及されている政府組織の名前は架空のものであり、実際の組織の名前と一致する可能性があるのは偶然です。

そこで、賢い思考を提供してくれるボットを作成します。 まさに写真の通りです:

実際に試してみることができます。名前は次のとおりです。 @SmartThoughtBot。 ボタンに気づきました 「アリスのスキル」? これは、ボットが同じ名前のボットの一種の「コンパニオン」であるためです。 アリスのスキル、つまりと同じ機能を実行します アリスのスキル そして、お互いを宣伝し合うことで平和的に共存できる可能性があります。 作成方法について スキル 賢い思考 記事に記載されている アリスがスキルを獲得。 現在（上記の記事の公開後にいくつかの変更を加えた後）スマートフォンではこれ スキル 次のようになります:

ボットの作成

このチュートリアルが、すべての人に役立つことを願っています。 初心者のボットビルダーも。 したがって、このセクションでは、一般的な作成方法について詳しく説明します。 Telegramボットです。 この情報が不要な場合は、次のセクションに進んでください。

アプリケーションを開く テレガラム、すべてのボットの父と呼んでみましょう（彼らは人間と同じようにすべてを持っています） - @BotFather - そしてまず、彼に /help コマンドを与えて、私たちができることの記憶をリフレッシュさせます。 今、私たちはチームに興味を持っています / newbot.

ここで説明するボットはすでに作成されているため、デモンストレーションの目的で、別のボットを短時間作成します (その後、削除します)。 彼に電話します デモハブボット。 名前 (ユーザ名) すべての電報ボットは次の単語で終わる必要があります ボットたとえば、次のようになります。 マイクールボット または my_cool_bot - これはボット用です。 ただし、最初にボットに名前を付けます (名） - そしてこれは人々のためのものです。 名前はどの言語でも使用でき、スペースを含めることができ、単語で終わる必要はありません。 ボット、一意である必要さえありません。 この例では、このボットを呼び出しました デモハブル.

次に、ボットの名前を選択します (ユーザ名、ボット用のもの）。 彼に電話しましょう デモハブボット。 ボットの名前に関連するすべて (名）彼の名前とはまったく関係ありません - ユーザ名 （または当てはまりますが、まったく逆です）。 一意のボット名の作成に成功したら、スクリーンショットに赤い矢印で示されているトークンをコピーして保存する必要があります (厳重に注意してください)。 その助けを借りて、後でその起源を確立します Telegram'私たちのへのWebhook ヤンデックス機能.

次に、すべてのボットの父にコマンドを与えてみましょう。 /マイボットをクリックすると、作成したすべてのボットのリストが表示されます。 焼きたてのボットは今のところ放っておいてください デモハブル (これはボットの作成方法を示すために作成されましたが、今日は他のデモンストレーション目的にも使用します)、ボットを見てみましょう 賢い思考 (@SmartThoughtBot）。 ボットのリストでその名前のボタンをクリックします。

ここでボットを構成できます。 ボタンを押すことで 編集... XNUMX つまたは別のオプションの編集に進みます。 たとえば、ボタンをクリックすると、 名前の編集 代わりにボットの名前を変更できます 賢い思考書く クレイジーなアイデア. ボットピック - これはボットのアバターです。少なくとも 150 150 X PX. 説明 — これは、質問に対する答えとして、ボットを初めて起動するときにユーザーに表示される短い説明です。 このボットは何ができるのでしょうか? 私たちについて — さらに短い説明。ボットへのリンクとともに送信されます (https://t.me/SmartThoughtsBot)、またはそれに関する情報を表示するとき。

あとはコマンドを設定するだけです。 これを行うには、ボタンを押します 編集コマンド。 ユーザーの実践を標準化するには Telegram 常に XNUMX つのコマンドを使用することをお勧めします。 /開始 и /助けてボットに設定が必要な場合は、追加の /settings コマンドを使用します。 私たちのボットはボールのようにシンプルなので、まだ設定は必要ありません。 最初の XNUMX つのコマンドを作成し、コードで処理します。 ユーザーが入力フィールドにスラッシュ (スラッシュ記号: /) を入力すると、コマンドのリストが表示され、簡単に選択できるようになります。 すべては写真のとおりです。左側 - 父親ボットを通じてコマンドをインストールします。 右側では、これらのコマンドはボットのユーザーにすでに使用可能です。

ヤンデックス機能

ボットが作成されたので、次のページに進みます。 Yandex.Cloudボットのコードを実行する関数を作成します。 一緒に働いたことがない場合 Yandex.Cloud 資料を読む ビットリックスの国のアリス、 その後 - Yandex 関数がメールを送信する。 この XNUMX つの比較的短い記事は、このテーマの基本を理解するには十分であると確信しています。

それでコンソールで Yandex.Cloud 左側のナビゲーション メニューで項目を選択します クラウド機能を選択し、 ボタンを押します 関数を作成する。 これに名前と簡単な説明を付けます。

ボタンを押した後 作ります 数秒後、新しい関数がすべての関数のリストに表示されます。 彼女の名前をクリックすると、そのページに移動します Обзор 私たちの機能。 ここで有効にする必要があります(On) スイッチ 公共機能外部からアクセスできるようにします（ Yandex.Cloud)世界の、そしてフィールドの意味 通話リンク и 識別子 — あなたの関数がさまざまな詐欺師によって呼び出されないように、あなた自身と Telegram 以外の誰に対しても秘密にしてください。

次に、左側のメニューを使用して、次の場所に移動します エディタ 機能。 私たちのことはちょっと脇に置いておきましょう 賢い思考、ボットの機能をチェックするための最小限のテンプレート関数を作成します...ただし、この文脈では、この関数はボットです...つまり、今ここで、「ミラーリング」する単純なボットを作成します(つまり、ユーザーリクエストを送り返します。 このテンプレートは、新しい電報ボットを作成するときに常に使用して、確実に通信できるようにすることができます。 電報'オームは正常に動作します。 クリック ファイルを作成、そう呼びましょう index.js、そしてオンライン コードエディタ 次のコードをこのファイルに貼り付けます。

module.exports.bot = async (event) => {
  
  const body = JSON.parse(event.body);

  const msg = {
    'method': 'sendMessage',
    'chat_id': body.message.chat.id,
    'text': body.message.text
  };

  return {
    'statusCode': 200,
    'headers': {
      'Content-Type': 'application/json'
    },
    'body': JSON.stringify(msg),
    'isBase64Encoded': false
  };
};

Yandex.Cloud コンソールでは、次のように表示されます。

さらに以下に示します エントリーポイント - インデックスボットどこ index これはファイル名です (index.js）、および ボット - 関数名 (module.exports.bot）。 他のフィールドはすべてそのままにして、右上隅のボタンをクリックします。 バージョンの作成。 数秒以内に、このバージョンの関数が作成されます。 テスト後すぐに ウェブフック、新しいバージョンを作成します- 賢い思考.

オブジェクトストレージ

これで作成が完了しました ヤンデックス機能さあ、コンソールにいる間に Yandex.Cloud、いわゆるものを作成しましょうバケツ （バケット、つまりボットで使用される画像ファイルを保存するためのロシア語のバケツ。花束ではありません） 賢い思考。 左側のナビゲーション メニューで項目を選択します オブジェクト記憶域、 ボタンを押す バケットを作成する、名前を考えてください。たとえば、 画像バケット、 最も重要な、 オブジェクトへの読み取りアクセス 私たちはそれを公開します - そうしないと、Telegram は私たちの写真を見ることができません。 他のフィールドはすべて変更しないままにします。 ボタンを押す バケットを作成する.

この後、すべてのバケットのリストは次のようになります (これが唯一のバケットの場合)。

ここで、バケットの名前をクリックし、その中にフォルダーを作成して、さまざまなアプリケーション用の画像のストレージを整理することをお勧めします。 たとえば、電報ボットの場合 賢い思考 というフォルダーを作成しました tg-bot-smart-thoughts (何もありません。このコードは理解できます)。 あなたも作成してください。

これで、フォルダー名をクリックしてフォルダーに入り、ファイルをアップロードできるようになります。

ファイル名をクリックすると、それを入手できます URL 私たちのボットで使用するため、そして一般的にどこでも使用できます（ただし、これを公開しないでください） URL からのトラフィックのため不要です。 オブジェクトストレージ 有料）。

基本的に必要なのはこれだけです オブジェクトストレージ。 これで、ファイルをアップロードするように求めるプロンプトが表示されたときに何をすべきかがわかります。

Webhook

それではインストールしていきます ウェブフック - つまりボットがサーバーから更新 (ユーザーからのメッセージなど) を受信したとき Telegram 私たちの ヤンデックス機能 リクエストが送信されます (要求) データ付き。 以下の行は、ブラウザのアドレス フィールドに貼り付けて、ページを更新するだけで済みます (これは XNUMX 回だけ行う必要があります)。 https://api.telegram.org/bot{bot_token}/setWebHook?url={webhook_url}
交換するだけです {ボットトークン} ボットの作成時に親ボットから受け取ったトークンに、 {ウェブフック_url} - オン URL 私たちの Yandexの機能。 ちょっと待って！ しかし ロスコムツェンズル ロシア連邦のプロバイダーがそのアドレスにサービスを提供することを禁止します https://api.telegram.org。 はい、そうです。 しかし、何かを思いつきます。 結局のところ、たとえば、ウクライナ、イスラエル、カナダでは、このことについて祖母に尋ねることができます。そこには「ロスコム検閲」はなく、それなしで人々がどのように生きるかは神のみぞ知るです。 その結果、Webhook をインストールするときのリクエストとレスポンスは次のようになります。

私たちはテスト中です。 「ミラーリング」する必要があります。

これは本当です。 おめでとうございます - 今 ヤンデックス機能 となっています Telegram-ボット！

賢い思考

さあ、スマート思考をしてみましょう。 コードは開いていて上にあります GitHubの。 かなりよくコメントされており、長さはわずか XNUMX 行です。 オペラの歌姫の台本のように読んでみてください。

プロジェクトのクローンを作成し、依存関係をインストールします。

git clone https://github.com/stmike/tg-bot-smart-thoughts.git
cd tg-bot-smart-thoughts
npm i

ファイルに必要な変更を加えます index.js (オプション。何も変更する必要はありません)。 作成する ZIP-アーカイブ、ファイル付き index.js とフォルダー node_modules たとえば、名前の下にある スマート.zip.

次に、コンソールに移動して、 Yandexの機能、タブを選択 ZIP アーカイブ、 ボタンを押す ファイルを選択、アーカイブをダウンロードしてください スマート.zip。 最後に、右上隅にあるボタンをクリックします バージョンの作成.

数秒後に機能が更新されたら、ボットを再度テストします。 今では彼はもはや「鏡」ではなく、賢明な考えを伝えています。

それが今日のすべてです。 さらに多くの記事が続きます。 これを読むことに興味がある場合は、新しい記事に関する通知を購読してください。 ここから、または次の場所から購読できます。 Telegram-チャネル IT チュートリアル ザハルまたは Twitter @mikezaharov.

リファレンス

GitHub 上のコード
Yandexクラウド機能
Yandex オブジェクト ストレージ
ボット: 開発者向けの概要
電報ボット API

寄付

出所： habr.com