fromTG-Migration 2026 チェックリスト：Bot、エージェント、トークスクリプト、振り分け

チームがonlyTGでTelegramカスタマーサポートを管理しているが、エージェントコラボレーション、セッション振り分け、コンテンツ内部統制において機能不足を感じているなら、TG-Staffへの移行は検討に値するアップグレードです。TG-Staffは、より完全なエージェント管理、ビジュアルフローエディタ、セッション振り分け機能を提供するだけでなく、Web3チーム向けのコンテンツリスク管理と暗号ウォレットアドレス監視機能も内蔵しています。

この記事は、onlyTGからTG-Staffへスムーズに移行し、データ損失、エージェントのアイドル状態、ユーザーサービスの中断を防ぐための実践的な移行チェックリストです。

移行前準備：onlyTGのサブスクリプション状態とデータバックアップの確認

TG-Staffを操作する前に、15分かけて以下の準備を完了してください。これは移行プロセス全体で最も見落とされがちですが、最も重要なステップです。

onlyTGからBot TokenとAPI認証情報のエクスポート

Bot Token はBotとカスタマーサポートプラットフォームを接続する唯一の認証情報です。どのプラットフォームに移行する場合でも必要です。

1. BotFatherにログインし、該当するBotを見つけて、/mybotsコマンドでBot設定に入ります。
2. API Tokenをクリックするか、Token文字列を直接コピーします。onlyTGコンソールにTokenが表示されている場合は、スクリーンショットを保存してください。
3. onlyTGでサードパーティAPI（Google Translate、DeepLキーなど）を設定している場合は、それらのキーもエクスポートします。

注意：Bot TokenはBotの管理者パスワードと同等です。公開しないでください。移行完了後、このTokenをTG-Staffで再入力して認証を行います。

トークスクリプトとユーザーセグメントルールのバックアップ

onlyTGの挨拶文、メニューボタン、マルチステップ対話フロー、ユーザータググループは、通常自動的に新しいプラットフォームに同期されません。手動でエクスポートする必要があります：

• トークスクリプト：条件分岐ロジックを含む、onlyTG内のすべてのBot自動応答のテキストコンテンツをコピーします。スクリーンショットまたはMarkdownファイルで保存することをお勧めします。
• ユーザーセグメントルール：onlyTGで作成したタグ、グループ条件（「アクティブユーザー」「VIP顧客」など）を記録します。TG-Staffのプロフェッショナル版はユーザープロファイルとセグメントをサポートしており、後でコンソールでこれらのルールを再構築できます。

ステップ1：TG-Staffでプロジェクトを作成しBotを認証

バックアップ後、TG-Staffコンソールにログインし、登録して3日間の無料トライアルを開始します。

Bot Tokenを使用した迅速な認証

1. コンソールの左メニューで「プロジェクト」をクリックし、「プロジェクト作成」をクリックします。
2. プロジェクト名を入力します（チームが識別しやすいよう、onlyTGのBot名と同じにすることを推奨）。
3. 「Bot Token」入力フィールドに、BotFatherから取得したTokenを貼り付けます。
4. 「認証」をクリックすると、TG-Staffが自動的にBotのアイコン、名前、説明を取得します。

全体のプロセスは1分未満です。BotFatherで追加の操作は不要で、TG-Staffが直接BotのWebhookアドレスを引き継ぎます。

Botのオンライン状態とメッセージ送受信の確認

認証完了後、コンソールの「プロジェクト詳細」でBotの状態が「オンライン」と表示されます。すぐにメッセージ送受信テストを行うことをお勧めします：

1. TelegramでBotにメッセージを送信します（例：「こんにちは」）。
2. TG-Staffの「セッション」パネルに、新しいセッションがすぐに表示されるはずです。
3. エージェントとしてWebポータルにログインし、このメッセージに返信し、ユーザー側で正常に受信されるか確認します。

メッセージの経路が正常であれば、TG-StaffがBotを正常に引き継いだことを示します。この時点でonlyTGのBotはまだ動作していますが、二重応答を避けるため、できるだけ早くonlyTGのBotサービスを停止することをお勧めします。

ステップ2：カスタマーサポートチームの再構築と権限設定

onlyTG のエージェントシステムは通常 Telegram グループやシンプルなアカウント共有に基づいていますが、TG-Staff は独立したエージェントアカウント、プロジェクト単位の権限、セッション割り当て記録を提供します。

