> ## Documentation Index
> Fetch the complete documentation index at: https://domoinc-bradley-turek-pfilter-operators-reference.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/)）を参照してください。

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)」を参照してください。

## 必要条件

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)」を参照してください。

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

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

| フィールド                                     | 説明                                                                                                                                                                                                                      |
| ----------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Username                                  | Zendesk Support Connector with Upsertアカウントのログインに使用するユーザー名を入力します。                                                                                                                                                        |
| Authenticated By                          | Zendesk Support Connector with UpsertのAPIトークンまたは認証パスワードのどちらを使用するかを指定します。                                                                                                                                                |
| API Token or Password                     | Zendesk Support Connector with UpsertのAPIトークンまたはパスワードを入力します。これは［Authenticated By］メニューで選択したものと一致する****必要があります****。例えば、\*\*\*\*［API Token］****を****［Authenticated By］\*\*\*\*に選択した場合は、APIトークンをこのフィールドに入力します。パスワードではありません。 |
| Zendesk Support Connector with Upsert URL | 会社のZendesk Support Connector with UpsertインスタンスのURLを入力します。                                                                                                                                                               |

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

### ［詳細］ペイン

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

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

### その他のペイン

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

## よくある質問

<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)です。
  </Accordion>

  <Accordion title="各レポートコールによってこのコネクターで呼び出されるのはどのエンドポイントですか？">
    | レポート名                              | エンドポイントURL                               |
    | ---------------------------------- | ---------------------------------------- |
    | Brands                             | /API/v2/brands.JSON                      |
    | Organizations                      | /incremental/organizations.json          |
    | Specify Query                      | /api/v2/search/export.json               |
    | Tickets                            | /incremental/tickets.json                |
    | Ticket Activities                  | /api/v2/activities.json                  |
    | Ticket Audits                      | /ticket\_audits.json                     |
    | Ticket Fields                      | /ticket\_fields.json                     |
    | Ticket Forms - Agent Conditions    | /ticket\_forms.json                      |
    | Ticket Forms - End User Conditions | /ticket\_forms.json                      |
    | Ticket Comments                    | /tickets/{currentTicketId}/comments.json |
    | Ticket Metric Events               | /incremental/ticket\_metric\_events.json |
    | Users                              | /incremental/users.json                  |
  </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>
