TG-Staff 团队 avatar TG-Staff 团队

Echo TG から TG-Staff への30分完全移行チェックリスト(Botはそのまま)

echo-tg 切り替え TG-Staff 移行ガイド

30分でEcho TGからTG-Staffに切り替える:完全チェックリスト(Botはそのまま)

Echo TGを使ってTelegramカスタマーサポートを処理しているものの、チームが拡大するにつれて、単一エージェント、振り分けなし、ユーザープロファイルなしの体験がビジネスのペースに追いつかなくなっているなら、より専門的な代替案を検討する時です。Echo TGからTG-Staffへの切り替えは、わずか30分で完了し、Telegram Bot自体は一切変更されず、ユーザーは全く気付きません。

この記事では、準備から最終確認までの全手順を網羅した、すぐに実行可能な移行チェックリストを提供し、ダウンタイムゼロでの切り替えを支援します。

なぜEcho TGからTG-Staffに切り替えるのか?

Echo TGは個人や超小規模チームが素早く始めるのに適していますが、カスタマーサポートチームに複数人での協力、複数チャネルからの集客、コンプライアンス管理が必要になると、その限界が露呈します。以下は両者の主な違いです:

比較項目Echo TGTG-Staff
エージェント数通常1エージェントスタンダード版3エージェントから、プロフェッショナル版最大20エージェント
会話の振り分けなし順番割り当て / オンライン優先の2モード
振り分けリンクなし公式ショートリンク、IPキャプチャと広告アトリビューション対応
自動翻訳なしスタンダード版にAI翻訳、プロフェッショナル版はDeepL等対応
コンテンツモデレーションなしプロフェッショナル版にリスクワード監視、ウォレットアドレスブロック対応
ビジュアルフローエディタなしドラッグ&ドロップ式コマンドフローエディタ
ユーザープロファイルと統計なしプロフェッショナル版にプロファイルとデータ統計
マルチプロジェクト管理非対応プランに応じて複数Botプロジェクト対応

移行の核となる価値:あなたのBotのユーザー名とトークンは完全に変わらず、ユーザーは従来のBotを通じて会話を続け、移行プロセスはユーザーにとって透過的です。TG-Staffの管理画面で設定を完了するだけで、チームは複数エージェントによる協業、自動振り分け、運用ツールを手に入れられます。

移行前の準備(5分)

操作を開始する前に、以下の3つの準備を完了してください。このステップはわずか5分で済みますが、後のトラブルの90%を防ぐことができます。

Botトークンの取得と保存

Botトークンは移行の核となる資産です。Telegramを開き、BotFatherにアクセスし、/mybotsを入力してあなたのBotを選択し、API Tokenをクリックして完全なトークンを取得します。

  • トークンをコピーし、安全な場所に一時保存します(パスワードマネージャーやローカルのテキストファイルなど)。
  • トークンが以前に漏洩した場合は、移行完了後に再生成することをお勧めします。

注意:Bot Token セキュリティに関する注意事項

移行中、Bot Token は TG-Staff コンソールで一度だけ入力する必要があり、第三者に漏洩しないでください。セキュリティが心配な場合は、移行完了後に BotFather で Token を再生成できます。

バックアップ:Echo TG の既存設定

Echo TG の過去の会話は TG-Staff に直接インポートできませんが、以下の内容をバックアップして TG-Staff で再構築する必要があります:

  • 自動返信ルール:Echo TG で設定したすべてのキーワード返信、コマンド、トリガー条件をスクリーンショットまたは記録します。
  • よく使うコマンド一覧/start/help などのコマンドの返信内容。
  • ユーザーグループまたはタグ:カスタムグループがある場合、グループのロジックを記録します。

これらの情報は、ステップ3の再構築プロセスで使用します。

TG-Staff のプランがチームのニーズに合っているか確認する

TG-Staff は無料トライアル(3日間)、スタンダード版、プロフェッショナル版を提供しています。チーム規模に応じて選択してください:

  • スタンダード版(約 $8.99/月):1~3エージェントのチーム向け。振り分けリンク、会話振り分け、自動翻訳(AI版)、メッセージ一斉配信などのコア機能を含みます。
  • プロフェッショナル版(約 $16.99/月):3~20エージェントのチーム向け。コンテンツ管理、無制限翻訳、ユーザープロファイル、TGテーマ背景などの高度な機能を追加で提供します。

