Zendeskでは、チケットやユーザー、組織など、カスタマーのデータを保存および処理するためのさまざまなタイプのネイティブデータオブジェクトが提供されますが、これらを「標準オブジェクト」と呼んでいます。しかし、標準オブジェクトは、組織が必要とする可能性のあるすべてのタイプのデータオブジェクトを提供できるわけではありません。管理者はカスタムオブジェクトを作成して、標準オブジェクトに収まらないデータを取得することができます。カスタムオブジェクトでZendeskデータモデルを拡張することで、カスタムデータをチケット、トリガ、Explore分析にシームレスに統合することができます。
カスタムオブジェクトを作成するには、実際のオブジェクトを作成し、カスタムフィールドでスキーマを定義し、オブジェクトを関連するオブジェクトに接続し、エージェントにカスタムオブジェクトのレコードへのアクセスを許可する必要があります。ワークフローでは、トリガでカスタムオブジェクトを参照させることもできます。
カスタムオブジェクトを作成する
技術的には、カスタムオブジェクトは、名前、キー、およびフィールドで構成されています。名前とキーはオブジェクトを識別するために使用され、フィールドはオブジェクトの属性のスキーマを作成します。スキーマには、オブジェクトの特定のインスタンスに関する情報は含まれていません。スキーマには、このタイプのオブジェクトに対して収集できる情報が記載されています。カスタムオブジェクトの作成は監査ログに記録されます。
カスタムオブジェクトの作成を始める前に、カスタムオブジェクトのワークフローを計画することをお勧めします。
カスタムオブジェクトを作成するには
- 管理センターで、サイドバーの「
オブジェクトとルール」をクリックし、「カスタムオブジェクト」>「オブジェクト」を選択します。 - 「オブジェクトを作成」をクリックします。
- 以下の情報を入力します。
- 名前：エージェントに表示されるオブジェクトの名前。
- 複数表示名：ナビゲーションやリストで使用する、オブジェクト名の複数形。
- オブジェクトキー：このオブジェクトに固有の識別子。
- （オプション） 説明：他の管理者にオブジェクトの目的を理解させるための説明文。92文字を超えた分の説明は、「オブジェクト」ページのリスト上の表示で切り捨てられます。
- 「オブジェクトを作成」をクリックします。
- 「フィールド」タブをクリックして、カスタムフィールドをオブジェクトに追加します。これらのフィールドで、オブジェクトのスキーマまたはプロパティを作成します。
-
カスタムオブジェクトを関連するオブジェクトに接続します。このオブジェクトが、Zendesk内の他のオブジェクトやデータとどのように関連しているかを定義するデータモデルとなります。
メモ：カスタムオブジェクトに対するすべてのリレーションシップをオブジェクト側で定義する必要はありません。他のカスタムオブジェクトにカスタムチケットフィールド、ユーザーフィールド、組織フィールド、またはルックアップフィールドを作成する必要があるかもしれません。詳しくは「リレーションシップの定義」を参照してください。
- （オプション）「順序を編集」をクリックして、レコードのプレビューでフィールドをドラッグアンドドロップしてエージェントに表示したい順序に並べ替えて、完了したら「保存」をクリックします。
- オブジェクトのレコードにアクセスするエージェントの権限を確認するには、「権限」タブをクリックします。Enterpriseプランでは、オブジェクトレコードへのエージェントアクセスを設定できます。Team、Growth、Professionalの各プランでは、エージェントの権限はプリセットで定義されています。
カスタムフィールドでカスタムオブジェクトのスキーマを定義する
作成したカスタムオブジェクトを使用する前に、カスタムフィールドを追加する必要があります。これらのフィールドは、カスタムオブジェクトのプロパティまたはスキーマを定義し、エージェントがレコードを作成する際に使用されます。フィールドのリストは、名前のアルファベット順に並んでいます。
- 管理センターで、サイドバーの「 オブジェクトとルール」をクリックし、「カスタムオブジェクト」>「オブジェクト」を選択します。
- フィールドを追加したいカスタムオブジェクトの名前をクリックします。
- 「フィールド」タブをクリックし、「フィールドを追加」をクリックします。
- フィールドタイプを選択し、「表示名」を入力します。
- 「フィールドキー」の値が正しく指定されていることを確認します。
フィールドキーにより、API内でカスタムフィールドを参照できるようになります。フィールドの名前を入力すると、フィールドキーが自動的に入力されます。名前とキーを変更したい場合は、フィールドキーを編集する必要があります。カスタムオブジェクトフィールドを作成した後に、フィールドキーを変更することはできません。
- フィールドの他のプロパティを設定します。オプションのプロパティは、追加するフィールドのタイプによって異なります。
- 「保存」または「別のフィールドを追加」をクリックします。
- 必要に応じて、手順4～7を繰り返します。
エージェントのためにオブジェクトのフィールドを並べ替える
チケットの作業中に、エージェントはチケットに関連するカスタムオブジェクトレコードの情報をプレビューすることができます。オブジェクトのすべてのフィールドがレコードプレビューパネルに表示されますが、エージェントが使いやすいように、最も重要なフィールドを一番上に配置するとよいでしょう。
- 管理センターで、サイドバーの「 オブジェクトとルール」をクリックし、「カスタムオブジェクト」>「オブジェクト」を選択します。
- フィールドを追加したいカスタムオブジェクトの名前をクリックします。
- 「フィールド」タブをクリックし、「順序を編集」をクリックします。
- 表示したい順に、フィールドをドラッグアンドドロップ操作で並べ替えます。
- 「保存」をクリックします。
カスタムオブジェクトレコードへのアクセスについて
さらに、カスタムオブジェクトを作成する場合、オブジェクトとそのレコードへのエージェントとカスタマーのアクセス権限を理解する必要があります。エージェントの場合、エージェントワークスペースの「カスタムオブジェクトレコード」ページでの可視性と、エージェントがオブジェクトのレコードに対して行える操作の2つのアクセスレベルがあります。カスタマー（「エンドユーザー」とも呼ばれる）には、カスタムオブジェクトのレコードを表示、編集、追加、削除する権限も付与できます。
エージェントの権限：
すべてのプランで、「カスタムオブジェクトレコード」ページでオブジェクトをすべてのエージェントと管理者に表示するか、管理者のみに表示するかを決定できます。
次に、ロールベースの権限を使用して、エージェントがオブジェクトのレコードに対して行える操作を決定します。すべてのプランにおいて、カスタムオブジェクトレコードを操作する権限は、システムエージェントロールごとにあらかじめ定義されています。Enterpriseプランでは、管理センターの「ロール」ページで、各オブジェクトへのカスタムロールのアクセス権限を設定できます。特定のオブジェクトレコードへのエージェントのアクセス状況を確認するには、カスタムオブジェクト内の「権限」タブを使用します。
カスタマー権限（EAP）
カスタマー（「エンドユーザー」とも呼ばれる）には、カスタムオブジェクトのレコードを表示、追加、編集、削除する権限も付与できます。カスタムオブジェクトのレコードを閲覧または操作する権限をカスタマーに付与するとで、カスタマーは、チケットを送信する際に関連するカスタムオブジェクトのレコードを直接参照できるようになるため、コメントに詳細を記入してエージェントに関連するレコードを特定させる必要がなくなります。Zendeskのユーザーインターフェイスでは、ルックアップリレーションシップのフィールドにフィルターを適用して、現在のユーザーに関連するレコードのみを表示させることができます。ただし、権限はオブジェクトレベルで付与されるため、技術的な要因で、カスタマーは自分自身に関連するレコードだけでなく、オブジェクトのすべてのレコードへのアクセス権を付与されることになります。
詳細については、「カスタムオブジェクトレコードへのアクセス権の設定」を参照してください。
オブジェクトのリレーションシップを追加する
カスタムオブジェクトを作成し、カスタムフィールドのスキーマを定義したら、それを他の標準オブジェクトまたはカスタムオブジェクトに接続する必要があります。ルックアップリレーションシップフィールドは、カスタムオブジェクトとZendeskの標準オブジェクト（ユーザー、組織、チケット）や他のカスタムオブジェクトとの関係を定義します。ルックアップリレーションシップは、「ソースオブジェクト → 関連するオブジェクト」のように示すことができます。ソースオブジェクトは、ルックアップリレーションシップフィールド（およびその他のフィールド）を含むZendeskオブジェクトです。関連するオブジェクトは、ルックアップリレーションシップフィールドによって指定されたオブジェクトです。
関連するオブジェクトを追加しても、2つの特定のレコードの間に自動的に関連付けが行われるわけではありません。その代わりに、リレーションシップを示すことで、エージェントがこの方法でレコードを関連付けられるようにします。
- 別のカスタムオブジェクト
- 標準オブジェクト
カスタムオブジェクトにルックアップリレーションシップフィールドを含めたい場合は、次の手順を使用します。また、別のオブジェクトにルックアップリレーションシップフィールドとしてカスタムオブジェクトを含めたい場合は、「チケットへのカスタムフィールドの追加」、「ユーザーへのカスタムフィールドの追加」、または「組織へのカスタムフィールドの追加」を参照してください。
カスタムオブジェクトにリレーションシップを追加するには
- 管理センターで、サイドバーの「 オブジェクトとルール」をクリックし、「カスタムオブジェクト」>「オブジェクト」を選択します。
- フィールドを追加したいカスタムオブジェクトにカーソルを合わせ、オプションメニューアイコン（
）をクリックし、「編集」を選択します。 - 「フィールド」タブをクリックし、「フィールドを追加」をクリックします。
- 「表示名」、「フィールドキー」、「説明」を設定します。
- ルックアップリレーションシップフィールドにリストアップする関連するオブジェクトを選択します。
関連するオブジェクトは、別のカスタムオブジェクト（
）、チケット（
）、ユーザー（
）、または組織（
）のいずれかです。たとえば、関連するオブジェクトとして「ユーザー」を選択すると、ルックアップリレーションシップフィールドにはZendeskユーザーのリストが表示されます。 - 「フィルターを追加」をクリックして、1つまたは複数のフィルターを定義し、フィールドに表示されるオプションの数を減らします。
フィルターとして使用できるタグやカスタムフィールドの数に制限はありません。詳細については、「フィールドのオプションをフィルターする」を参照してください。
- 「保存」または「別のフィールドを追加」をクリックします。