メインコンテンツにスキップ

CSVインポートで予測を上書きする

CSVのアップロード方法を学び、Intercomの予測を上書きする方法、ファイルのフォーマット、既存予測のエクスポート、上書きの削除方法を説明します。

対応者:Dawn Perrott

予測はチームのライブ会話履歴から自動的に作成され、ボリュームFinが独自にフィルタリングされます。予測に反映されていない情報(例:今後のキャンペーン、季節的なピーク)がある場合は、CSVファイルをアップロードして上書きできます。

注意:

  • CSVインポートは現在、予測に独自の数値を取り込む唯一の方法です(現時点でAPIインポートはありません)。

  • 各上書きはファイル内の時間帯にのみ適用され、Intercomの将来予測の計算方法は変更しません。

  • 上書きは予測が計算されるたびに適用されるため、常に最新の数値を反映します。別途保存され同期がずれることはありません。

  • Workforce ManagementはProアドオンに含まれています。

現在ExcelやGoogle Sheetsで予測している場合は、既存の予測のフォーマットを調整してCSVとしてインポートできます。これにより、信頼している数値をIntercomの予測で確認でき、スタッフ計算やチームスケジュール作成の参考にできます。


予測上書きのCSVインポート方法

  1. Workforce > Forecastに移動します。

  2. ページヘッダー右上のImport forecastをクリックします。

  3. Import forecastダイアログで、.csvファイルをドラッグ&ドロップするか、クリックして選択します。

  4. Importをクリックします。

    ForecastページのImport forecastダイアログには、予測上書きの.csvファイル(5,000行制限)をアップロードするプロンプト、例のダウンロードリンク、ファイルをドラッグ&ドロップまたは参照するためのAdd fileボタンがあります。

インポート完了後、何件の上書きがインポートされたかを示すトースト(例:「12件の予測上書きをインポートしました。」)が表示され、Forecastページはインポートした日付範囲、ワークストリーム、チャネルに切り替わり結果を確認できます。

注意:行はまとめて検証されます。ファイル内にエラーがある行があればインポートは失敗します。エラーを修正して再アップロードしてください。


CSVの正しいフォーマット方法

ファイルには以下の6つの列ヘッダーが必要で、順序は問いません(ヘッダーは大文字小文字を区別せず、余分な空白は削除されます):

列

入力内容

workstream

既存のワークストリームの正確な名前

channel

Email、Chat、Android App、またはiOS Appのいずれか(大文字小文字を含め正確に記述)

timezone

全時間単位のオフセットを持つIANAタイムゾーン(例:America/New_York、Europe/London)

start

上書き開始日時(MM/dd/yyyy HH:mm形式、例:01/20/2025 09:00)

end

上書き終了日時(開始と同じ形式)

conversations_per_hour

その時間帯の会話数:0以上の数値。小数も可。

休業日など全くボリュームがない場合は0を使用してください。

ファイルの例がわからない場合は、Import forecastダイアログでdownload an exampleをクリックしてテンプレートを入手してください。例は過去の日付を使用しているため、インポート前に未来の日付に変更してください。

検証ルール

重要:すべての行が以下のルールに従わないとインポートは失敗し、何も取り込まれません。

  • 開始と終了は正確に時間単位でなければなりません(分は00)。

  • 終了は開始より後でなければなりません。

  • 開始は未来でなければなりません。過去の日付は不可です。

  • timezoneは全時間単位のオフセットでなければなりません。Asia/KolkataやAsia/Kathmanduのような30分または45分のオフセットはサポートされていません。空欄の場合は失敗せずUTCがデフォルトになります。

  • 各行は独自のタイムゾーンを設定します。ファイル全体の単一タイムゾーン設定はありません。

  • インポートした行が既存の同じワークストリームとチャネルの上書きと重複する場合、既存の上書きは削除され置き換えられます。これは既存上書きの行がカバーしていない時間帯も含みます。