エージェントが送信する支払いアドレス(TRC20/ERC20ウォレットアドレスなど)を監視する必要がある場合や、ユーザープロファイル分析が必要な場合は、プロフェッショナル版を直接お選びください。 プランの詳細と年間割引については、公式サイトのプランページをご覧ください。

ステップ1:TG-Staff に Bot プロジェクトを追加する(5分)

いよいよ移行を開始します。

  1. TG-Staff コンソール にアクセスし、アカウントを登録します(新規ユーザーは自動的に3日間の無料トライアルを取得)。
  2. ログイン後、左メニューの 「プロジェクト」「プロジェクトを作成」 をクリックします。
  3. プロジェクト名(例:「公式カスタマーサービス」)を入力し、Bot Token フィールドに BotFather からコピーしたトークンを貼り付けます。
  4. 保存 をクリックします。システムが自動的にトークンの有効性を検証し、接続状態が「接続済み」と表示されます。
  5. Bot が正常に応答するかテストします:あなたの Bot に任意のメッセージを送信すると、TG-Staff コンソールにその会話がリアルタイムで表示されるはずです。

注意:この時点では、あなたの Bot はまだ Echo TG で動作しており、TG-Staff はバックアップ接続として機能します。ユーザーメッセージは Echo TG と TG-Staff の両方で受信されますが、Echo TG の Webhook を手動で無効化した後にのみ、TG-Staff が唯一の処理側になります。この操作はステップ4で行います。

ステップ2:基本的なカスタマーサービスフローを設定する(10分)

このステップで、チームはすぐに顧客対応できるようになります。中心となるのは、会話振り分けルールの設定、エージェントアカウントの作成、ウェルカムメッセージの設定です。

会話振り分けルールの設定(ラウンドロビン vs オンライン優先)

TG-Staff コンソールで 「プロジェクト設定」「会話振り分け」 に進み、振り分けモードを選択します:

  • ラウンドロビン(デフォルト):新しい会話を、権限を持つすべてのエージェントに順番に割り当てます。メッセージ量が均一で、エージェントのスキルが同等のチームに適しています。例えば3人のエージェントの場合、最初の会話はエージェントA、次はB、その次はC、そして再びAに割り当てられます。
  • オンライン優先:現在オンラインのエージェントに優先的に割り当て、全員がオフラインの場合のみラウンドロビンに戻ります。ピーク時に迅速な応答が必要なシナリオに適していますが、オンラインのエージェントがより多くの会話を担当する可能性があることに注意してください。

推奨:チームのエージェント数が少なく(3~5人)、シフトが固定されている場合は「ラウンドロビン」で十分です。エージェントのシフトが頻繁に入れ替わったり、オンライン状態が頻繁に変わる場合は、「オンライン優先」の方が柔軟です。

チームメンバーを招待し、エージェント権限を割り当てる

  1. 「エージェント管理」「エージェントを作成」 に進みます。
  2. エージェントの名前とメールアドレス(ログイン用)を入力します。
  3. プロジェクト権限を設定します:「すべてのプロジェクト」または「指定プロジェクト」(チームに複数の Bot プロジェクトがある場合)。
  4. 保存 をクリックします。システムがログインリンクを生成し、エージェントに送信します。
  5. エージェントはそのリンクからパスワードを設定し、TG-Staff コンソール にログインして顧客対応を開始できます。

ベストプラクティス:まず1名のエージェントを招待してテスト

正式リリース前には、まず1名のエージェントを招待してエンドツーエンドテストを実施し、セッションの流れ、メッセージの送受信、翻訳機能がすべて正常に動作することを確認してから、他のメンバーを一括招待することをお勧めします。

ウェルカムメッセージと自動応答の設定

「コマンドフロー」 エディターで「ウェルカム」ノードをドラッグし、ユーザーが初めてBotにアクセスした際の挨拶メッセージを設定します。例:

欢迎来到 [你的品牌]!请选择以下服务:
/help - 帮助中心
/order - 查询订单
/contact - 联系人工客服

