TG Bot と TG-Staff 統合実践ガイド：Telegram Bot を Web オペレーターワークスペースに接続する

もし Telegram Bot を運営していて、それに有人カスタマーサポートを導入したいなら、tg bot と TG-Staff の統合は検討に値する選択肢です。TG-Staff は Telegram Bot 向けのカスタマーサポート・運営 SaaS プラットフォームで、Bot の管理、チームコラボレーション、会話の振り分け、トラフィック分析を一つの Web コンソールに統合します。この記事では、ゼロから登録、設定、本番運用までの完全な手順を解説します。

なぜ TG Bot を TG-Staff ワークスペースに接続する必要があるのか？

手順に入る前に、根本的な疑問に答えましょう：なぜ Bot の API やサードパーティのボットだけでカスタマーサポートを管理できないのでしょうか？

従来の Bot カスタマーサポートの三大ボトルネック

• 一人一台のデバイス、チームコラボレーション不可：Telegram ネイティブ Bot のメッセージは一つのアカウントでしか処理できません。チームで複数のユーザーを同時に対応する必要がある場合、同じアカウントに交代でログインするか、ユーザーを待たせるしかなく、体験が悪いです。
• 会話の引き継ぎとユーザートラッキング機能の欠如：会話キューや割り当て記録がありません。あるオペレーターが一時的にオフラインになると、ユーザーのメッセージはそのまま放置され、自動的に他のオペレーターに転送されません。
• 運営データの蓄積が困難：各ユーザーがどのチャネルから来たのか、何回のやり取りをしたのか、コンバージョン率はどうかが分かりません。広告のアトリビューション分析は不可能です。

TG-Staff がこれらの問題をどう解決するか

• Web コンソールで複数オペレーターが同時に対応：各オペレーターは独立したアカウントを持ち、Web ポータルにログインして Telegram ユーザーの会話をリアルタイムで処理できます。会話の転送、割り当て記録、コラボレーションメモをサポート。
• 分流リンクで広告アトリビューションを実現：TG-Staff が提供する短縮リンクにより、訪問者の IP、ブラウザ情報、URL パラメータ（utm_source など）を取得できます。広告 → 分流リンク → Bot 自動応答 → 有人オペレーター対応という、完全なコンバージョン経路を形成します。
• ユーザープロファイルと統計で運営判断を支援：Pro 版ではユーザープロファイルと会話統計を提供し、ユーザーのアクティブ時間帯、よく使う言語、会話時間を把握でき、サービス戦略の最適化に役立ちます。

準備：必要な条件は？

統合を始める前に、以下の条件を満たしていることを確認してください：

1. BotFather で作成した Telegram Bot があり、完全な HTTP API トークン（形式：123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11）を保有していること。
2. TG-Staff アカウント：app.tg-staff.com にアクセスして登録。登録後、3日間の無料トライアルが利用可能。
3. プランの選択：無料トライアル期間中は Standard 版の全機能を体験可能。チームが3名以上のオペレーター、またはコンテンツモデレーションや無制限翻訳などの機能が必要な場合は、Pro 版を推奨。プラン料金は公式プランページをご確認ください。
4. Bot のプライバシーモードが無効であること：BotFather で /setprivacy を送信し、該当 Bot を選択して Disable に設定。これをしないと、Bot は / で始まらないユーザーメッセージを受信できません。

第一步：在 TG-Staff 控制台创建项目并连接 Bot

登录 app.tg-staff.com，进入控制台首页。

1. 点击左侧菜单「项目」，然后点击「创建项目」。
2. 为项目命名（例如「官方客服 Bot」），然后输入你的 Bot Token。
3. 点击「连接」。系统会验证 Token 有效性，并自动拉取 Bot 的名称和头像。
4. 连接成功后，你可以在项目详情页看到 Bot 的在线状态和最近消息记录。

连接完成后，TG-Staff 会自动开始接收所有用户消息。此时你的 Bot 已经具备了多坐席接入的能力，只是还没有分配坐席。

第二步：配置坐席与团队权限

添加坐席的两种方式

• 手动添加：在「坐席管理」页面，点击「添加坐席」，输入坐席的 Telegram 用户名或邮箱，设置初始密码。系统会自动生成一个登录账号。
• 邀请链接：在坐席管理页面生成一个邀请链接，发送给团队成员。对方点击链接后自行注册并绑定 Telegram ID，自动成为坐席。

权限分配最佳实践

TG-Staff 支持按项目配置坐席的操作范围。以下是典型的角色权限配置：

角色	典型权限	适用场景
管理员	所有项目、所有操作（包括坐席管理、套餐管理）	团队负责人或技术维护
客服	指定项目的会话接待、用户画像查看	一线客服人员
运营	指定项目的会话接待、分流链接管理、群发消息	负责流量投放和用户触达的运营

建议：不要给所有坐席分配管理员权限。如果某个坐席只需要处理客户咨询，就只给他分配对应项目的「客服」角色。这样可以避免误操作，比如误删项目配置或修改套餐。

第三步：设置会话分流与分流链接

会话分流决定了新用户消息如何分配给坐席。TG-Staff 提供两种分流规则：

• 轮流分配（默认）：按顺序轮询有权限的坐席，确保每个人接待量大致均衡。
• 在线优先：优先分配给当前在线的坐席。如果所有坐席都离线，则回退到轮流分配。

在项目设置中找到「会话分流」，选择你需要的规则，然后指定客服范围（「全部客服」或「指定客服」）。

生成分流链接

分流链接是 TG-Staff 的特色功能之一，用于将外部流量（广告、社媒帖子）引导至你的 Bot，并自动触发人工坐席接待。操作步骤如下：

