GetMyBot ナレッジベース

プロジェクトとチャンネル

プロジェクトを作成してボットを接続し、状態を確認します。複数チャンネル、トークンの変更、一時停止、プランによる凍結からの復旧も説明します。

このページの内容

プロジェクトには、ボットやサービスの設定、リアクション、データがまとまっています。チャンネルは、Telegram ボットやサイトのチャットなど、人とやり取りする場所をプロジェクトにつなぎます。たとえば、学校なら 1 つのプロジェクトに Telegram とウェブサイトの 2 つのチャンネルを接続できます。

プロジェクトでプロジェクトを作り、チャンネルを追加してください。Telegram には、ボットを管理するための @BotFather のトークンが必要です。画面上部でプロジェクトを切り替えられます。

Telegram 以外に WhatsApp と VK も接続でき、同じリアクションを各チャンネルで使えます。概要はチャンネル、WhatsApp の接続手順はWhatsAppをご覧ください。

ボットを接続する

  1. プロジェクトがまだなければ、プロジェクトでプロジェクトを追加を押します。そのカードでチャンネルを追加を押し、Telegram を選びます。最初のボットには初回設定ウィザードも使えます。
  2. @BotFather のトークンを貼り付け、確認を押します。GetMyBot に @username が表示されるので、正しいボットか確かめてください。
  3. 接続を押します。トークンは暗号化して保存され、イベントの受信がすぐに始まります。

接続した Telegram は、ほかのチャンネルとともにプロジェクトカードに表示されます。カードにはプロジェクト名、ボットの @username、ユーザー数、有効なリアクション、今日のリクエスト数が載ります。リクエスト残量は料金プランまたは統計で確認できます。

複数のボットを管理する

1 つのアカウントで複数のプロジェクトやボットを管理できます。数は料金プランの「ボットの最大数」で制限されます。画面上部またはプロジェクトで切り替えてください。リアクション、チャット、統計には、選択中のプロジェクトのデータが表示されます。

ボットがメッセージを受け取る仕組み

接続後は GetMyBot が Telegram のメッセージ、ボタン操作、チャットへの参加、支払いなどのイベントを自動で受け取ります。有効なトークンがあれば、受信の設定は別途不要です。サーバー設定に応じて、Telegram がプラットフォームのアドレスにイベントを送る(webhook)か、プラットフォームが Telegram に定期的に問い合わせます(long polling)。

オンとオフを切り替える

各ボットはオン/オフを切り替えられます。設定のボットの状態カードで変更してください。オフのボットはメッセージに反応しません。再接続は不要で、変更はすぐに反映されます。

プロジェクトの状態とチャンネルの稼働状況

プロジェクトの一覧には、プロジェクト自体の状態として有効、一時停止、凍結が表示されます。これは Telegram の配信状況を調べた結果ではありません。チャンネルには別の表示があり、オンライン、信号なし、設定済み、無効、プロジェクトは無効のいずれかです。そのため、Telegram を使わずウェブチャットだけを持つ有効なプロジェクトも、停止中とは表示されません。

有効なプロジェクトにオンの Telegram チャンネルが 1 つだけある場合、オンラインは担当プロセスから最近稼働信号が届いたことを示します。届いていなければ信号なしです。オンの Telegram チャンネルが複数ある場合は設定済みと表示されます。プロジェクト共通の信号を特定のチャンネルの状態とみなせないためです。他のプラットフォームのオンのチャンネルでは、設定済みは接続されていることを意味し、個々のメッセージの配信を保証しません。

プラットフォームでは複数のプロセスが並行して動き、それぞれが担当するボットの信号を 30 秒ごとに送ります。信号は1 分半有効です。1 回途切れただけでは状態が変わりません。

実際の確認では、次に注意してください。

  • 表示は少し遅れることがあります。 接続後やプラットフォームの再起動後、オンラインはすぐではなく、この時間内に表示されることがあります。
  • オンの Telegram チャンネルで信号なしが数分以上続く場合は、トークンと設定のBot healthカードを確認してください。自分で一時停止するか、プランによって凍結されない限り、プロジェクトは有効のままです。
  • 信号はプロセス間で共通で、リクエストにどのサーバーが応答したかには左右されません。Telegram チャンネルが複数あるとき、各チャンネルの稼働を個別に証明するものではありません。

ボットがオフラインになると

プラットフォームは 1 分ごとに稼働信号を確認します。オンのボットから新しい信号がなければ障害記録を作成し、原因を一度判定して、復旧を自動で試みます。

