OnlyTG Echo から TG-Staff への移行完全チェックリスト：Bot、トーク、一斉送信、オペレーター、分流リンク

OnlyTG Echo を使用して Telegram Bot カスタマーサポートを管理しているが、チーム規模の拡大に伴いオペレーターの協力の限界、ユーザー帰属追跡の不足、またはコンプライアンス内部統制の問題に直面している場合、TG-Staff への移行を検討する価値があります。このチェックリストでは、OnlyTG Echo から TG-Staff への移行の完全なプロセスを段階的に説明します。Bot の接続、トークの再構築、一斉送信データの移行、オペレーター設定、分流リンクの構成をカバーし、チームが最短時間でスムーズに移行し、データ損失やサービス中断を回避できるようにします。

なぜ OnlyTG Echo から TG-Staff に移行するのか？—— コア機能の比較

移行を始める前に、移行による実際のメリットを明確にしましょう。OnlyTG Echo は単一 Bot の自動応答シナリオでは安定していますが、ビジネスに複数人での協力サポート、マルチチャネルからの集客帰属、またはコンプライアンス内部統制が必要になると、機能の限界が現れます。

機能次元	OnlyTG Echo	TG-Staff
オペレーター管理	通常は単一アカウント操作、独立したオペレーターポータルなし	独立したオペレーターアカウントで Web ポータルにログイン、3/5/20 のオペレーター枠をサポート
セッション振り分け	高度な振り分けルールなし	ラウンドロビンとオンライン優先の2つの振り分け戦略をサポート
分流リンク（帰属）	訪問者情報を取得する組み込み短縮リンクなし	公式ドメインの短縮リンクを提供、IP、ブラウザ、UTM パラメータをキャプチャ可能
コンテンツリスク管理	なし	プロフェッショナル版ではメッセージ前のリスクワード検出、暗号ウォレットアドレス監視を含む
自動翻訳	基本版では制限あり	スタンダード版には AI 翻訳、プロフェッショナル版では Google、DeepL プロ翻訳をサポート
一斉送信機能	サードパーティツールに依存する可能性あり	内蔵一斉送信、ユーザーセグメント化をサポート
マルチプロジェクト管理	限定的	プランに応じて複数の Bot プロジェクトをサポート

移行のコアメリット: 単一操作からチーム協力へ → 受動的な応答から能動的な帰属へ → 管理なしからコンプライアンス内部統制へ。以下のシナリオに直面している場合、移行は価値があります：

• チームに2人以上が同時に Bot の問い合わせを処理し、セッション転送と協力機能が必要。
• 広告配信で UTM パラメータを使用してコンバージョンを追跡し、分流リンクによる帰属が必要。
• ビジネスが暗号通貨やセンシティブな分野に関連し、オペレーターのメッセージ内のウォレットアドレスを監視する必要がある。

移行前の準備作業：アカウント、データ、チームの調整

移行成功の鍵は準備段階にあります。このステップを飛ばさないでください。

OnlyTG Echo の重要なデータをバックアップ

TG-Staff で設定を再構築する前に、OnlyTG Echo から以下のデータをエクスポートします：

• Bot Token: BotFather から取得するか、OnlyTG Echo の設定からコピーします。注意: Token は最高機密であり、漏洩しないようにしてください。
• トークテンプレート: ウェルカムメッセージ、メニューボタン、マルチターン対話のテキストと条件ロジックを含みます。スクリーンショットを撮るか、プレーンテキストとしてエクスポートします。
• 一斉送信ユーザー ID リスト: OnlyTG Echo がエクスポートをサポートしている場合、すべてのユーザー ID またはセグメントごとにエクスポートします。重要: TG の一斉送信では、ユーザーが Bot にメッセージを送信したことがある必要があるため、リストが有効であることを確認してください。
• オペレーターリストと権限: 各オペレーターのユーザー名、メールアドレス、担当 Bot プロジェクトを記録します。
• ユーザープロファイルタグ: OnlyTG Echo でタグが付与されている場合、タグ名と関連ユーザー ID をエクスポートします。

