> ## Documentation Index
> Fetch the complete documentation index at: https://domoinc-openapi-sync-dataflows.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Zendesk Support Connector with Upsert

## はじめに

Zendesk Support Connector with Upsertは、チケット発行、セルフサービスオプション、カスタマーサポート機能などの、クラウドベースのカスタマーサービスプログラムを提供しています。セールスチームの生産性、プロセス、パイプラインを向上させます。DomoのZendesk Support Connector with Upsertを使用すると、チケットやユーザーなどのレポートを作成できます。Zendesk Support Connector with UpsertのAPIの詳細については、ウェブサイト（ [https://developer.zendesk.com/documentation/](https://developer.zendesk.com/documentation/ "https://developer.zendesk.com/documentation/") ）を参照してください。

Zendesk Support Connector with Upsertは「クラウドApp」コネクターであるため、クラウドに保管されたデータの取得が可能です。Data Centerのウィンドウ上部のツールバーにある ****［クラウドApp］**** をクリックすると、このコネクターやほかのクラウドAppコネクターのページにアクセスできます。

Zendesk Support Connector with Upsertアカウントには、Data Centerから接続します。このトピックでは、Zendesk Support Connector with Upsertユーザーインターフェースに固有のフィールドとメニューについて説明します。DataSetの追加、更新スケジュールの設定およびDataSet情報の編集を行う方法については、「 [コネクターを使用してDataSetを追加する](/ja/s/article/360042926274 "コネクターを使用してDataSetを追加する") 」を参照してください。

## 必要条件

Zendesk Support Connector with Upsertアカウントに接続してDataSetを作成するには、以下が必要です。

* Zendesk Support Connector with Upsertアカウントのユーザー名
* Zendesk Support Connector with UpsertアカウントのAPIトークンまたはパスワード
* 会社のZendesk Support Connector with UpsertのURL

パスワードを使用するには、エージェントのEメールアドレスとパスワードを使用してAPI認証を有効化します。これは、Zendesk Support Connector with UpsertモバイルAppへのサインインで既に有効化されている可能性があります。

Zendesk Support Connector with Upsertは、エージェントのパスワードの安全性を保つため、APIトークンの使用を推奨しています。APIトークンは、Zendesk Support Connector with Upsertの ****［Admin］>［Channels］>［API］**** で表示される管理者インターフェースで管理できます。このページでは、トークンを表示、追加、または削除できます。同時に2つ以上のトークンをアクティブにすることが可能です。トークンを削除すると、永久に無効化されます。

## Zendesk Support Connector with Upsertアカウントを接続する

このセクションでは、 Zendesk Support Connector with Upsert ページの **［認証情報］** および **［詳細］** ペインのオプションについて説明します。このページのほかのペインの項目である **［スケジュール設定］** や **［DataSetに名前を付け、説明を入力］** に関しては、ほとんどのタイプのコネクターで共通しています。詳細については、「 [コネクターを使用してDataSetを追加する](/ja/s/article/360042926274 "コネクターを使用してDataSetを追加する") 」を参照してください。

### ［認証情報］ペイン

このペインには、 Zendesk Support Connector with Upsert アカウントに接続する認証情報の入力フィールドが含まれています。以下の表で、各フィールドに必要な内容を説明しています。

<table border="1" cellpadding="1" cellspacing="1" data-aura-rendered-by="33:195;a"><thead><tr><th colspan="1" rowspan="1"><p><span class="s1"> フィールド </span></p></th><th colspan="1" rowspan="1"><p><span class="s1"> 説明 </span></p></th></tr></thead><tbody><tr><td colspan="1" rowspan="1"> Username </td><td colspan="1" rowspan="1"> Zendesk Support Connector with Upsertアカウントのログインに使用するユーザー名を入力します。 </td></tr><tr><td colspan="1" rowspan="1"> Authenticated By </td><td colspan="1" rowspan="1"> Zendesk Support Connector with UpsertのAPIトークンまたは認証パスワードのどちらを使用するかを指定します。 </td></tr><tr><td colspan="1" rowspan="1"> API Token or Password </td><td colspan="1" rowspan="1"> Zendesk Support Connector with UpsertのAPIトークンまたはパスワードを入力します。これは <em><em /></em> ［Authenticated By］メニューで選択したものと一致する <b><b> 必要があります </b></b> 。例えば、 <b><b> ［API Token］ </b></b> を <b><b> ［Authenticated By］ </b></b> に選択した場合は、APIトークンをこのフィールドに入力します。パスワードではありません。 </td></tr><tr><td colspan="1" rowspan="1"> Zendesk Support Connector with Upsert URL </td><td colspan="1" rowspan="1"> 会社のZendesk Support Connector with UpsertインスタンスのURLを入力します。 </td></tr></tbody></table>

有効な Zendesk Support Connector with Upsert 認証情報を一度入力しておくと、同じアカウントを使用して随時、新しい Zendesk Support Connector with Upsert を作成できます。コネクターアカウントは、Data Centerの **［アカウント］** タブで管理できます。このタブの詳細については、「 [コネクターのユーザーアカウントを管理する](/ja/s/article/360042926054 "コネクターのユーザーアカウントを管理する") 」を参照してください。

### ［詳細］ペイン

このペインには、メインとなる **［Report］** メニューのほか、選択したレポートタイプに応じて表示/非表示になる様々なメニューが含まれています。

<table border="1" cellpadding="1" cellspacing="1" data-aura-rendered-by="33:195;a"><thead><tr><th colspan="1" rowspan="1"><p> メニュー </p></th><th colspan="1" rowspan="1"><p> 説明 </p></th></tr></thead><tbody><tr><td colspan="1" rowspan="1"><p> Report </p></td><td colspan="1" rowspan="1"><p> 実行したいZendesk Support Connector with Upsertレポートを選択します。以下のレポートが利用できます。 </p><table border="1" cellpadding="1" cellspacing="1"><tbody><tr><td colspan="1" rowspan="1"><b> レポート名 </b></td><td colspan="1" rowspan="1"><b> 説明 </b></td></tr><tr><td colspan="1" rowspan="1"><p> Brands </p></td><td colspan="1" rowspan="1"> 自分のアカウントの全てのブランドを名前でソートしてリストにして取得します。 </td></tr><tr><td colspan="1" rowspan="1"> Organizations </td><td colspan="1" rowspan="1"> Zendesk Support Connector with Upsertのインスタンス内の組織に関する情報を取得します。 </td></tr><tr><td colspan="1" rowspan="1"> Specify Query </td><td colspan="1" rowspan="1"> Zendesk Support Connector with Upsert検索クエリを入力することにより、カスタマイズされたレポートを作成できるようになります。 <b> ［Open Tickets］ </b> と <b> ［Closed Tickets］ </b> の2つの既製クエリから選択することもできます。これらは、Zendesk Support Connector with Upsertのインスタンスに対するオープン/クローズドチケットの番号を返すために使用できます。 <br /> Zendesk Support Connector with Upsertのクエリに入力する方法の詳細については、 <a href="https://support.zendesk.com/hc/ja/articles/4408886879258-Zendesk-Support%E6%A4%9C%E7%B4%A2%E3%83%AA%E3%83%95%E3%82%A1%E3%83%AC%E3%83%B3%E3%82%B9" target="_blank" title="Zendesk Support検索リファレンス"> こちら </a> を参照してください。 </td></tr><tr><td colspan="1" rowspan="1"> Tickets </td><td colspan="1" rowspan="1"> 作成および更新されたチケットに関する情報を取得します。 </td></tr><tr><td colspan="1" rowspan="1"><p> Ticket Activities </p></td><td colspan="1" rowspan="1"> 過去30日間のリクエストを行ったエージェントに影響する、チケットアクティビティのリストを取得します。 </td></tr><tr><td colspan="1" rowspan="1"> Ticket Audits </td><td colspan="1" rowspan="1"> チケットの監査のリストを取得します。 </td></tr><tr><td colspan="1" rowspan="1"><span> Ticket Fields </span></td><td colspan="1" rowspan="1"><span> Zendesk Support Connector with Upsertインスタンスでチケットフィールドを取得します。 </span></td></tr><tr><td colspan="1" rowspan="1"><span> Ticket Forms - Agent Conditions </span></td><td colspan="1" rowspan="1"><span> Zendesk Support Connector with Upsertインスタンスでチケットフォームを取得し、エージェントワークプレイスのための条件セットを表示します。 </span></td></tr><tr><td colspan="1" rowspan="1"><span> Ticket Forms - End User Conditions </span></td><td colspan="1" rowspan="1"><span> Zendesk Support Connector with Upsertインスタンスでチケットフォームを取得し、エンドユーザー製品のための条件セットを表示します。 </span></td></tr><tr><td colspan="1" rowspan="1"> Ticket Comments </td><td colspan="1" rowspan="1"> チケットのコメントを取得します。 </td></tr><tr><td colspan="1" rowspan="1"> Ticket Metric Events </td><td colspan="1" rowspan="1"> チケットのメトリクスイベントを取得します。 </td></tr><tr><td colspan="1" rowspan="1"> Users </td><td colspan="1" rowspan="1"> Zendesk Support Connector with Upsertのインスタンス内のユーザーに関する情報を取得します。 </td></tr></tbody></table></td></tr><tr><td colspan="1" rowspan="1"> Associated Data </td><td colspan="1" rowspan="1"> チケットと一緒に読み込む関連データを選択します。 </td></tr><tr><td colspan="1" rowspan="1"> Include Attachments </td><td colspan="1" rowspan="1"> 結果に添付ファイルを含めるかどうかを指定します。 </td></tr><tr><td colspan="1" rowspan="1"><span> Select the date to start retrieving data on the first run. Subsequent runs will automatically retrieve newly created and updated tickets, users or organizations </span></td><td colspan="1" rowspan="1"><span> 最初の実行時に、データの取得を開始する日付を選択します。次回の実行では、新規作成および更新されたアイテムが自動的に取得されます。最初の実行後に日付を変更すると、この日付は次回の実行に使用され、既存のデータが置き換えられます。 </span></td></tr><tr><td colspan="1" rowspan="1"> Date Selection </td><td colspan="1" rowspan="1"> 最初の実行時に、データの取得を開始する日付を選択します。次回の実行では、新規作成および更新されたチケット、ユーザーまたは組織が自動的に取得されます。 </td></tr><tr><td colspan="1" rowspan="1"> Single Date </td><td colspan="1" rowspan="1"> レポートのデータが特定の日付か、今日から何日前までのものかを選択します。 </td></tr><tr><td colspan="1" rowspan="1"> Specific Date </td><td colspan="1" rowspan="1"> 日付セレクターを使用して特定の日付を選択します。 </td></tr><tr><td colspan="1" rowspan="1"> Relative Date </td><td colspan="1" rowspan="1"> 何日前に遡ってデータを取得したいか、 <b><b> ［Days Back］ </b></b> フィールドに日数を入力します。今日を指定するにはtodayまたは0、昨日ならyesterdayまたは1、過去7日間のデータを取得するにはtoday-7または7と指定します。 </td></tr><tr><td colspan="1" rowspan="1"> Legacy Schema Selection </td><td colspan="1" rowspan="1"> このチェックボックスを選択すると、既存のスキーマを使用してZendesk Support Connector with Upsertコネクターとの後方互換性が確保されます。 </td></tr><tr><td colspan="1" rowspan="1"> Exclude Deleted Records </td><td colspan="1" rowspan="1"> データから削除したレコードを除外するには、このチェックボックスを選択します。 </td></tr></tbody></table>

### その他のペイン

スケジュール設定、再試行、更新に関するオプションなど、コネクターインターフェースのその他のペインに表示されるオプションについては、「 [データコネクターを使用してDataSetを追加する](/ja/s/article/360042926274 "コネクターを使用してDataSetを追加する") 」を参照してください。

## よくある質問

<AccordionGroup>
  <Accordion title="このコネクターのベースURLはどのエンドポイントですか？">
    Zendesk Support Connector with UpsertコネクターのベースURLは、 [https://\{subdomain}.Zendesk Support Connector with Upsert.com/api/v2](https://%7Bsubdomain%7D.zendesk.com/api/v2 "https://\{subdomain}.zendesk.com/api/v2") です。
  </Accordion>

  <Accordion title="各レポートコールによってこのコネクターで呼び出されるのはどのエンドポイントですか？">
    <table data-aura-rendered-by="33:195;a"><tbody><tr><th colspan="1" rowspan="1" width="30%"> レポート名 </th><th colspan="1" rowspan="1" width="70%"> エンドポイントURL </th></tr><tr><td colspan="1" rowspan="1"> Brands </td><td colspan="1" rowspan="1"> /API/v2/brands.JSON </td></tr><tr><td colspan="1" rowspan="1"> Organizations </td><td colspan="1" rowspan="1"> /incremental/organizations.json </td></tr><tr><td colspan="1" rowspan="1"> Specify Query </td><td colspan="1" rowspan="1"> /api/v2/search/export.json </td></tr><tr><td colspan="1" rowspan="1"> Tickets </td><td colspan="1" rowspan="1"> /incremental/tickets.json </td></tr><tr><td colspan="1" rowspan="1"><p> Ticket Activities </p></td><td colspan="1" rowspan="1"> /api/v2/activities.json </td></tr><tr><td colspan="1" rowspan="1"> Ticket Audits </td><td colspan="1" rowspan="1"> /ticket\_audits.json </td></tr><tr><td colspan="1" rowspan="1"> Ticket Fields </td><td colspan="1" rowspan="1"> /ticket\_fields.json </td></tr><tr><td colspan="1" rowspan="1"> Ticket Forms - Agent Conditions </td><td colspan="1" rowspan="1"> /ticket\_forms.json </td></tr><tr><td colspan="1" rowspan="1"> Ticket Forms - End User Conditions </td><td colspan="1" rowspan="1"> /ticket\_forms.json </td></tr><tr><td colspan="1" rowspan="1"> Ticket Comments </td><td colspan="1" rowspan="1"> /tickets/\{currentTicketId}/comments.json </td></tr><tr><td colspan="1" rowspan="1"> Ticket Metric Events </td><td colspan="1" rowspan="1"> /incremental/ticket\_metric\_events.json </td></tr><tr><td colspan="1" rowspan="1"> Users </td><td colspan="1" rowspan="1"> /incremental/users.json </td></tr></tbody></table>
  </Accordion>

  <Accordion title="このコネクターを作成するにはどのような認証情報が必要ですか？">
    Zendesk Support Connector with Upsertのユーザー名、パスワードまたはAPIトークン、およびZendesk Support Connector with UpsertのインスタンスURLが必要です。このコネクターに使用するZendesk Support Connector with Upsertは、Zendesk Support Connector with Upsert内の管理者である必要があります。
  </Accordion>

  <Accordion title="データはどれくらいの頻度で更新されますか？">
    必要に応じた頻度で行われます。
  </Accordion>

  <Accordion title="注意すべきAPI制限はありますか？">
    いいえ。
  </Accordion>

  <Accordion title="同じZendesk Support Connector with Upsertアカウントを使用して複数のDataSetを作成することはできますか？">
    はい。
  </Accordion>

  <Accordion title="Zendesk Support Connector with UpsertとZendesk Support Connector with Upsertコネクターの違いは何ですか？">
    Zendesk Support Connector with Upsertは、DataSetを更新するためのAppend関数とReplace関数に加えて、Merge関数をサポートしています。Merge関数は、更新された行をすべて置き換え、新しい行を追加します。これにより、重複エントリを避けることができます。

    Zendesk Support Connector with Upsertは、DataSetを更新するためのAppend関数とReplace関数をサポートしています。
  </Accordion>
</AccordionGroup>
