ドキュメント / クイックスタート
10分で最初のボットを立ち上げる
このガイドでは、Telegramボットの作成からMeshwireへの接続、実際のフローの公開までを説明します。
1. BotFatherでボットを作成する
Telegramを開き、@BotFatherにメッセージを送り、/newbotを実行します。表示名と「bot」で終わる一意のユーザー名を選びます。BotFatherがHTTP APIトークンを返すので、コピーしてください。次のステップで必要になります。
/newbot
Alright, a new bot. How are we going to call it?
> Acme Support Bot
Good. Now let's choose a username for your bot.
> acme_support_bot
Done! Use this token to access the HTTP API:
110201543:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw2. トークンをMeshwireに接続する
コンソールで「ボット → 新しいボット」に進み、トークンを貼り付けてホスティングモードを選択します。本番環境にはWebhookモードを推奨します。ポーリングは簡単なローカルテストに便利です。
POST /v1/bots
{
"name": "Acme Support Bot",
"token": "110201543:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw",
"hostingMode": "webhook",
"timezone": "Europe/Warsaw"
}3. 最初のフローを作成する
フローエディタを開き、trigger.commandノード(例:/start)をキャンバスにドラッグします。ウェルカムメッセージを含むmsg.textノードに接続し、次にクイックリプライボタン付きのmsg.inline_keyboardノードを追加します。
trigger.command(/start)
-> msg.text("Welcome to Acme Support! How can we help?")
-> msg.inline_keyboard(["Talk to sales", "Track an order"])4. サンドボックスでテストする
内蔵のシミュレーターを使って、実際のTelegramトラフィックに影響を与えずにテストメッセージを送信できます。ボタンやメディアを含め、フローが実際にどう応答するかを正確に表示します。
Simulator > /start
Bot: Welcome to Acme Support! How can we help?
[ Talk to sales ] [ Track an order ]5. 公開する
「公開」をクリックし、短いリリースノートを追加します。Meshwireはフローを検証し、バージョンのスナップショットを作成して、実際のトラフィックをそちらに切り替えます。過去のバージョンにはいつでもロールバックできます。
POST /v1/bots/{botId}/publish
{ "note": "Initial launch: welcome + support routing" }