より複雑なマルチステップの対話(ユーザーのメールアドレス収集、問題のカテゴリ選択など)が必要な場合は、ビジュアルエディターを使用して分岐ノードを追加するだけで、コードを書く必要はありません。

ステップ3:旧Botの自動応答とコマンドの移行(5分)

次に、Echo TGの自動応答ルールとコマンドをTG-Staffに移行します。

事前にバックアップした内容を参照しながら、TG-Staffの 「コマンドフロー」 エディターで一つずつ再構築します:

Echo TGの機能TG-Staffでの対応操作
キーワード自動応答「キーワードトリガー」ノードを追加し、マッチングルールと応答内容を設定
/start コマンド「コマンド」ノードを作成し、/start をバインド、ウェルカムメッセージを設定
/help コマンド「コマンド」ノードを作成し、/help をバインド、ヘルプテキストを設定
マルチステップ対話「分岐」ノードを使用して複数のステップを連結、条件分岐をサポート
定期/一括メッセージ「メッセージ一斉送信」機能を使用し、ユーザーセグメントごとに配信(プロ版)

移行のコツ:Echo TGのルールが多い場合は、まず最もよく使う3〜5ルールを移行し、運用開始後に残りを徐々に追加することをお勧めします。

ステップ4:検証と最終確認(5分)

これが最後の、そして最も重要なステップです。以下の5項目をチェックした後、Echo TGを正式に停止できます。

最終チェックリスト

  • Botのメッセージ応答:Botにテストメッセージを送信し、TG-Staffコンソールにセッションがリアルタイム表示され、Botが正しく応答することを確認。
  • エージェントログインと対応:招待したエージェントがコンソールにログインし、テストセッションを確認でき、応答メッセージを送信できることを確認。
  • セッション割り当てが正常:複数のメッセージを送信し、振り分けルールが機能していることを確認(ラウンドロビンまたはオンライン優先で期待通りに割り当てられる)。
  • ユーザーメッセージの可視性:一般ユーザーとしてメッセージを送信し、エージェント側でメッセージが完全に表示されることを確認(画像、ファイルなどのメディアを含む)。
  • 翻訳/リスク管理機能が正常:プロ版を購入している場合、自動翻訳が機能し、コンテンツリスク管理が設定に従ってリスクワードをブロックすることを確認。

問題がないことを確認したら、Echo TGでWebhookを無効にし(通常はBot設定の「Webhookを有効にする」オプションをオフ)、TG-Staffがすべてのメッセージ処理を自動的に引き継ぎます。

よくある質問

Q:Echo TGからTG-Staffに切り替えると、ユーザーに変化が感じられますか? A: いいえ。Botのトークンとユーザー名は変わらず、ユーザーは引き続き同じBotと対話するため、移行プロセスはユーザーにとって完全に透過的です。

Q:Echo TGの過去のセッションデータをTG-Staffに移行できますか? A: 現在、TG-StaffはEcho TGの過去のセッション履歴の直接インポートをサポートしていませんが、新しいセッションは移行完了時から正常に記録されます。移行前に重要なセッション情報をスクリーンショットでバックアップすることをお勧めします。

Q:移行中にBotはオフラインになりますか? A: いいえ。Echo TGを稼働させたまま、TG-Staffで設定を完了し、最後にEcho TGのWebhookを無効にできます。プロセス全体でBotはオンラインを維持します。

Q:TG-Staffの無料トライアル期間で移行を完了できますか? A: 登録時に3日間の無料トライアルが提供され、標準版の全機能をカバーしているため、移行テストと本番移行を完了するのに十分です。

Q:移行後に問題が発生した場合、テクニカルサポートはありますか? A: TG-Staffの公式カスタマーサポートBot(@tgstaff_robot)を通じてリアルタイムのヘルプを利用できるほか、ドキュメントで詳細な設定ガイドを参照できます。

まとめと次のステップ

Echo TGからTG-Staffへの移行は複雑な手術ではなく、明確なステップを踏んだアップグレードです。30分以内に、チームはマルチエージェント協業、セッション振り分け、自動翻訳などのプロフェッショナルな機能を獲得でき、Botとユーザーは影響を受けません。

今すぐ行動を開始しましょう:

30分後、Telegramカスタマーサポート体験がまったく変わります。