OnlyTGまたはTeleformからTG-Staffへの移行：Bot、ブロードキャスト、エージェント、分流リンクの統合ガイド

チームがOnlyTGやTeleformを使用してTelegram Botのカスタマーサポートとブロードキャストを運用しているものの、エージェントのコラボレーション効率の低さ、内部統制メカニズムの欠如、分流機能の単一性といった機能的なボトルネックを感じ始めているなら、より完全なプラットフォームへの移行は合理的な次のステップです。TG-Staffは、Bot管理、エージェントセッション、分流リンク、コンテンツリスク管理、一斉配信を1つのコンソールに統合し、リモートカスタマーサポート、多言語サポート、コンプライアンス内部統制を必要とするB2B SaaSチームに最適です。

この記事は、OnlyTG Teleform移行統合ガイドであり、Botのバインドからエージェント設定、ブロードキャスト移行から内部統制設定までの完全なプロセスをカバーします。OnlyTGから移行する場合もTeleformから移行する場合も、コアとなる手順は同じであり、すべての操作はTG-Staffの無料トライアルで検証できます。

OnlyTGまたはTeleformからTG-Staffに移行する理由

OnlyTGとTeleformは、初期段階で多くのチームがTelegram Botのカスタマーサポートを迅速に構築するのに役立ちましたが、ビジネスが拡大するにつれて、いくつかの一般的な課題が明らかになり始めました。

• エージェントコラボレーションの弱さ：OnlyTGのエージェント機能は基本的であり、複数のエージェントが同時に異なるセッションを処理したり、セッションの転送やメモのコラボレーションを実現したりすることはできません。Teleformはフォーム収集に偏っており、カスタマーサポートシナリオでのサポートは限られています。
• 分流能力の不足：両方とも、柔軟なセッション分流ルール（例：ラウンドロビン割り当て、オンライン優先）が不足しており、広告アトリビューション用の短縮リンク（分流リンク）も提供していません。
• 内部統制の欠如：Web3、暗号通貨、取引所などのチームでは、エージェントが誤ってウォレットアドレスや不適切なコンテンツを送信することは高リスクの行動です。OnlyTGとTeleformにはコンテンツリスク管理機能がありません。
• マルチプロジェクト管理の分散：複数のBotを異なるプラットフォームやプロジェクト間で切り替える必要があり、統一されたデータ統計やユーザープロファイルが欠けています。

TG-Staffはこれらの機能を1つのコンソールに統合します：リアルタイム双方向チャット、エージェントアカウント管理、セッション分流、分流リンク、ビジュアルコマンドフロー、一斉配信、自動翻訳、コンテンツリスク管理（暗号通貨ウォレットアドレス監視を含む）、およびStripe/USDTサブスクリプション支払い。OnlyTGまたはTeleformからの移行は、基本的に分散したツールを1つのプラットフォームに統一し、切り替えコストを削減すると同時に、内部統制とデータ機能を獲得することを意味します。

移行前の準備：チェックリストと重要な確認ポイント

移行は一度きりの操作ではなく、事前に材料を準備し、権限を確認する必要があります。以下のチェックリストは、開始前に項目ごとに確認することをお勧めします。

項目	説明	注意事項
Bot Token	BotFatherから取得またはリセット	Tokenが期限切れでないことを確認；旧プラットフォームでまだ使用中の場合は、新プラットフォームでテストバインドしてから取り消す
ユーザーデータ	OnlyTG/Teleformのユーザーリスト、履歴セッション、グループ情報	CSVまたはJSONとしてエクスポート；ID形式の互換性に注意
ブロードキャストテンプレート	よく使うブロードキャストメッセージ、ウェルカムメッセージ、コマンド設定	テキストファイルに整理し、後でTG-Staffのビジュアルフローで再構築することを推奨
エージェントリスト	現在のエージェントのメールアドレス、役割、権限範囲	移行後、TG-Staffでエージェントアカウントを再作成する必要あり
分流リンク	旧プラットフォームの短縮リンクまたはリダイレクトリンク	移行後、TG-Staffが生成する新しいリンクに置き換える必要あり
内部統制ルール	既存のリスクワードリスト、監視ルール	TG-Staffプロフェッショナル版で再設定可能

Bot Token の取得と権限確認

1. Telegram を開き、@BotFather を検索します。
2. /mybots と入力し、あなたの Bot を選択します。
3. API Token をクリックし、Token 文字列をコピーします。Token が漏洩した場合やリセットが必要な場合は、Revoke current token をクリックして新しい Token を生成します。
4. BotFather で Bot の Inline Mode が有効（必要な場合）になっていること、および Group Privacy が Disabled（Bot がグループメッセージを読み取る必要がある場合）に設定されていることを確認します。

Token は Bot の「パスワード」です。公開しないでください。TG-Staff が Token をバインドすると、メッセージ送受信の権限が自動的に構成され、追加設定は不要です。

既存データのエクスポートとクリーンアップ