1. 在项目设置中点击「分流链接」。
2. 点击「生成链接」，系统会创建一个类似 https://app.tg-staff.com/abc123 的短链。
3. 将此链接嵌入到你的广告、社交媒体帖子或网站落地页中。
4. 当用户点击该链接时，系统会自动捕获 IP、浏览器信息和 URL 参数，然后跳转到你的 Bot 并发送一条预设消息（如「您好，有什么可以帮您？」）。
5. 该会话会自动进入队列，由分流规则分配给在线坐席。

第4ステップ：ビジュアルコマンドフローで自動応答を構築

有人オペレーターが介入する前に、Botはよくある質問に対応できる必要があります。TG-Staffはドラッグ＆ドロップ式のフローエディターを提供しており、コードを書かずにウェルカムメッセージ、メニュー、マルチステップの対話を構築できます。

1. 「コマンドフロー」モジュールに入り、「新規フロー」をクリックします。
2. 左側から「ウェルカムメッセージ」ノードをキャンバスにドラッグし、送信内容を編集します（例：「公式カスタマーサービスへようこそ。数字を入力してサービスを選択してください：1. 製品問い合わせ 2. アフターサポート 3. 有人オペレーターへ」）。
3. 「メニュー」ノードをドラッグし、ボタンオプションを設定します。各ボタンは別のフローノードを指すか、有人オペレーターへの転送をトリガーできます。
4. 「有人オペレーターへ転送」ノードをドラッグし、転送時の自動メッセージを設定します（例：「有人オペレーターにおつなぎしています。しばらくお待ちください……」）。
5. フローを保存して公開します。以降、すべての新規ユーザーはまずこの自動フローを経由し、有人オペレーターへの転送を選択するか特定のキーワードを入力した場合のみ有人キューに入ります。

ベストプラクティス：すべてのロジックを自動フローに詰め込まないでください。複雑な問題や緊急の場合は、できるだけ早くユーザーを有人キューに入れ、待たせて離脱されるのを防ぎましょう。

第5ステップ：本番テストと運用チェックリスト

統合が完了したら、以下のチェックリストに従って全リンクのテストを実施することをお勧めします。

• Bot接続テスト：Telegramで自分のBotにメッセージを送信し、コンソールの「メッセージログ」にリアルタイムで表示されることを確認します。
• オペレーターログインテスト：オペレーターアカウントでWebコンソールにログインし、セッションが表示され返信できることを確認します。
• セッション振り分けテスト：2人のオペレーターを同時にオンラインにし、2通目のメッセージを送信して割り当てルール（順番またはオンライン優先）が機能することを確認します。
• 振り分けリンクテスト：プライベートブラウザで振り分けリンクをクリックし、Botに遷移して事前設定されたメッセージが自動送信されることを確認します。その後、コンソールでセッションの属性情報（IP、ブラウザ、URLパラメータ）を確認します。
• 自動翻訳テスト：翻訳が有効な場合、非中国語でメッセージを送信し、オペレーター側に翻訳されたテキストが表示されることを確認します。
• コンテンツ管理テスト（プロ版）：リスクワードが設定されている場合、キーワードを含むメッセージを送信し、オペレーター側でポップアップまたはブロックが発生することを確認します。

よくある質問

Q：Bot接続時にTokenが無効と表示される場合は？ A：BotFatherから取得したHTTP API Tokenが完全であること（形式：123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11）、余分なスペースがないことを確認してください。それでも無効な場合、BotFatherで/revokeしてから再生成してみてください。

Q：オペレーターがログインしてもセッションが表示されない場合の対処法は？ A：以下の3点を確認してください。①オペレーターアカウントにプロジェクトの権限が割り当てられているか。②セッション振り分けルールにそのオペレーターが含まれているか。③Botが新しいユーザーメッセージを受信しているか（コンソールのメッセージログで確認）。

Q：振り分けリンクはGoogle Adsのトラッキングに使えますか？ A：はい。振り分けリンクは自動で訪問者のIP、ブラウザ情報、URLパラメータ（utm_sourceなど）を取得します。コンソールで各セッションの属性情報を確認でき、広告効果の分析に利用できます。

Q：無料トライアル期間中はすべての機能を使えますか？ A：はい。登録後3日間の無料トライアルが提供され、期間中はスタンダード版の全機能（振り分けリンクとオペレーター含む）をお試しいただけます。期間終了後も利用するには、プランを選択して継続課金する必要があります。

Q：既存のBotのユーザーデータをTG-Staffに移行するには？ A：TG-Staffではユーザーデータの移行は不要です。Bot Tokenをコンソールに接続するだけで、新しいメッセージは自動的にシステムに入力されます。過去のメッセージはBot APIのgetUpdatesメソッドで手動取得できますが、新しいセッションから記録を開始することをお勧めします。

まとめと次のアクション

上記5つのステップにより、あなたのtg botはTG-Staffの統合コンソールに正常に接続されました。これで、チームはWebワークスペースでカスタマーサービスセッションを共同処理し、振り分けリンクで広告コンバージョンを追跡し、ビジュアルフローで自動応答を実現できます。統合プロセス全体でコードを書く必要はなく、コンソールでの設定のみで完了します。

次のステップとして、以下をお勧めします：

• app.tg-staff.com をクリックして3日間の無料トライアルを開始し、全機能をお試しください。
• 公式ドキュメント を参照して、より高度な設定（カスタムコマンド、データエクスポートなど）を学んでください。
• 問題が発生した場合は、@tgstaff_robot に直接連絡して、1対1のテクニカルサポートを受けてください。