エージェントを招待し、独立したアカウントを割り当てる

1. コンソールの「エージェント管理」で「エージェントを招待」をクリックします。
2. エージェントのメールアドレスを入力します（各エージェントは Web ポータルにログインするために独立したメールアドレスが必要です）。
3. エージェントの「プロジェクト権限」を設定します：どのプロジェクトを表示できるか、編集権限があるかを構成できます。
4. エージェントが招待メールを受信したら、パスワードを設定してログインできます。

onlyTG と比較した TG-Staff の利点：

• 各エージェントが独自のログインアカウントを持ち、操作が追跡可能です。
• プロジェクト単位の権限分離をサポートし、複数 Bot チームに適しています。
• プロフェッショナル版ではプライベートメモ機能も提供され、エージェント同士の干渉を防ぎます。

onlyTG のエージェントロールとの対応

your onlyTG チームに「管理者」「カスタマーサポートリーダー」「一般サポート」などのロールがある場合、TG-Staff では権限設定で対応できます。例えば、リーダーはすべてのセッションを表示でき、一般サポートは自分に割り当てられたセッションのみ表示できます。

ステップ3：スクリプトフローとルーティングルールの移行

このステップは移行作業の中で最も工数がかかりますが、TG-Staff のビジュアルコマンドフローエディターにより、再構築のハードルを大幅に下げることができます。

ビジュアルコマンドフロー：コード不要で Bot インタラクションを構築

TG-Staff のコマンドフローエディターはドラッグ＆ドロップのノード設計を採用しており、コードを書かずに Bot の自動応答ロジックを構築できます。

1. コンソールの「コマンドフロー」で「新規フロー」をクリックします。
2. 左側のノードパネルから「ウェルカムメッセージ」ノードをキャンバスにドラッグし、onlyTG で使用していたウェルカムテキストを入力します。
3. 「メニュー」ノードをドラッグし、ボタンテキストとジャンプロジックを設定します（例：「価格を見る」→「価格カードを送信」）。
4. 「条件分岐」ノードをドラッグし、ユーザー入力のキーワードに基づいて異なる応答に振り分けます。

onlyTG のテキストベースの設定と比較して、TG-Staff のドラッグ＆ドロップインターフェースは直感的で、特に多段階のインタラクション（アンケート、チケット提出など）に適しています。onlyTG のスクリプトテンプレートを対応するノードに1つずつコピーできます。

セッションルーティングとダイバージョンリンクの設定

セッションルーティングは、ユーザーメッセージをどのようにエージェントに割り当てるかを決定します。TG-Staff は2つの割り当てモードを提供します：

• ラウンドロビン割り当て（デフォルト）：新しいセッションを順番に権限のあるエージェントに割り当てます。エージェント数が安定しているチームに適しています。
• オンライン優先：現在オンラインのエージェントに優先的に割り当て、全員オフラインの場合はラウンドロビンにフォールバックします。シフト制が不規則なチームに適しています。

「プロジェクト設定」→「セッションルーティング」でモードを選択し、割り当てに参加するエージェントを指定できます。

さらに、TG-Staff のダイバージョンリンクはユニークなトラフィック誘導ツールです。ショートリンク（例：https://app.tg-staff.com/abc123）を作成でき、ユーザーがそのリンクをクリックすると、TG-Staff がユーザーのIP、ブラウザ情報、URLパラメータをキャプチャし、Bot にリダイレクトします。これは広告 attribution やマルチチャネルトラッキングに非常に便利です——onlyTG には通常このような機能は組み込まれていません。

第4ステップ：コンテンツリスク管理とコンプライアンス設定の移行（プロフェッショナル版）

もしあなたのチームがWeb3、暗号通貨、または金融業務に関わっている場合、コンテンツリスク管理は移行において見逃せない要素です。TG-Staff プロフェッショナル版に組み込まれたコンテンツリスク管理モジュールは、エージェントが送信するメッセージを正確に監視し、誤送信や機密情報の不正送信を防止します。

リスクワードリストとウォレットアドレス監視の設定

1. 管理画面の「コンテンツリスク管理」→「リスクワードリスト」で、「ワードリスト作成」をクリックします。
2. ワードリスト名を入力します（例：「ウォレットアドレスブラックリスト」）。
3. リスクキーワードを追加します：完全なTRC20/ERC20/BTCアドレス、またはアドレスの一部（例：T9yD14）を入力できます。TG-Staff は前方一致と完全一致をサポートしています。
4. リスクワードリストを特定のプロジェクトに関連付け、「エージェント送信メッセージ監視」を有効にします。
5. トリガーアクションを設定します：「ポップアップで再確認」または「送信をブロック」を選択できます。