• OnlyTG ユーザー：OnlyTG コンソールでユーザーリスト（通常は CSV）をエクスポートします。ユーザーID、ユーザー名、初回インタラクション時間が含まれます。OnlyTG のユーザーID には余分なプレフィックスが含まれる場合があるため、インポート前にクリーンアップが必要です。
• Teleform データ：Teleform のレスポンスデータは、フォーム設定から CSV または Excel としてエクスポートできます。アクティブなユーザー（直近 30 日間でインタラクションのあるユーザー）のみを残し、無効なデータを減らすことをお勧めします。
• コマンドとウェルカムメッセージ：OnlyTG/Teleform のコマンド設定とウェルカムメッセージテキストをスクリーンショットまたはコピーします。TG-Staff のビジュアルコマンドフローはドラッグ＆ドロップで構築でき、コードは不要です。

ステップ 1：TG-Staff でプロジェクトを作成し、Bot をバインドする

準備が完了したら、TG-Staff コンソールにアクセスして Bot のバインドを開始します。全体の所要時間は約 5 分で、開発知識は一切不要です。

プロジェクト作成と Bot Token のバインド

1. https://app.tg-staff.com/ にアクセスし、アカウントを登録します（3 日間無料トライアル）。
2. ログイン後、新規プロジェクト をクリックし、プロジェクト名を入力します（例：「カスタマーサポートメイン Bot」）。
3. Bot Token フィールドに BotFather からコピーした Token を貼り付けます。
4. 検証 をクリックすると、TG-Staff が自動的に Token の有効性を確認し、Bot を接続します。
5. 検証が成功すると、「Bot 接続成功」と表示されます。これで Bot はメッセージを受信できるようになります。

検証に失敗した場合、Token が完全にコピーされているか、BotFather でリセットされていないかを確認してください。元のプラットフォームをまだ使用している場合は、まず TG-Staff でバインドしてテストし、送受信が正常であることを確認してから旧プラットフォームを解除することをお勧めします。

Bot プロフィールの編集（BotFather 不要）

TG-Staff コンソール内で直接 Bot のアイコン、名前、説明を変更できます。BotFather にアクセスする必要はありません。プロジェクト設定で Bot プロフィール エリアを見つけてください：

• アイコン：PNG/JPG 画像をアップロードします。512×512 ピクセルを推奨します。
• 名前：Telegram に表示される Bot の名前を変更します。
• 説明：Bot の「概要」テキスト（ユーザーが Bot のプロフィールをクリックしたときに表示される）を編集します。

変更後、保存をクリックすると、TG-Staff が自動的に Telegram API を呼び出して更新します。追加操作は不要です。

ステップ 2：ブロードキャストテンプレートとメッセージ一斉送信の移行

ブロードキャストはカスタマーサポートと運用の中核です。OnlyTG や Teleform からブロードキャストテンプレートを移行するには、次の手順をお勧めします：

1. テンプレートを整理：元のプラットフォームのブロードキャスト履歴、ウェルカムメッセージ、通知テンプレートをテキストファイルにコピーします。元のプラットフォームがブロードキャスト記録のエクスポートをサポートしている場合は、それもエクスポートします。
2. TG-Staff で再構築：コンソールで ビジュアルコマンドフロー に入り、「メッセージ送信」ノードをドラッグし、テンプレートの内容を貼り付けます。テキスト、ボタン（Inline Keyboard）、Markdown 形式に対応しています。
3. テストブロードキャスト：まずテスト Bot で送信し、形式（Markdown リンク、ボタンジャンプなど）が正しいことを確認します。
4. セグメントごとに送信：メッセージ一斉送信 モジュールで、ユーザーセグメント（例：「直近 7 日間のアクティブユーザー」「VIP ユーザー」）を選択し、テンプレートを選択して送信をクリックします。

ステップ3：エージェントと会話振り分けの設定

複数エージェントチームでは、各エージェントが独立したアカウントを持ち、会話が自動的に適切な担当者に割り当てられるようにする必要があります。TG-Staff のエージェントと会話振り分けの設定は以下の通りです。

エージェントアカウントの作成と権限割り当て

1. コントロールパネルで エージェント管理 → エージェント追加 に進みます。
2. エージェントのログインメールアドレスとパスワードを入力します（または招待リンクによる登録を選択）。
3. 権限設定 で、当該エージェントが操作可能なプロジェクト（例：「カスタマーサポートメインBot」のみ）と機能範囲（例：会話の表示のみ、会話の転送可、コマンド編集可）を選択します。
4. 保存をクリックすると、エージェントにログインメールが送信されます（またはリンクから直接ログイン）。

エージェント数はプランに応じて制限されます：無料トライアルは3エージェント、スタンダード版は3/5エージェント、プロフェッショナル版は20エージェントまで対応。詳細は公式サイトのプランページをご覧ください。

振り分けルールと振り分けリンクの設定