必須列が欠けている、10MBを超える、.csvでない、データ行が全くない場合は、行処理前にインポート全体が拒否されます。何が問題かのメッセージが表示されます(例:「必須列が欠けています:…」)。

ファイルは最大5,000行までです。予測が大きい場合は複数ファイルに分割して順にインポートしてください。

注意:conversations_per_hourはその時間の正確な値を設定し、既存予測に対して割合を加算するものではありません。成長率(例:+10%)を適用したい場合は、現在の予測をエクスポートし、スプレッドシートで調整後に再インポートしてください。


現在の予測をエクスポートする方法

既存の予測をCSVとしてエクスポートすることもできます。これはインポート時のテンプレートとして便利です。

  1. Workforce > Forecastに移動し、エクスポートしたいワークストリーム、チャネル、日付範囲を設定します。日付範囲は最大31日までです。

  2. Volumeタブを選択し、Export forecastをクリック、概要を確認してからExport CSVをクリックします。

注意:日付範囲が31日を超える場合、タイムゾーンが全時間単位でない場合、またはエクスポートする予測データがない場合はエクスポートできません。CSVはページに表示されているタイムゾーンでエクスポートされます。5,000行を超える場合は、単一ファイルでの再インポート不可の警告が表示されます。


すべての予測上書きを削除する方法

Import forecastをクリックし、ダイアログ左下の⋯(オプション)メニューを開き、Delete existing importsを選択します。メニューには上書き数が表示され(例:「Delete existing imports (12)」)、上書きがない場合は選択不可です。Delete allをクリックして確定します。

重要:これによりすべての予測上書きが一度に削除され、元に戻せません。


よくある質問

予測上書きCSVの一部の行にエラーがあるとどうなりますか?

行はまとめて検証されます。エラーがある行があればインポートは失敗します。ファイルのエラーを修正して再アップロードしてください。

予測上書きCSVが行処理前に拒否される理由は?

必須列が欠けている、10MBを超える、.csvでない、データ行が全くない場合は、行処理前にインポート全体が拒否されます。何が問題かのメッセージが表示されます(例:「必須列が欠けています:…」)。

予測上書きCSVインポートの行数制限はありますか?

はい。1回のインポートで最大5,000行までです。予測が大きい場合は複数ファイルに分割してください。

API経由で予測上書きをインポートできますか?

まだできません。現在、CSVインポートが予測に独自の数値を取り込む唯一の方法です。

conversations_per_hourは既存の予測に加算されますか、それとも置き換えですか?

置き換えです。conversations_per_hourはその時間の正確な値を設定し、既存予測に割合を加算するものではありません。

予測上書きに成長率(例:+10%)を適用するには?

まず現在の予測をエクスポートし、スプレッドシートで調整後に再インポートしてください。

予測上書きCSVでタイムゾーンが受け入れられないのはなぜですか?

timezone列は全時間単位のオフセットを持つIANAタイムゾーンが必要です。Asia/KolkataやAsia/Kathmanduのような30分または45分のオフセットはサポートされていません。空欄の場合は失敗せずUTCがデフォルトになります。

予測上書きCSVのstartとendはどの日時形式を使うべきですか?

両方ともMM/dd/yyyy HH:mm形式(例:01/20/2025 09:00)で、正確に時間単位(分は00)である必要があります。

予測上書きCSVの例テンプレートはどこで入手できますか?

Import forecastダイアログでdownload an exampleをクリックするとテンプレートが入手できます。例は過去の日付なので、インポート前に未来の日付に変更してください。

なぜ現在の予測をエクスポートできないのですか?

日付範囲が31日を超える場合、タイムゾーンが全時間単位でない場合、またはエクスポートする予測データがない場合はエクスポートできません。

すべての予測上書き削除を元に戻せますか?

いいえ。すべての予測上書きを一度に削除し、元に戻せません。

予測上書きを過去の日付にできますか?

いいえ。開始は未来でなければなりません。過去の日付は不可です。

こちらの回答で解決しましたか?