Freshdeskコネクタ for Zoho DataPrep [BETA]
お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。
Zoho DataPrepは、Freshdeskからサポートチケットデータを取り込み、データ準備を行うことができます。また、Freshdeskからのヘルプデスクデータのインポートを定期的にスケジュールすることも可能です。このコネクターを利用することで、ETLワークフローの効率化、スムーズなデータ移動、FreshdeskとZoho DataPrep間のデータ統合を簡素化できます。
Freshdeskからデータをインポートする方法
1.既存のパイプラインを開くか、パイプラインを作成します。「ホーム」ページ、Pipelinesタブ、またはWorkspacesタブからアクセスし、「データを追加」オプションをクリックしてください。
ヒント: パイプラインビルダーの上部にあるデータをインポート
2. 左側のペインでIT/ヘルプデスクカテゴリーを選択し、Freshdeskをクリックします。検索ボックスでFreshdeskを検索することもできます。
メモ: 以前に接続を追加済みの場合は、必須の接続をクリックし、インポートするを続けてください。保存済み外部連携は左側のペイン内、Saved 外部連携カテゴリーからも確認できます。Saved 外部連携について詳しくは、こちらをご覧ください。
3. 保存済み外部連携からアカウントを選択するか、追加する 新規オプションを使って新規アカウントを接続します。
Freshdeskアカウントを認証する方法
4. FreshdeskアカウントのConnection 名前、Subdomain、およびAPIキーを、それぞれの項目に入力してください。
Subdomainの取得方法
a. FreshdeskアカウントのホームページURLからドメイン名を取得できます。
b. Freshdeskのカスタムドメインをお持ちの場合は、サポート。ドメイン。comと入力してください。カスタムドメインがない場合は、Subdomainにドメイン。freshdesk。comと入力します。
例: zylker。freshdesk。com
例: zylker。freshdesk。com
APIキーを取得する方法
- Freshdeskアカウントで、画面右上のプロフィール画像をクリックし、権限設定を選択します。
- APIキーを表示をクリックします。本人確認のために画像認証（CAPTCHA）の完了を求められる場合があります。
- APIキーが作成されたら、それをコピーしてZoho DataPrepのインポート画面に貼り付けてください。
5. 必要なタブを選択すると、対応する項目が表示されます。インポートしたいタブと項目を選択してください。
サポートされている合計タブの一覧は以下の通りです：
- チケット (30k)
- 連絡先
- 組織
- エージェント
- グループ
- 商品
- アンケート
- 満足度評価
- 時間記録
6. Freshdesk アカウントからデータをインポートするための設定のいずれかを選択します。
すべてのデータ - このオプションを選択すると、アカウント内のすべてのデータがインポートされます。
日付指定 - このオプションを選択すると、指定した日付から現在の日付までのデータがインポートされます。
メモ: 日付指定オプションは以下のタブで利用可能です。対応していないタブの場合は、すべてのデータがインポートされます。
- チケット
- 連絡先
- 満足度評価
- 時間エントリー
7. データのインポートが完了すると、Pipeline builderページが開き、ETLパイプラインへの変換適用を開始できます。ステージを右クリックしてデータの準備オプションを選択し、DataPrep Studioページでデータを準備することも可能です。変換の詳細はこちらをご覧ください。
スケジュール
スケジュールオプションを使用して、パイプラインの自動実行を設定できます。
スケジュール設定
1. パイプラインビルダーでScheduleオプションを選択します。
2. 繰り返し方法（毎時間、毎日、weekly、月間）を選択し、Perform 頻度ドロップダウンで頻度を設定します。 Perform 頻度ドロップダウンの設定は、選択した繰り返し方法によって変わります。こちらをクリックして詳細をご覧ください。
3. インポートしたい新規データがデータ元に見つかった時に使用するGMTを選択します。初期設定では、ローカルのタイムゾーンが選択されています。
4.スケジュールを一時停止するタイミング: このオプションでは、指定した回数分失敗した場合にスケジュールを一時停止するよう設定できます。
情報: 範囲は2から100まで設定できます。初期設定値は2です。インポート設定
インポート設定オプションを使用して、Freshdeskアカウントからデータをインポートおよび取得する方法を設定できます。下記の表で、各タブおよび対応する実行タイプごとの利用可能なインポート設定を確認してください。
メモ: パイプライン内のすべてのソースに対してインポート設定を行う必要があります。インポート設定を行わない場合、スケジュールは保存できません。
5. インポート設定を行うには、こちらをクリックリンクを選択してください。
6. データ元からデータをインポートする方法は？ドロップダウンから必須のオプションを選択します。すべてのデータをインポート、更新済みおよび新規データ、またはインポートしないから、インポートするタブに応じて選択できます。
すべてのデータをインポート
すべてのデータをインポートしたい場合は、差出人項目でデータをインポートする必要がある日付を選択してください。このオプションを選択すると、選択した日付以降の利用可能なすべてのデータがインポートされます。
メモ: 差出人 日付オプションは選択済みタブで利用可能です（上記の表を参照してください）。このオプションをサポートしていないタブでは、すべてのデータがインポートされます。
増分データ取得
更新済みおよび新規データのみ
更新済みおよび新規データを増分でインポートするには、最終インポート日時以降の 差出人、 Only 更新済みおよび新規データのみ オプションを選択してください。
ドロップダウンから選択します。
既存の data を使用（新規 data が次の値と等しくない場合のみ利用可能）:
増分インポートする時に、
- チェックボックスがオンの場合：データ元に新規 data がない場合、最後に取得済みの data が再度インポートされます。
- チェックボックスがオフの場合：データ元に新規 data がない場合、インポートする処理が失敗し、ファイルはインポートされません。その結果、パイプラインジョブ全体が失敗します。
data をインポートしない
data は一度だけインポートされます。2回目以降は、ルールが同じ data に適用され、エクスポート済みとして取得されます。
7. 保存をクリックして、data のインポートスケジュールを設定します。
メモ: すでにスケジュール差出人Freshdeskの設定を行っている場合、インポートする設定セクションに基づいて、以前の設定内容でデータが再読み込みされます。「編集スケジュール」オプションをクリックし、新しいスケジュールを設定してください。
Schedule 設定
無効な値がある場合はエクスポートを停止する: この設定を有効にすると、準備されたデータに無効な値が含まれている場合、エクスポート処理が停止します。
エクスポート順序
複数の送信先を設定している場合、このオプションを使用して、データがどの順序で各送信先にエクスポートされるかを指定できます。
無効の場合、エクスポートは初期設定の順序で実行されます。
無効の場合、エクスポートは初期設定の順序で実行されます。
メモ: このオプションは、パイプラインに2つ以上の送信先を追加している場合のみ表示されます。
エクスポート送信先の順序を並べ替えるには
1) 順番 exportsトグルをクリックします。
2) ドラッグ＆ドロップで宛先の順番を変更し、保存をクリックします。
メモ: 順番を再度並べ替えたい場合は、編集 順番リンクをクリックしてください。
8. スケジュール設定が完了したら、保存をクリックしてスケジュールを実行します。これによりパイプラインが開始されます。
各スケジュール実行はジョブとして保存されます。パイプラインがスケジュールされると、データはデータソースから取得済みとなり、各ステージで適用された一連の変換によってデータが準備されます。その後、シームレスなデータ統合により、データはエクスポート済みとなり、宛先へと送信されます。通常の間隔で処理が行われます。この完了プロセスはジョブ履歴に記録されます。
9. 特定のパイプラインのジョブ一覧に移動するには、パイプラインビルダーの
省略記号アイコンをクリックし、Job 履歴メニューを選択して、パイプラインのジョブステータスを確認します。
10. 必須の job IDをJobs 履歴ページでクリックすると、Job 概要に移動し、該当ジョブの詳細を確認できます。
Job 概要では、パイプラインフロー内で実行されたジョブの履歴が表示されます。こちらをクリックして詳細をご覧ください。
10. 必須の job IDをJobs 履歴ページでクリックすると、Job 概要に移動し、該当ジョブの詳細を確認できます。
Job 概要では、パイプラインフロー内で実行されたジョブの履歴が表示されます。こちらをクリックして詳細をご覧ください。
11. スケジュールが完了すると、ETLパイプラインで準備したデータは設定済みの宛先にエクスポートされます。
情報: できることは、Jobsページでスケジュールのステータスを後から表示することも可能です。
メモ: パイプラインに追加で変更を加えた場合、その変更は下書きバージョンとして保存されます。「下書き」オプションを選択し、パイプラインを変更反映用に設定してください。
スケジュールを設定した後は、スケジュールの一時停止やスケジュールの再開、スケジュールの編集、スケジュールの削除をパイプラインビルダー内のSchedule 有効オプションから選択できます。
スケジュールを編集し保存した場合、次のジョブは前回のスケジュール実行時刻から次回のスケジュールデータ間隔までの間に実行されます。
重要: Freshdeskを宛先として追加し、DataPrepからFreshdeskにデータをプッシュすることは、現時点ではサポートされていません。
制限事項
- チケットタブから最新30,000件までの更新済みチケットをZoho DataPrepにインポートできます。
-
更新・バックフィル・手動実行時、指定された差出人項目の日付から現在の日付・時刻までのデータがインポートされます。終了時間の設定には対応していません。
関連情報