TG-Staff に登録し、プランを確認

1. https://app.tg-staff.com/ にアクセスしてアカウントを登録すると、自動的に 3 日間の無料トライアルが利用できます。
2. チーム規模に応じてプランを選択します：
   • スタンダード版（約 $8.99/月）：2～3 人のチームに適しており、分流リンク、セッション振り分け、3 つのオペレーター枠を含みます。
   • プロフェッショナル版（約 $16.99/月）：5 人以上のチームに適しており、コンテンツリスク管理（ウォレットアドレス監視を含む）、無制限翻訳、ユーザープロファイルなどの高度な機能を追加で提供します。
3. チームが複数の Bot を同時に管理する必要がある場合、プランがサポートするプロジェクト数を確認してください。具体的な価格は公式サイトのプランページを参照してください。

第一歩：Bot 移行 — Telegram Bot API への接続

これは最も重要なステップであり、移行の成否を直接左右します。

TG-Staff コンソールに Bot を追加する

1. TG-Staff コンソールにログイン → 「新規プロジェクト」をクリック。
2. Bot トークン（BotFather から取得。形式は 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11）を入力します。
3. システムが自動的にトークンの有効性を検証し、Bot 名と説明を同期します。コンソール上で Bot のアイコン、名前、説明を直接編集することも可能で、BotFather に移動する必要はありません。
4. OnlyTG Echo で複数の Bot を管理している場合は、各 Bot に対して上記の手順を繰り返してプロジェクトを作成します。

Bot の機能を検証する

追加が完了したら、テストアカウントで Bot にメッセージを送信し、以下を確認します。

• メッセージが TG-Staff のリアルタイムチャット画面に表示されること。
• ウェルカムメッセージを設定している場合（次のステップで行います）、正常にトリガーされること。
• オペレーターが返信した際、ユーザー側で正しく受信されること。

OnlyTG Echo にカスタムキーボードやインラインボタンがある場合は、TG-Staff で再構築する必要があります（次のステップを参照）。

ステップ2：トークスクリプトとコマンドフローの再構築

OnlyTG Echo のトークスクリプト（ウェルカムメッセージ、メニュー、マルチターン会話）は自動的に TG-Staff に移行できません。TG-Staff のビジュアルコマンドフローエディターを使用して再構築する必要があります。

1. コンソールでプロジェクトに移動 → 「コマンドフロー」をクリックします。
2. ノードをキャンバスにドラッグし、ウェルカムメッセージのテキスト、ボタンテキスト、およびジャンプロジックを設定します。
3. OnlyTG Echo に複数ステップのインタラクション（例：ユーザー情報の収集 → 確認送信 → 有人対応）がある場合は、同じロジックで複数のノードを作成し、接続します。
4. フローを保存して公開し、テストアカウントで再度 Bot をトリガーし、各ステップが期待通りに実行されるか検証します。

ヒント：TG-Staff のフローエディターはノーコードで、プログラミング経験のない運用担当者でも操作できます。簡単なシナリオ（ウェルカムメッセージ＋メニューなど）から始め、徐々に複雑さを増やすことをお勧めします。

ステップ3：一斉送信データの移行とユーザーセグメント化

一斉送信は運用において重要なツールです。移行手順は以下の通りです。

1. 事前にバックアップしたユーザーIDリストをプレーンテキスト形式（1行に1ユーザーID）に整理します。
2. TG-Staff コンソール → 「一斉送信」機能で、「一斉送信を作成」をクリックします。
3. 対象ユーザーセグメント（例：「全ユーザー」またはカスタムセグメント）を選択します。OnlyTG Echo にタグがある場合は、TG-Staff で対応するセグメントを手動で作成し、ユーザーIDをインポートできます。
4. メッセージ内容を作成します（テキスト、画像、ボタンなどの形式に対応）。
5. まず 50～100 人のユーザーで小規模テストを実施し、送信成功率とメッセージスタイルに問題がないことを確認してから、全量一斉送信を実行することをお勧めします。