例えば、取引所のBotエージェントがユーザーの出金リクエストに手動で返信する必要がある場合、ウォレットアドレス監視を設定することで、エージェントが誤った受取アドレスを送信したり、ユーザーに追加料金を故意に要求することを防止できます。この機能は、onlyTGでは通常、独自開発またはサードパーティプラグインに依存する必要があります。

監査とアラート：トリガー記録の確認

エージェントがリスクルールをトリガーした場合、「コンテンツリスク管理」→「トリガー記録」で詳細なログを確認できます。以下を含みます：

• トリガーしたエージェント
• 所属するセッション
• トリガー時刻
• ヒットしたリスクワード

これらの記録は、コンプライアンス監査、従業員トレーニング、または紛争解決に使用できます。移行後は、まずテスト用のリスクワード（例：test-risk）を作成し、エージェントにそのワードを含むメッセージを送信させて、リスク管理が正常に機能するか検証することをお勧めします。

第5ステップ：全チェーンテストと本番トラフィックへの切り替え

本番切り替え前に、完全なエンドツーエンドテストを実行します。以下はチェックリストです。印刷するか、プロジェクト管理ツールにコピーして項目を一つずつチェックできます。

テストに合格したら、以下の操作を実行して正式に切り替えます：

1. onlyTG で Bot サービスを停止します（または Bot Token を無効化します）。
2. TG-Staff ですべてのエージェントがログインし、オンラインであることを確認します。
3. カスタマーサポートチームに通知します：新プラットフォームが稼働し、旧プラットフォームは使用停止となります。
4. 広告素材やソーシャルメディアのリンクを更新し、TG-Staff の新しい分流リンクに変更します。

よくある質問

質問：TG-Staff に移行後、onlyTG の Bot は引き続き使用できますか？

回答：はい。TG-Staff は同じ Bot Token を使用して Bot を引き継ぐため、onlyTG の Bot はすぐには無効になりません。TG-Staff ですべてのテストが完了した後に onlyTG の Bot サービスを停止することを推奨します。両プラットフォームが同時に応答してユーザーに混乱を与えるのを防ぐためです。

質問：onlyTG のユーザーチャット履歴は TG-Staff にインポートできますか？

回答：TG-Staff は現時点では onlyTG の過去のチャット履歴を直接インポートする機能をサポートしていません。移行後、新しいセッションは TG-Staff に保存されます。onlyTG で重要な会話記録をバックアップとしてエクスポートし、後で参照できるようにすることをお勧めします。

質問：移行中に Telegram ユーザーの通常利用に影響がありますか？

回答：適切に操作すれば、ユーザーはほとんど気付きません。TG-Staff で Bot Token を承認し、エージェントを設定するだけで、ユーザーがメッセージを送信すると自動的に TG-Staff のセッションキューに入ります。オフピーク時に切り替え、事前にカスタマーサポートチームに通知することをお勧めします。

質問：TG-Staff の分流リンク機能は onlyTG と何が違いますか？

回答：TG-Staff の分流リンク（Diversion Link）は公式ドメインの短縮リンクであり、訪問者の IP、ブラウザ情報、URL パラメータを取得できます。広告のトラフィック帰属に適しています。onlyTG には同様の組み込み帰属機能がない場合があります。移行後は、新しい分流リンクを生成し、広告素材を更新することをお勧めします。

質問：TG-Staff は暗号通貨での支払いに対応していますか？

回答：対応しています。Stripe クレジットカード支払いに加えて、TG-Staff は USDT（TRC20）チェーン上の支払いも受け付けており、暗号通貨を好むチームに適しています。管理画面の「マイサブスクリプション」から USDT 支払い方法を選択できます。

---

TG-Staff への移行は複雑な作業ではありません。上記のチェックリストに従って順を追って実行すれば、ほとんどのチームが 1〜2 時間で切り替えを完了できます。移行中に問題が発生した場合は、公式移行ドキュメント を参照するか、カスタマーサポート Bot に直接連絡してリアルタイムのサポートを受けてください。

すぐに TG-Staff に登録して、3日間の無料トライアルを開始しましょう：https://app.tg-staff.com/