設定のBot healthカードには、次の 4 つの原因が表示されます。

  • Webhook: Telegram がプラットフォームのアドレスに更新を届けられないため、アドレスを再登録します。
  • トークンの取り消し: getMe が 401 を返します。再起動では直りません。@BotFather で新しいトークンを発行し、トークンを変更から入力してください。
  • 担当サーバーなし: 更新を処理するサーバーがないため、ボットを再起動します。
  • 原因不明: Telegram が確認要求に応答しませんでした。

再起動は同期ボタンと同じく、getMe でトークンを確認し、webhook を再登録します。試行間隔は次第に長くなります。各試行の時刻、結果、失敗時のエラーはRestart logに残り、次の試行時刻もカードに表示されます。

Bot healthに設定された時間(初期値は 5 分)以上ボットが応答しない場合、オーナーにアプリのベル通知とメールで「Бот офлайн」(ボットがオフライン)の通知が届きます。通知先に追加したチャットには、ボットからもメッセージが送られます。通知は障害 1 件につき 1 回です。信号が戻ると、「Бот снова онлайн」(ボットが再びオンライン)の通知に停止時間が表示されます。過去の障害の時間と原因は同じカードに残ります。

料金プランによる凍結

オン/オフとは別に、ボットが凍結されることがあります。ユーザーが操作するのではなく、現在のプランで接続済みボットの数をまかなえなくなったときにプラットフォームが凍結します。理由は 2 つです。

  • ボット数の上限超過: 現在接続している数より上限の小さいプランに変更した。
  • 契約が更新されなかった: 有料プランが終了し、無料プランの上限が適用された。

凍結されたボットはメッセージを受け取れません。更新の受信そのものが停止します。データ、リアクション、登録者はすべて保持され、凍結は解除できます。

再開するには必要なボット数に対応するプランを購入します。有料プランが有効になると、古いボットから順に新しい上限に達するまで自動で復旧します。復旧するボットを選ぶことはできません。別のボットを優先したい場合は、購入前に不要な接続を外してください。

ボットの凍結とは別に、アカウント全体が凍結される場合もあります。このときはすべてのボットと一斉配信が止まり、管理画面に「アカウントが凍結されました」と表示されます。解除はサポートに依頼してください。詳しくは支払いと残高をご覧ください。

プロフィールと同期

設定の同期を押すと、@BotFather で変更したボット名を Telegram から取得し直します。ボットのプロフィール画像は自動で取得されます。

トークンを変更する

@BotFather でトークンを再発行した場合(Bot Settings → Revoke / New token)、設定 → チャネル → Telegram 🔑で更新してください。新しいトークンは同じボット(Telegram の内部 ID が一致する)のものである必要があります。これにより、すべてのリアクション、購読者、データが保持されます。 Telegramチャンネルが表示されない場合は、同じウィンドウで«トークンを変更»を選択してください。

別のアカウントにプロジェクトを譲渡する

設定 → オーナーを変更から、別の GetMyBot アカウントのメールアドレスに譲渡の招待を送れます。招待の有効期間は 72 時間です。相手が承諾するまではプロジェクトは引き続きあなたのもので、譲渡を取り消せます。承諾されると所有者が変わり、あなたはプロジェクトにアクセスできなくなります。クライアントや同僚に引き渡す際に使ってください。

ボットのテンプレート

テンプレートはプロジェクトの設定とすべてのリアクションを保存したもので、別のプロジェクトに適用できます。

  • 設定のテンプレートを作成で、現在のプロジェクトを名前付きで保存します。
  • テンプレートを適用すると、選択中のプロジェクトの設定がテンプレートの設定に置き換わり、テンプレートのリアクションは既存のものに追加されます。

同じ構成のプロジェクトを複数作るときに便利です。

カタログから完成済みのソリューションを導入する

完成済みソリューションのカタログにはセットアップウィザードがあります。項目を入力し、互換性と必要な接続を確認してから、作成されるリソースの一覧を確認します。導入後は残りの手順を完了し、テスト用の問い合わせでシナリオを試してください。

このウィザードは上記のボットテンプレートの適用とは別です。導入前の確認では不足している項目や機能が分かります。手順を完了にしても、外部サービスが実際に動いている証明にはなりません。

ソリューションの成果を確認する

導入したソリューションを評価する期間を選びます。比較できる方法を選び、サンプル数と診断情報を確認してください。データ不足や比較対象がないことは、結果がゼロであることとは異なります。

次のステップ