注意：Telegram は Bot の一斉送信にレート制限（約30件/秒）を設けていますが、TG-Staff にはリスク回避のためのレート制限ロジックが組み込まれています。ユーザー数が多い場合（10万人超）は、バッチに分けて送信することをお勧めします。

ステップ4：オペレーター設定と会話振り分け設定

これは TG-Staff が OnlyTG Echo に比べて持つ中核的な優位性、すなわち複数人でのカスタマーサポートです。

オペレーターアカウントと権限の作成

1. コンソール → 「オペレーター管理」で「オペレーターを追加」をクリックします。
2. オペレーターのメールアドレスまたはユーザー名を入力すると、招待リンクが送信されます。
3. 各オペレーターにプロジェクト権限を割り当てます（特定の Bot の会話のみ表示、または全 Bot を表示など）。
4. オペレーターは独立した Web ポータル（https://app.tg-staff.com/）にログインします。アカウントとパスワードを共有する必要はありません。

振り分けルールの設定とテスト

1. プロジェクト設定 → 「会話振り分け」に移動します。
2. 振り分けルールを選択します。
   • 順番割り当て：権限のあるオペレーターを順番に割り当てます。負荷が均等な日常的なシナリオに適しています。
   • オンライン優先：現在オンラインのオペレーターに優先的に割り当てます。問い合わせが集中する時間帯に迅速な対応が必要な場合に適しています。
3. カスタマーサポート範囲を設定します。「全オペレーター」または「指定オペレーター」（例：上級オペレーターのみ複雑な問題に対応）を選択できます。
4. 複数のテストアカウントで Bot にメッセージを送信し、会話がルールに従って異なるオペレーターに割り当てられるか観察します。オペレーターがオンラインでない場合、システムはキューイングするか、順番割り当てにフォールバックします。

注意：OnlyTG Echo のオペレーターは TG-Staff に直接移行できません。各オペレーターは新たにアカウントを登録する必要があります。移行前にオペレーターチームにメールアドレスまたはユーザー名を用意するよう通知することをお勧めします。

ステップ5：分流リンクの移行と広告アトリビューションの再構築

OnlyTG Echo でショートリンクトラッキングのような機能を使用していた場合、TG-Staff の分流リンク（Diversion Link） はより強力なアトリビューション機能を提供します。

1. コンソール → 「分流リンク」で新しいリンクを作成します。
2. 元の URL（通常は Bot の t.me リンク）を入力すると、https://app.tg-staff.com/{code} 形式のショートリンクが生成されます。
3. トラッキングパラメータをバインドします。リンクの末尾に ?utm_source=facebook&campaign_id=123 などのカスタムパラメータを追加すると、システムが自動的に訪問者の IP、ブラウザ情報、URL パラメータをキャプチャします。
4. 生成されたショートリンクで、広告、SNS、メール内の元のリンクを置き換えます。

テスト手順：分流リンクをクリック → Botに自動遷移 → メッセージ送信 → オペレーター側でユーザープロファイルに情報源が表示されるか確認。すべて正常なら、分流アトリビューションの連携が再構築完了です。

移行後のチェックリストとよくある問題のトラブルシューティング

上記の手順を完了したら、以下のチェックリストを使用してすべての工程が正常であることを確認してください：

