Telegram Bot カスタマーサービスセッションを Google Sheets にエクスポートするチュートリアル：シンプルな運用ダッシュボードの構築

Telegram Bot カスタマーサービスシステムを運用する際、セッションデータは Bot 管理画面、Telegram グループ、チームメンバーの個人チャット履歴に散在し、全体像を把握するのが難しいものです。Telegram Bot カスタマーサービスのデータを Google Sheets にエクスポートすることで、軽量な運用ダッシュボードを迅速に構築し、ユーザーソース、セッション量のトレンド、エージェントの効率を追跡できます。この記事では TG-Staff を例に、トラフィック分析からレポート構築までの完全な流れを詳しく解説します。B2B SaaS、Web3、クロスボーダーチームに適しています。

なぜ Telegram Bot カスタマーサービスのデータを Google Sheets にエクスポートする必要があるのか？

カスタマーサービス運用ダッシュボードのよくある課題

• データの断片化：ユーザーソース（広告、コミュニティ、公式サイト）とセッション記録が異なる場所に分散し、コンバージョンファネルを統一的に分析できません。
• レポートツールが重すぎる：CRM や BI ツールは中小チームにとって学習コストが高く、メンテナンスが複雑です。ほとんどのチームはいくつかの主要指標を見るだけで十分です。
• 手動集計の非効率性：毎日手動でメッセージ数や応答時間を集計するのは時間がかかり、エラーも発生しやすいです。

Google Sheets が軽量レポートツールとして優れている理由

• ゼロコストで始められる：Google アカウントがあればすぐに利用でき、追加費用は不要です。
• 柔軟性が高い：QUERY、FILTER、PIVOT などの関数をサポートし、グラフ機能と組み合わせてトレンドグラフや円グラフを迅速に生成できます。
• コラボレーションと共有：チームメンバーが同時に編集でき、リモートチームに適しています。
• 自動化の可能性：Google Apps Script を使用して定期的にデータを取得し、ほぼリアルタイムの更新が可能です。

事前準備：必要なツールと権限

開始する前に、以下の条件が満たされていることを確認してください：

• TG-Staff コンソールアカウント：登録は app.tg-staff.com から、3日間無料トライアル。
• 接続済みの Telegram Bot プロジェクト：少なくとも1つの Bot が TG-Staff で設定され、稼働していること。
• Google アカウント：Google Sheets にアクセスするため。
• プランの確認：スタンダードプラン以上で、分流リンクとセッションエクスポート機能をサポート（無料トライアル期間中は基本エクスポートを体験可能）。
• （オプション）分流リンク：トラフィック分析を行う場合は、スタンダードプランが必要です。

ステップ 1：分流リンクでユーザーソースデータを取得する

分流リンク（Diversion Link）は TG-Staff が提供する公式ドメインの短縮リンク（例：https://app.tg-staff.com/{code}）です。ユーザーがこのリンクをクリックすると、自動的にあなたの Telegram Bot にリダイレクトされ、同時に以下の情報が取得されます：

• 訪問者の IP アドレス
• ブラウザの User-Agent
• URL パラメータ（例：utm_source、campaign、medium）

操作手順：

1. TG-Staff コンソールにログインし、「分流リンク」モジュールに移動します。
2. 「分流リンクを作成」をクリックし、対象の Bot プロジェクトを選択します。
3. 「URL パラメータ」にトラッキングパラメータを追加します。例：
   • utm_source=twitter
   • utm_campaign=product_launch
4. 生成された短縮リンクを広告、ソーシャルメディアの投稿、または公式サイトのボタンに埋め込みます。
5. ユーザーがクリックすると Bot にリダイレクトされ、カスタマーサービスのフローに入ります。ソースデータは自動的にセッション詳細に記録されます。

分流リンクはトラフィック分析の核となるツールです。後で Google Sheets にエクスポートする際、これらのフィールドは独立した列として表示され、異なるチャネルのコンバージョン効果を分析するのに役立ちます。

ステップ2：セッション振り分けルールを設定し、データの完全性を確保する

セッション振り分けルールは、ユーザーのメッセージをどのようにオペレーターに割り当てるかを決定します。ルールの設定が不適切だと、一部のセッションが記録されず（例：全オペレーターがオフラインの場合にメッセージが消失する）、エクスポートデータの完全性に影響を及ぼします。

推奨設定：

• プロジェクトレベルの振り分けルール：「オンライン優先」モードを選択します。オンラインのオペレーターがいる場合、セッションは優先的にオンラインオペレーターに割り当てられます。全員がオフラインの場合は「順番割り当て」にフォールバックし、各セッションに必ずオペレーターが担当するようにします。
• カスタマーサポート範囲：チームに複数人がいる場合、「全カスタマーサポート」を選択し、新しいセッションが見落とされないようにします。
• タイムアウト処理：適切なオペレーター応答タイムアウト時間（例：5分）を設定し、タイムアウト後に自動的に再割り当てします。

この設定により、TG-Staffは各セッションに対して、割り当て記録、転送履歴、メッセージタイムスタンプを含む完全なレコードを生成し、エクスポート時に欠落が発生しません。

ステップ3：セッション履歴とユーザープロファイルデータをエクスポートする

コンソールからエクスポート

1. TG-Staffコンソールで「セッション」または「データエクスポート」モジュールに移動します。
2. エクスポートする期間（例：過去30日間）を選択します。
3. 「CSVをエクスポート」をクリックすると、以下のフィールドを含むファイルが生成されます。

