Zendesk
Zendesk は、顧客関係を向上するためのソフトウェアを構築します。 Zendeskは、複数の製品をポートフォリオに含め、顧客からの電話、電子メール、その他の技術的な問い合わせを統一されたインターフェイスから処理する機能を企業に提供する顧客サービスとサポートチケットプラットフォームを提供します。
このコネクタは、次の製品とリージョンで使用できます。
| サービス | クラス | リージョン |
|---|---|---|
| コピロット スタジオ | Premium | 次を除くすべての Power Automate リージョン : - 米国政府 (GCC High) - 21Vianet が運営する China Cloud - 米国国防総省 (DoD) |
| ロジック アプリ | Standard | 次を除くすべての Logic Apps リージョン : - Azure China リージョン - 米国国防総省 (DoD) |
| Power Apps | Premium | 次を除くすべての Power Apps リージョン : - 米国政府 (GCC High) - 21Vianet が運営する China Cloud - 米国国防総省 (DoD) |
| Power Automate | Premium | 次を除くすべての Power Automate リージョン : - 米国政府 (GCC High) - 21Vianet が運営する China Cloud - 米国国防総省 (DoD) |
| お問い合わせ | |
|---|---|
| 名前 | Microsoft |
| URL |
Microsoft LogicApps のサポート Microsoft Power Automate のサポート Microsoft Power Apps のサポート |
| コネクタ メタデータ | |
|---|---|
| Publisher | 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 には、クエリごとに 1,000 件の結果を返す 制限があります 。 これは、ターゲット テーブルに 1000 件以上のレコードが含まれている場合にエラー ("Http 要求が失敗しました: コンテンツが有効な JSON ではなかった") で失敗する一部のコネクタ アクションに影響します。
接続を作成する
コネクタでは、次の認証の種類がサポートされています。
| デフォルト | 接続を作成するためのパラメーター。 | すべてのリージョン | 共有不可 |
デフォルト
適用対象: すべてのリージョン
接続を作成するためのパラメーター。
これは共有可能な接続ではありません。 電源アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
| 名前 | タイプ | Description | 必須 |
|---|---|---|---|
| 会社名 | 文字列 | Zendesk の会社名は、サイト URL のサブドメイン部分です。 例: https://{company}.zendesk.com | 正しい |
調整制限
| 名前 | 呼び出し | 更新期間 |
|---|---|---|
| 接続ごとの API 呼び出し | 100 | 60 秒 |
アクション
| アイテムの削除 |
Zendesk アイテムを削除します |
| アイテムを作成する |
Zendesk アイテムを作成します |
| アイテムを取得 |
特定の Zendesk 型の Zendesk 項目を取得します (例: 'Ticket') |
| テーブルを取得する |
サイトから Zendesk テーブルを取得します |
| 記事の検索 |
既定の 1 ページあたり 25 個のアーティクルを返し、最大で 1,000 件の結果を返します。 |
| 項目を取得する |
Zendesk 項目を取得します。 |
| 項目を更新する |
既存の Zendesk 項目を更新します |
アイテムの削除
Zendesk アイテムを削除します
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
テーブル名
|
table | True | string |
Zendesk アイテムの種類 (例: 'Ticket') |
|
項目キー
|
id | True | string |
削除するアイテムの一意識別子 |
アイテムを作成する
Zendesk アイテムを作成します
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
テーブル名
|
table | True | string |
Zendesk アイテムの種類 (例: 'Ticket') |
|
Item
|
item | True | dynamic |
作成する Zendesk 項目 |
戻り値
アイテムを取得
特定の Zendesk 型の Zendesk 項目を取得します (例: 'Ticket')
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
テーブル名
|
table | True | string |
Zendesk アイテムの種類 (例: 'Ticket') |
|
フィルター クエリ
|
$filter | string |
返されるエントリを制限する ODATA フィルター クエリ (例: stringColumn eq 'string' OR numberColumn lt 123)。 |
|
|
並べ替え
|
$orderby | string |
エントリの順序を指定するための ODATA orderBy クエリ |
|
|
Skip Count
|
$skip | integer |
スキップするエントリの数 (既定値 = 0) |
|
|
最大取得数
|
$top | integer |
取得するエントリの最大数 (既定値 = 512) |
|
|
クエリの選択
|
$select | string |
エントリから取得する特定のフィールド (既定値 = すべて)。 |
戻り値
テーブルを取得する
記事の検索
既定の 1 ページあたり 25 個のアーティクルを返し、最大で 1,000 件の結果を返します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Query
|
query | True | string |
検索する記事。 |
|
ロケール
|
locale | string |
項目が表示されるロケール |
|
|
ブランド ID
|
brand_id | integer |
指定したブランドの記事を検索します。 |
|
|
カテゴリ
|
category | integer |
検索をこのカテゴリ ID に制限します。 |
|
|
セクション
|
section | integer |
検索をこのセクション ID に制限する |
|
|
ラベル名
|
label_names | string |
ラベル名のコンマ区切りのリスト。 |
|
|
Multibrand
|
multibrand | boolean |
true の場合は、すべてのブランドで検索を有効にします。 |
戻り値
- Body
- SearchResult
項目を取得する
Zendesk 項目を取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
テーブル名
|
table | True | string |
Zendesk アイテムの種類 (例: 'Ticket') |
|
項目キー
|
id | True | string |
取得する項目の一意識別子 |
戻り値
項目を更新する
既存の Zendesk 項目を更新します
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
テーブル名
|
table | True | string |
Zendesk アイテムの種類 (例: 'Ticket') |
|
項目キー
|
id | True | string |
更新するアイテムの一意識別子 |
|
Item
|
item | True | dynamic |
更新された値を持つ Zendesk 項目 |
戻り値
トリガー
| アイテムが作成されたとき |
Zendesk で項目が作成されたときにフローをトリガーします |
| アイテムが変更されたとき |
Zendesk で項目が変更されたときにフローをトリガーします |
| アイテムが変更されたとき |
Zendesk で項目が変更されたときにフローをトリガーします |
アイテムが作成されたとき
Zendesk で項目が作成されたときにフローをトリガーします
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
テーブル名
|
table | True | string |
Zendesk テーブルの名前 |
|
フィルター クエリ
|
$filter | string |
返されるエントリを制限する ODATA フィルター クエリ (例: stringColumn eq 'string' OR numberColumn lt 123)。 |
|
|
並べ替え
|
$orderby | string |
エントリの順序を指定するための ODATA orderBy クエリ |
|
|
Skip Count
|
$skip | integer |
スキップするエントリの数 (既定値 = 0) |
|
|
最大取得数
|
$top | integer |
取得するエントリの最大数 (既定値 = 512) |
戻り値
アイテムが変更されたとき
Zendesk で項目が変更されたときにフローをトリガーします
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
テーブル名
|
table | True | string |
Zendesk テーブルの名前 |
|
フィルター クエリ
|
$filter | string |
返されるエントリを制限する ODATA フィルター クエリ (例: stringColumn eq 'string' OR numberColumn lt 123)。 |
|
|
並べ替え
|
$orderby | string |
エントリの順序を指定するための ODATA orderBy クエリ |
|
|
Skip Count
|
$skip | integer |
スキップするエントリの数 (既定値 = 0) |
|
|
最大取得数
|
$top | integer |
取得するエントリの最大数 (既定値 = 512) |
戻り値
アイテムが変更されたとき
Zendesk で項目が変更されたときにフローをトリガーします
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
テーブル名
|
table | True | string |
Zendesk テーブルの名前 |
|
フィルター クエリ
|
$filter | string |
返されるエントリを制限する ODATA フィルター クエリ (例: stringColumn eq 'string' OR numberColumn lt 123)。 |
|
|
並べ替え
|
$orderby | string |
エントリの順序を指定するための ODATA orderBy クエリ |
|
|
Skip Count
|
$skip | integer |
スキップするエントリの数 (既定値 = 0) |
|
|
最大取得数
|
$top | integer |
取得するエントリの最大数 (既定値 = 512) |
戻り値
定義
表
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
名前
|
Name | string | |
|
DisplayName
|
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 |
|
作成日時
|
results.created_at | date-time |
アーティクルが作成された時刻 |
|
updated_at
|
results.updated_at | date-time |
記事が最後に更新された時刻 |
|
名前
|
results.name | string |
記事の名前 |
|
title
|
results.title | string |
記事のタイトル |
|
source_locale
|
results.source_locale | string |
記事のソース (既定) ロケール |
|
ロケール
|
results.locale | string |
アーティクルが表示されているロケール |
|
時代遅れ
|
results.outdated | boolean |
Deprecated |
|
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
|
value | array of Table |