• 振り分けルール：プロジェクト設定 → 会話振り分け で戦略を選択します：
  • ラウンドロビン（デフォルト）：権限のあるエージェントを順番に割り当てます。エージェント数が固定のチームに適しています。
  • オンライン優先：オンラインのエージェントに優先的に割り当てます。全エージェントがオフラインの場合、ラウンドロビンにフォールバックします。エージェントのシフトが固定されていないチームに適しています。
• 振り分けリンク（Diversion Link）：振り分けリンク モジュールで リンクを生成 をクリックし、対象プロジェクトを選択します。TG-Staff は https://app.tg-staff.com/{code} 形式の短いリンクを生成します。このリンクを広告やソーシャルメディアの旧リンクと置き換えると、ユーザーがクリックした際にまず TG-Staff のキャプチャページ（IP、ブラウザ情報、URLパラメータを記録）にアクセスし、その後Botにリダイレクトされて会話が開始されます。

ステップ4：内部統制設定とコンテンツ管理（プロフェッショナル版）

Web3、仮想通貨、取引所、またはコンプライアンス上の内部統制が必要なチームにとって、コンテンツ管理は移行後に欠かせないステップです。TG-Staff プロフェッショナル版は内部統制管理機能を提供し、リスクワードを設定してエージェントが送信するメッセージを監視できます。

1. コントロールパネルで 内部統制管理 → リスクワード に進みます。
2. 新規ワード作成 をクリックし、ワード名（例：「送金先アドレス監視」）を入力します。
3. ワードにキーワードを追加します：例として TRC20 アドレスプレフィックス（T で始まる）、ERC20 アドレスプレフィックス（0x で始まる）、または特定のウォレットアドレス断片。
4. 関連プロジェクト で監視対象のBotを選択します。
5. トリガーアクションを設定：「ポップアップで再確認」または「送信をブロック」を選択します。
6. 保存後、当該プロジェクトのエージェントがメッセージを送信する際、コンテンツがリスクワードに該当すると、システムがポップアップで警告するか、送信をブロックします。すべてのトリガー記録は トリガーログ で確認でき、エージェント、会話、トリガー時間、リスクワードが含まれます。

内部統制管理は、エージェントが誤って送金先アドレス、機密リンク、または違反コンテンツを送信するのを防ぐ必要があるシナリオに適しています。無料トライアルとスタンダード版にはこの機能は含まれず、プロフェッショナル版ユーザーはすぐに有効化できます。

移行後の検証とチームトレーニング

すべての設定が完了したら、以下のチェックリストに従って各項目を検証し、移行に漏れがないことを確認することをお勧めします：

チームトレーニングのアドバイス：

• エージェントにWebチャット画面に慣れてもらう：メッセージの送信、ユーザー情報の確認、メモの使用（プロフェッショナル版）。
• 会話転送操作を説明する：会話詳細で「転送」をクリックし、転送先のエージェントを選択。
• 内部統制ルールを強調する：どのような内容が監視対象となるかをエージェントに伝え、誤操作を防ぐ。

よくある質問

Q：OnlyTGからTG-Staffに移行する際、Bot Tokenを再申請する必要がありますか？
A：不要です。BotFatherでトークンが有効であることを確認し、TG-Staffのコンソールに直接入力するだけです。元のプラットフォームをまだ使用している場合は、新しいプラットフォームでバインドとテストを完了してから、古いプラットフォームを無効にすることをお勧めします。

Q：TeleformのブロードキャストテンプレートはTG-Staffに直接インポートできますか？
A：TG-Staffは現時点でブロードキャストテンプレートのワンクリックインポートに対応していません。テンプレートの内容をビジュアルコマンドフローにコピーして再構築するか、テキストファイルを使用して手動でコピーしてください。複雑なテンプレートについては、@tgstaff_robot に問い合わせてサポートを受けてください。

Q：移行中にユーザーのメッセージは失われますか？
A：いいえ。移行中も旧プラットフォームのBotは稼働しており、TG-Staffがトークンをバインドすると新しいメッセージの受信を開始します。オフピーク時に切り替え、旧プラットフォームを24時間バックアップとして保持することをお勧めします。

Q：移行後もダイバージョンリンク（Diversion Link）は使用できますか？
A：旧プラットフォームのショートリンクは再生成が必要です。TG-Staffが提供するダイバージョンリンクは https://app.tg-staff.com/{code} 形式で生成されるため、広告やSNSの古いリンクを置き換える必要があります。

Q：無料トライアル期間中に移行テストを完了できますか？
A：はい。登録後3日間の無料トライアルが利用でき、1つのBot、最大3人のエージェント、基本機能がサポートされるため、単一Botの移行テストに十分です。複数のBotやプロフェッショナル版機能が必要な場合は、スタンダード版またはプロフェッショナル版プランをご購入ください。

---

次のステップ

• 今すぐTG-Staffの無料トライアルに登録：https://app.tg-staff.com/
• 完全なドキュメントを確認：https://docs.tg-staff.com/
• 移行に関する問題が発生した場合は、カスタマーサポートBotにお問い合わせください：@tgstaff_robot