フィールド	説明	プラン制限
セッションID	一意識別子	全プラン
ユーザーTelegram ID	ユーザーの一意識別子	全プラン
セッション開始/終了時刻	秒単位	全プラン
メッセージ総数	双方のメッセージ合計	全プラン
オペレーター担当者	セッションを処理したオペレーター名	全プラン
振り分け元URLパラメータ	utm_source、campaignなど	スタンダード版以上
ユーザータグ	オペレーターが手動で追加したタグ	プロフェッショナル版
アクティビティスコア	ユーザーのエンゲージメント指標	プロフェッショナル版

API経由でのエクスポート（技術チーム向け）

TG-StaffはAPIを提供しており、プログラムでセッションデータを取得できます。定期的に自動同期が必要なチームに適しています。

// 示例：使用 fetch 调用 API 获取会话列表
fetch('https://api.tg-staff.com/v1/conversations?limit=100', {
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY'
  }
})
.then(res => res.json())
.then(data => console.log(data));

APIはJSON形式のデータを返すため、Google Apps Scriptで直接解析し、Sheetsに書き込むことができます。

ステップ4：データをGoogle Sheetsにインポートし、クレンジングする

1. Google Sheetsを開き、新しいワークシートを作成します。
2. 「ファイル」→「インポート」→「アップロード」を選択し、先ほどエクスポートしたCSVファイルを選択します。
3. インポート後、データクレンジングを実施します。

よく使うクレンジング操作：

• 重複排除：=UNIQUE(A:A)を使用して重複セッションIDを削除します。
• タイムスタンプのフォーマット：タイムスタンプがUnix形式の場合、=TEXT(A2/86400 + DATE(1970,1,1), "yyyy-mm-dd hh:mm:ss")を使用して変換します。
• 日付の抽出：=DATE(YEAR(B2), MONTH(B2), DAY(B2))を使用してセッション日付を抽出し、日次集計を容易にします。
• ソースの分類：振り分けリンクパラメータにutm_sourceが含まれている場合、=IF(ISNUMBER(SEARCH("twitter", C2)), "Twitter", "其他")を使用して分類します。

ステップ5：簡易運用ダッシュボードの構築

主要指標と対応する計算式

指標	計算式例	グラフの種類
1日あたりのセッション数	=COUNTIF(日期列, 今天日期)	折れ線グラフ
流入元チャネル分布	=COUNTIF(来源列, "Twitter") など	円グラフ
平均応答時間	=AVERAGE(响应时间列)	単一値カード
オペレーターの作業量	=COUNTIF(坐席列, "张三")	棒グラフ
セッション完了率	=COUNTIF(状态列, "已关闭")/COUNTA(状态列)	パーセンテージゲージ

構築手順：

1. 新しいワークシートを作成し、「ダッシュボード」と名付けます。
2. =QUERY(清洗后数据!A:Z, "select A, count(B) group by A label count(B) ''") を使用してデータを集計します。
3. 集計結果を選択し、グラフを挿入します（トレンド表示には折れ線グラフ、割合表示には円グラフを推奨）。
4. データ検証のドロップダウンメニューを追加し、ダッシュボードで日付範囲やチャネルによるフィルタリングを可能にします。

データからアクションへ：ダッシュボードを活用したカスタマーサービスプロセスの最適化

• 流入元分析：Twitterからのセッションのコンバージョン率が他のチャネルより明らかに高い場合、そのチャネルの広告予算を増やしましょう。
• ピーク時間帯：1日あたりのセッション数の折れ線グラフから、毎週火曜日の午後が問い合わせのピークであることがわかれば、より多くのオペレーターを配置できます。
• オペレーター効率：特定のオペレーターの平均応答時間がチーム平均より明らかに長い場合、トレーニングやワークフローの調整が必要かもしれません。
• 会話タグ：プロフェッショナル版でエクスポートされるユーザータグは、頻出の問題タイプを特定し、FAQやボットの自動応答を優先的に最適化するのに役立ちます。

よくある質問

Q：TG-Staff からエクスポートされるデータにはどのようなフィールドが含まれますか？
A： 基本エクスポートには、セッションID、ユーザーのTelegram ID、セッション開始/終了時刻、メッセージ総数、割り当てられたオペレーター、流入元URLパラメータ（utm_sourceなど）が含まれます。プロフェッショナル版では、ユーザータグ、アクティビティスコア、会話タグが追加されます。

Q：データをGoogle Sheetsにリアルタイムで同期できますか？
A： 現在、TG-Staffは手動でのCSVエクスポートまたはAPI経由でのデータ取得をサポートしており、Google Apps Scriptと組み合わせることで準リアルタイム同期（15分ごと）が可能です。リアルタイムダッシュボードが必要な場合は、BIツールをAPIに接続することをお勧めします。

Q：無料トライアル版でもデータをエクスポートできますか？
A： 3日間の無料トライアル期間中にエクスポート機能をお試しいただけますが、エクスポート可能なフィールドはプランによって制限されます（流入リンクのアトリビューションと完全なセッション記録をサポートするのはスタンダード版以上です）。

Q：流入リンクのアトリビューションデータはGoogle Sheetsでどのように活用できますか？
A： SheetsでPIVOTやCOUNTIF関数を使用して、異なるutm_sourceからのセッション数を集計し、コンバージョン率（流入リンクから有人オペレーター対応への比率など）を計算できます。

Q：データエクスポートにはユーザーのプライバシー情報が含まれますか？
A： エクスポートされるユーザーデータは、Telegramの公開情報（ユーザーID、ニックネームなど）とセッション内で送信されたメッセージ内容のみです。GDPRなどのプライバシー規制を遵守し、機密フィールドはマスキング処理することをお勧めします。

---

Telegram Bot カスタマーサービスデータのGoogle Sheetsへのエクスポートの完全な流れを実際に体験したい場合は、TG-Staff 無料トライアルに登録することをお勧めします。3日間で流入リンクとセッションエクスポート機能をテストできます。ご質問があれば、@tgstaff_robot または 公式ドキュメント をご確認ください。