Zendesk
Zendesk はより良い顧客リレーションシップのためのソフトウェアを構築します。 Zendesk は、顧客サービスおよびサポート チケッティング プラットフォームを提供し、顧客からの電話、電子メール、その他の技術的な問い合わせを統一されたインターフェイスで処理する能力を企業に提供します。
このコネクタは、次の製品および地域で利用可能です。
| サービス | クラス | 地域 |
|---|---|---|
| Logic Apps | 標準 | 以下を除くすべての Logic Apps 地域 : - Azure China の地域 - 米国国防総省 (DoD) |
| Power Automate | Premium | 以下を除くすべての Power Automate 地域 : - US Government (GCC High) - 21 Vianet が運用する中国のクラウド - 米国国防総省 (DoD) |
| Power Apps | Premium | 以下を除くすべての Power Apps 地域 : - US Government (GCC High) - 21 Vianet が運用する中国のクラウド - 米国国防総省 (DoD) |
| 連絡先 | |
|---|---|
| 件名 | Microsoft |
| URL | Microsoft LogicApps サポート Microsoft Power Automate サポート Microsoft Power Apps サポート |
| コネクタ メタデータ | |
|---|---|
| 公開元 | Microsoft |
| Web サイト | https://www.zendesk.com/ |
| プライバシー ポリシー | https://www.zendesk.com/company/customers-partners/privacy-policy/ |
既知の問題と制限事項
- コネクタは Zendesk エンティティのアトミック プロパティのみを返します (例: リスト、レコード、その他の複合型はサポートされていません)。 たとえば、
Ticketエンティティは Zendesk 側の配列で表されるtagsプロパティを持っています。 Zendesk コネクタはそのようなフィールドの[List]文字列を返します。 - コネクタにはトリガーで使用されるすべてのテーブルに存在する
updated_at列が必要です。 - Zendesk Search API には、クエリごとに 1000 件の結果を返す場合に 制限 があります。 これは一部のコネクタ アクションに影響し、ターゲットテーブルに 1000 以上のレコードが含まれている場合、エラー ("Httpリクエストが失敗しました: コンテンツは有効な JSON ではありませんでした") とともに失敗します。
接続の作成
コネクタは、次の認証タイプをサポートしています:
| 既定 | 接続を作成するためのパラメーター。 | すべての地域 | 共有不可 |
既定
適用できるもの: すべての領域
接続を作成するためのパラメーター。
これは共有可能な接続ではありません。 Power App が別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
| 件名 | タイプ | プロパティ | Required |
|---|---|---|---|
| Company name | string | Zendesk の会社名は、サイトの URL のサブドメイン部分です。 E.g. https://{company}.zendesk.com | True |
調整制限
| 名前 | 呼び出し | 更新期間 |
|---|---|---|
| 接続ごとの API 呼び出し | 100 | 60 秒 |
アクション
| アイテムの削除 |
Zendesk の項目を削除する |
| アイテムの取得 |
特定の Zendesk タイプの Zendesk の項目を取得する (例: 「チケット」) |
| アイテムの更新 |
Zendesk のアイテムを更新 |
| テーブルを取得する |
サイトから Zendesk テーブルを取得する |
| 記事を検索 |
既定で 1 ページあたり 25 件の記事を返します。最大 1000 件を返します。 |
| 項目の作成 |
Zendesk の項目を作成する |
| 項目を取得する |
Zendesk の項目を取得する |
アイテムの削除
Zendesk の項目を削除する
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Table name
|
table | True | string |
Zendesk の項目タイプ (例: 「チケット」) |
|
アイテム キー
|
id | True | string |
削除する項目を表す一意識別子 |
アイテムの取得
特定の Zendesk タイプの Zendesk の項目を取得する (例: 「チケット」)
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Table name
|
table | True | string |
Zendesk の項目タイプ (例: 「チケット」) |
|
Filter Query
|
$filter | string |
返されるエントリを制限するための ODATA フィルター クエリ (例: stringColumn eq 'string' OR numberColumn lt 123)。 |
|
|
並べ替え順
|
$orderby | string |
エントリの順序を指定するための ODATA orderBy クエリ |
|
|
スキップ数
|
$skip | integer |
スキップするエントリ数です (既定値 = 0) |
|
|
最大取得数
|
$top | integer |
取得するエントリの最大数 (既定= 512) |
|
|
クエリを選択する
|
$select | string |
エントリから取得する特定のフィールドです (既定値 = すべて)。 |
戻り値
アイテムの更新
Zendesk のアイテムを更新
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Table name
|
table | True | string |
Zendesk の項目タイプ (例: 「チケット」) |
|
アイテム キー
|
id | True | string |
更新する項目を表す一意識別子 |
|
Item
|
item | True | dynamic |
Zendesk更新された値を持つ項目 |
戻り値
テーブルを取得する
記事を検索
既定で 1 ページあたり 25 件の記事を返します。最大 1000 件を返します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
クエリ
|
query | True | string |
検索する記事です。 |
|
Locale
|
locale | string |
項目が表示されているロケール |
|
|
ブランド ID
|
brand_id | integer |
指定されたブランドの記事を検索します。 |
|
|
カテゴリー
|
category | integer |
検索をこのカテゴリ ID に制限します。 |
|
|
セクション
|
section | integer |
検索をこのセクション ID に制限する |
|
|
ラベル名
|
label_names | string |
ラベル名のコンマ区切りリストです。 |
|
|
マルチブランド
|
multibrand | boolean |
true の場合、すべてのブランドで検索を有効にします。 |
戻り値
- Body
- SearchResult
項目の作成
Zendesk の項目を作成する
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Table name
|
table | True | string |
Zendesk の項目タイプ (例: 「チケット」) |
|
Item
|
item | True | dynamic |
作成する Zendesk の項目 |
戻り値
項目を取得する
Zendesk の項目を取得する
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Table name
|
table | True | string |
Zendesk の項目タイプ (例: 「チケット」) |
|
アイテム キー
|
id | True | string |
取得する項目を表す一意識別子 |
戻り値
トリガー
| アイテムの変更時 |
Zendesk で項目が修正されたときにフローをトリガーする |
| 項目が作成されたとき |
Zendesk で項目が作成されたときにフローをトリガーします |
アイテムの変更時
Zendesk で項目が修正されたときにフローをトリガーする
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Table name
|
table | True | string |
Zendesk テーブル名 |
|
Filter Query
|
$filter | string |
返されるエントリを制限するための ODATA フィルター クエリ (例: stringColumn eq 'string' OR numberColumn lt 123)。 |
|
|
並べ替え順
|
$orderby | string |
エントリの順序を指定するための ODATA orderBy クエリ |
|
|
スキップ数
|
$skip | integer |
スキップするエントリ数です (既定値 = 0) |
|
|
最大取得数
|
$top | integer |
取得するエントリの最大数 (既定= 512) |
戻り値
項目が作成されたとき
Zendesk で項目が作成されたときにフローをトリガーします
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Table name
|
table | True | string |
Zendesk テーブル名 |
|
Filter Query
|
$filter | string |
返されるエントリを制限するための ODATA フィルター クエリ (例: stringColumn eq 'string' OR numberColumn lt 123)。 |
|
|
並べ替え順
|
$orderby | string |
エントリの順序を指定するための ODATA orderBy クエリ |
|
|
スキップ数
|
$skip | integer |
スキップするエントリ数です (既定値 = 0) |
|
|
最大取得数
|
$top | integer |
取得するエントリの最大数 (既定= 512) |
戻り値
定義
テーブル
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
件名
|
Name | string | |
|
表示名
|
DisplayName | string |
SearchResult
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
results
|
results | array of object | |
|
id
|
results.id | integer |
自動的に割り当てられた記事 ID |
|
url
|
results.url | string |
記事の API URL |
|
html_url
|
results.html_url | string |
ヘルプ センターの記事の URL |
|
author_id
|
results.author_id | integer |
作成者 ID |
|
comments_disabled
|
results.comments_disabled | boolean |
コメントが無効の場合は True; それ以外の場合は false |
|
下書き
|
results.draft | boolean |
現在のロケールの翻訳が下書きである場合は True |
|
宣伝
|
results.promoted | boolean |
この記事が上位表示される場合は true、それ以外の場合は false。 既定では false |
|
職位
|
results.position | integer |
記事リスト内のこの記事の位置 既定で 0 |
|
vote_sum
|
results.vote_sum | integer |
賛成票 (+1) と反対票 (-1) の合計。正の場合も負の場合もあります |
|
vote_count
|
results.vote_count | integer |
賛成票と反対票の合計数 |
|
section_id
|
results.section_id | integer |
この記事が含まれるセクションの ID |
|
created_at
|
results.created_at | date-time |
記事が作成された時刻 |
|
updated_at
|
results.updated_at | date-time |
記事が最後に更新された時刻 |
|
名称
|
results.name | string |
記事の名前 |
|
肩書き
|
results.title | string |
記事のタイトル |
|
source_locale
|
results.source_locale | string |
記事のソース (既定) ロケール |
|
locale
|
results.locale | string |
記事が表示されているロケール |
|
期限切れ
|
results.outdated | boolean |
非推奨 |
|
outdated_locales
|
results.outdated_locales | array of string |
記事が期限切れとしてマークされたロケール |
|
edited_at
|
results.edited_at | date-time |
記事が表示されたロケールで最後に編集された時刻 |
|
user_segment_id
|
results.user_segment_id | integer |
この記事の表示を許可するユーザーを定義するユーザー セグメントの ID |
|
permission_group_id
|
results.permission_group_id | integer |
この記事の編集および公開を許可するユーザーを定義するアクセス許可グループの ID |
|
content_tag_ids
|
results.content_tag_ids | array of string |
記事に添付されているコンテンツ タグの一覧 |
|
label_names
|
results.label_names | array of string |
この記事に関連付けられているラベル名の配列 |
|
body
|
results.body | string |
記事の HTML 本文 |
|
スニペット
|
results.snippet | string |
記事の HTML スニペット |
|
result_type
|
results.result_type | string |
結果の種類 |
TablesList
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
価値
|
value | array of Table |