• Bot応答正常：ユーザーがメッセージを送信後、オペレーター側にリアルタイム表示される。
• トークフロー正確：ウェルカムメッセージ、メニュー、マルチターン会話が期待通りに実行される。
• オペレーターログイン正常：各オペレーターが個別アカウントでWebポータルにログインできる。
• セッション分流有効：メッセージがルールに従って正しいオペレーターに割り当てられ、漏れや誤割り当てがない。
• 一斉送信テスト合格：小規模な一斉送信が成功し、送信失敗や重複送信がない。
• 分流リンクの遷移正確：ショートリンククリック後Botに遷移し、ユーザープロファイルに情報源が表示される。
• 自動翻訳（ある場合）正常：オペレーターがメッセージ送信後、ユーザー側に翻訳された内容が表示される。
• コンテンツリスク管理（プロフェッショナル版）正常：オペレーターがリスクワードを含むメッセージを送信した際、再確認またはブロックがトリガーされる。

よくある問題のトラブルシューティング：

問題	考えられる原因	解決策
Bot応答なし	トークン無効またはBot停止	BotFatherからトークンを再取得、TG-Staffでトークンが正しいか確認
一斉送信失敗	ユーザーID無効またはTelegramのレート制限	ユーザーID形式が正しいことを確認、分割送信（1回1000件）
分流が機能しない	ルール設定ミスまたはオペレーターオフライン	分流ルールが「オンライン優先」か確認、オペレーターがログインしているか確認
分流リンクが404	リンク期限切れまたはプロジェクト削除	分流リンクを再生成し、古いリンクを置き換え

よくある質問

Q：OnlyTG Echoのデータ（ユーザープロファイル、チャット履歴など）は自動的にTG-Staffにインポートできますか？

A： TG-Staffは現在、OnlyTG Echoからの自動データインポートをサポートしていません。移行前にユーザーIDリスト、トークテンプレート、オペレーター名簿を手動でエクスポートし、コンソールから再設定することをお勧めします。チャット履歴は移行できませんが、Bot接続後の新しいセッションは正常に表示されます。

Q：移行中、Telegram Botはサービスを中断しますか？

A： 短い切り替えウィンドウが発生します。オフピーク時に行うことをお勧めします：まずOnlyTG EchoでBot応答を一時停止し、次にTG-Staffで同じBotトークンを追加してアクティブ化します。通常5～10分で完了します。事前にユーザーにメンテナンス時間を通知することをお勧めします。

Q：TG-Staffは複数のBotを同時に管理できますか？OnlyTG Echoとの違いは？

A： はい、可能です。TG-Staffはプランに応じて異なる数のBotプロジェクトをサポートします（スタンダード版とプロフェッショナル版の具体的な数は公式サイト参照）。OnlyTG Echoと比較して、TG-Staffはより柔軟なマルチオペレーター協力、分流ルール（順番/オンライン優先）、分流リンクアトリビューション機能を提供し、複数Botを運用するチームに適しています。

Q：移行後、既存の一斉送信リストや送信頻度に影響がありますか？

A： 一斉送信リストはTG-Staffに再インポートする必要があります。TG-Staffのバルク一斉送信機能はユーザーセグメントごとの送信をサポートし、レート制限が組み込まれています（Telegram公式制限に準拠）。移行後はまず小規模テスト（例：50～100件のメッセージ）を行い、送信成功率を確認してから全量一斉送信を実行することをお勧めします。

Q：私はOnlyTG Echoの有料ユーザーですが、TG-Staffに移行することで同じかそれ以上の機能を得られますか？

A： 選択するプランによります。TG-Staffスタンダード版（約8.99/月）にはリアルタイム双方向チャット、セッション分流、分流リンクなどのコア機能が含まれています。プロフェッショナル版（約16.99/月）にはさらにコンテンツリスク管理（暗号ウォレットアドレス監視含む）、無制限翻訳、ユーザープロファイルなどの高度な機能が含まれています。3日間のトライアル期間を利用して比較テストし、ニーズを満たしていることを確認してからサブスクライブすることをお勧めします。

---

今すぐ移行を開始：TG-Staffの3日間無料トライアルに登録 → https://app.tg-staff.com/

詳細な操作ガイドを入手：TG-Staffドキュメントを参照 → https://docs.tg-staff.com/

移行中に問題が発生しましたか？ カスタマーサポートBotに連絡 → @tgstaff_robot