Plumsail HelpDesk
API により Plumsail HelpDesk チケット システムと対話することができます。 詳細については、https://plumsail.com/docs/help-desk-o365/v1.x/API/ms-flow.html を参照してください。
このコネクタは、次の製品および地域で利用可能です。
Service | クラス | 地域 |
---|---|---|
Logic Apps | 標準 | 以下を除くすべての Logic Apps 地域 : - Azure 中国の地域 - 国防総省 (DoD) |
Power Automate | 標準 | 以下を除くすべての Power Automate 地域 : - 米国政府 (GCC High) - 21Vianet が運用する中国のクラウド - 国防総省 (DoD) |
Power Apps | 標準 | 以下を除くすべての Power Apps 地域 : - 米国政府 (GCC High) - 21Vianet が運用する中国のクラウド - 米国国防総省 (DoD) |
お問い合わせ先 | |
---|---|
Name | Plumsail |
URL | https://plumsail.com/sharepoint-helpdesk |
メール | support@plumsail.com |
Connector Metadata | |
---|---|
発行者 | Plumsail Inc. |
Web サイト | https://plumsail.com |
プライバシー ポリシー | https://plumsail.com/privacy-policy/ |
カテゴリ | コラボレーション; ビジネス管理 |
このコネクタにより、Power Automate を使って HelpDesk のデータを操作することができます。
詳細については、https://plumsail.com/helpdesk を参照してください。
前提条件
使用を開始するには、次の前提条件を満たしておく必要があります。
次に、API キーを作成すると、最初のフローを作成する準備ができます。
フローで "Plumsail HelpDesk" を検索し、適切なアクションを追加するだけです。
最初にアクションを追加するとき、Connection Name
と Access Key
を求められます。 接続に任意の名前を入力できます。 たとえば、Plumsail HelpDesk
などとします。
次に、最初のステップで作成した API キーを Access Key
の入力に貼り付けます。
- Power Automate (Microsoft Flow) アクション
- チケットを取得する
- チケットを作成する
- チケットを削除する
- 1 つのチケットを取得する
- 添付ファイルをダウンロードする
- チケットを更新する
- チケットに対するすべてのコメントを取得する
- コメントを作成する
- 1 つのコメントを取得する
- 取引先担当者を取得する
- 連絡先を作成する
- メールを指定して 1 人の取引先担当者を取得する
- メールを指定して連絡先を更新する
- 取引先担当者を削除する
- ID で単一の取引先担当者を取得する
- ID を指定して連絡先を更新する
- 組織を取得する
- 組織を作成する
- 組織を削除する
- 1 つの組織を取得する
- 組織を更新する
- タイトルを指定して組織を削除する
- タイトルを指定して 1 つの組織を取得する
- タイトルを指定して組織を更新する
接続の作成
コネクタは、次の認証タイプをサポートしています:
既定 | 接続を作成するためのパラメーター。 | すべてのリージョン | 共有可能 |
既定
適用できるもの: すべての領域
接続を作成するためのパラメーター。
これは共有可能な接続です。 Power App が他のユーザーと共有されている場合、接続も共有されます。 詳細については、キャンバス アプリのコネクタの概要 - Power Apps | Microsoft Docs を参照してください
件名 | タイプ | Description | Required |
---|---|---|---|
API Key | securestring | この API の API キー | True |
データ センターのリージョン | string | True |
調整制限
名前 | 呼び出し | 更新期間 |
---|---|---|
接続ごとの API 呼び出し | 100 | 60 秒 |
アクション
1 つのコメントを取得する |
ID を指定してコメントを取得し、それを返します。 |
ID で単一の取引先担当者を取得する |
ID で取引先担当者を取得し、返します。 |
コメントの作成 |
指定された ID のチケットに対して新しいコメントを作成し、それを返します。 |
タイトルで単一の組織を取得する |
タイトルで組織を取得し、返します。 |
タイトルで組織を削除する |
タイトルで組織を削除する |
タイトルで組織を更新する |
タイトルで組織を取得し、更新します。 更新された組織を返します。 |
チケットのすべてのコメントを取得する |
指定された ID のチケットのコメントすべてを取得します。 |
チケットを作成する |
新しいチケットを作成し、作成されたチケットを返します。 |
チケットを削除する |
ID でチケットを削除します。 |
チケットを取得する |
チケットの一覧を取得する |
チケットを更新する |
ID でチケットを取得し、更新します。 更新されたチケットを返します。 |
メールを指定して連絡先を更新する |
電子メールで取引先担当者を検索し、更新します。 更新された取引先担当者を返します。 |
単一のチケットを取得する |
ID でチケットを取得し、返す |
単一の組織を取得する |
ID で組織を取得し、返します |
取引先担当者を削除する |
ID で取引先担当者を削除する |
取引先担当者を取得する |
取引先担当者の一覧を取得する |
取引先担当者を更新する |
ID で取引先担当者を検索し、更新します。 更新された取引先担当者を返します。 |
添付ファイルをダウンロードする |
指定されたチケットの添付ファイルを名前で返すか、エラー コードを返す |
組織の削除 |
ID で組織を削除します。 |
組織を作成する |
組織の一覧に新しい項目を作成し、それを返す |
組織を更新する |
ID を指定して組織を取得し、それを返します。 |
複数の組織を取得する |
組織の一覧を取得する |
連絡先を作成する |
新しい取引先担当者を作成してそれを返します。 |
電子メールで単一の取引先担当者を取得する |
電子メールで取引先担当者を取得し、返します。 |
1 つのコメントを取得する
ID を指定してコメントを取得し、それを返します。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
チケット ID
|
ticketId | True | integer |
チケット ID |
コメント ID
|
id | True | integer |
コメント ID |
$select
|
$select | string |
リスト アイテムに返すフィールドを指定するための ODATA $select クエリ オプション。 * を使用して、使用可能なフィールドすべてを返すことができます。 |
|
$expand
|
$expand | string |
リクエストがルックアップの値を返すよう指定する ODATA $expand クエリ オプション。 |
戻り値
- 本文
- CommentRead
ID で単一の取引先担当者を取得する
ID で取引先担当者を取得し、返します。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
取引先担当者 ID
|
id | True | integer |
取引先担当者 ID |
$select
|
$select | string |
リスト アイテムに返すフィールドを指定するための ODATA $select クエリ オプション。 * を使用して、使用可能なフィールドすべてを返すことができます。 |
|
$expand
|
$expand | string |
リクエストがルックアップの値を返すよう指定する ODATA $expand クエリ オプション。 |
戻り値
- 本文
- ContactRead
コメントの作成
指定された ID のチケットに対して新しいコメントを作成し、それを返します。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
AttachmentContent
|
AttachmentContent | True | binary |
ファイル内容 |
添付ファイル名
|
Name | True | string | |
コメント本文
|
body | True | string | |
コメント カスタム フィールド
|
customFields | object |
カスタム フィールド値が含まれる JSON 文字列 |
|
コメント作成者メール
|
fromEmail | True | string | |
コメント メッセージ ID
|
messageId | string | ||
チケット ID
|
ticketId | True | integer |
チケット ID |
戻り値
- 本文
- CommentRead
タイトルで単一の組織を取得する
タイトルで組織を取得し、返します。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
組織のタイトル
|
title | True | string |
組織のタイトル |
$select
|
$select | string |
リスト アイテムに返すフィールドを指定するための ODATA $select クエリ オプション。 * を使用して、使用可能なフィールドすべてを返すことができます。 |
|
$expand
|
$expand | string |
リクエストがルックアップの値を返すよう指定する ODATA $expand クエリ オプション。 |
戻り値
- 本文
- OrganizationRead
タイトルで組織を削除する
タイトルで組織を削除する
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
組織のタイトル
|
title | True | string |
組織のタイトル |
タイトルで組織を更新する
タイトルで組織を取得し、更新します。 更新された組織を返します。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
組織タイトル
|
title | True | string |
組織タイトル |
組織カスタム フィールド
|
customFields | object |
カスタム フィールド値が含まれる JSON 文字列 |
|
組織タイトル
|
title | True | string |
戻り値
- Body
- OrganizationRead
チケットのすべてのコメントを取得する
指定された ID のチケットのコメントすべてを取得します。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
チケット ID
|
ticketId | True | integer |
チケット ID |
$select
|
$select | string |
リスト アイテムに返すフィールドを指定するための ODATA $select クエリ オプション。 * を使用して、使用可能なフィールドすべてを返すことができます。 |
|
$expand
|
$expand | string |
リクエストがルックアップの値を返すよう指定する ODATA $expand クエリ オプション。 |
|
$filter
|
$filter | string |
返されるエントリを制限するための ODATA $filter クエリ |
|
$orderBy
|
$orderBy | string |
エントリの順序を指定するための ODATA $orderBy クエリ オプション。 |
戻り値
チケットを作成する
新しいチケットを作成し、作成されたチケットを返します。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
チケット担当者の電子メールまたは SharePoint グループ名
|
assignedToEmail | string | ||
AttachmentContent
|
AttachmentContent | True | binary |
ファイルの内容 |
添付ファイル名
|
Name | True | string | |
チケット本文
|
body | True | string | |
チケット カテゴリ
|
category | string | ||
チケット Cc メール
|
ccEmails | array of string | ||
チケット カスタム フィールド
|
customFields | object |
カスタム フィールド値が含まれる JSON 文字列 |
|
チケット期限
|
dueDate | date-time | ||
チケット優先度
|
priority | string | ||
チケット要求者メール
|
requesterEmail | True | string | |
チケット状態
|
status | string | ||
チケット件名
|
subject | True | string | |
チケット サポート チャネル
|
supportChannel | string | ||
チケット タグ タイトル
|
tagTitles | array of string |
戻り値
- 本文
- TicketRead
チケットを削除する
ID でチケットを削除します。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
チケット ID
|
id | True | integer |
チケット ID |
チケットを取得する
チケットの一覧を取得する
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
$select
|
$select | string |
リスト アイテムに返すフィールドを指定するための ODATA $select クエリ オプション。 * を使用して、使用可能なフィールドすべてを返すことができます。 |
|
$expand
|
$expand | string |
リクエストがルックアップの値を返すよう指定する ODATA $expand クエリ オプション。 |
|
$filter
|
$filter | string |
返されるエントリを制限するための ODATA $filter クエリ |
|
$orderBy
|
$orderBy | string |
エントリの順序を指定するための ODATA $orderBy クエリ オプション。 |
|
$top
|
$top | integer |
返される結果セットの最初の n 項目を選択する ODATA $top クエリ オプション (既定 = 50、最大 = 100)。 |
|
$skiptoken
|
$skiptoken | string |
指定された項目に到達するまで項目をスキップし、残りを返す ODATA $skiptoken クエリ オプション。 |
戻り値
チケットを更新する
ID でチケットを取得し、更新します。 更新されたチケットを返します。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
チケット ID
|
id | True | integer |
チケット ID |
チケット担当者の電子メールまたは SharePoint グループ名
|
assignedToEmail | string | ||
AttachmentContent
|
AttachmentContent | True | binary |
ファイルの内容 |
添付ファイル名
|
Name | True | string | |
チケット本文
|
body | True | string | |
チケット カテゴリ
|
category | string | ||
チケット Cc メール
|
ccEmails | array of string | ||
チケット カスタム フィールド
|
customFields | object |
カスタム フィールド値が含まれる JSON 文字列 |
|
チケット期限
|
dueDate | date-time | ||
チケット優先度
|
priority | string | ||
チケット要求者メール
|
requesterEmail | True | string | |
チケット状態
|
status | string | ||
チケット件名
|
subject | True | string | |
チケット サポート チャネル
|
supportChannel | string | ||
チケット タグ タイトル
|
tagTitles | array of string |
戻り値
- 本文
- TicketRead
メールを指定して連絡先を更新する
電子メールで取引先担当者を検索し、更新します。 更新された取引先担当者を返します。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
連絡先メール
|
True | string |
Contact email |
|
取引先担当者カスタム フィールド
|
customFields | object |
カスタム フィールド値が含まれる JSON 文字列 |
|
連絡先メール
|
True | string | ||
取引先担当者連絡用メール
|
emailAlternate | string | ||
取引先担当者ロール
|
role | string | ||
取引先担当者 SPUserId
|
spUserId | integer | ||
取引先担当者名
|
title | True | string |
戻り値
- 本文
- ContactRead
単一のチケットを取得する
ID でチケットを取得し、返す
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
チケット ID
|
id | True | integer |
チケット ID |
$select
|
$select | string |
リスト アイテムに返すフィールドを指定するための ODATA $select クエリ オプション。 * を使用して、使用可能なフィールドすべてを返すことができます。 |
|
$expand
|
$expand | string |
リクエストがルックアップの値を返すよう指定する ODATA $expand クエリ オプション。 |
戻り値
- 本文
- TicketRead
単一の組織を取得する
ID で組織を取得し、返します
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
組織 ID
|
id | True | integer |
組織 ID |
$select
|
$select | string |
リスト アイテムに返すフィールドを指定するための ODATA $select クエリ オプション。 * を使用して、使用可能なフィールドすべてを返すことができます。 |
|
$expand
|
$expand | string |
リクエストがルックアップの値を返すよう指定する ODATA $expand クエリ オプション。 |
戻り値
- 本文
- OrganizationRead
取引先担当者を削除する
ID で取引先担当者を削除する
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
取引先担当者 ID
|
id | True | integer |
取引先担当者 ID |
取引先担当者を取得する
取引先担当者の一覧を取得する
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
$select
|
$select | string |
リスト アイテムに返すフィールドを指定するための ODATA $select クエリ オプション。 * を使用して、使用可能なフィールドすべてを返すことができます。 |
|
$expand
|
$expand | string |
リクエストがルックアップの値を返すよう指定する ODATA $expand クエリ オプション。 |
|
$filter
|
$filter | string |
返されるエントリを制限するための ODATA $filter クエリ |
|
$orderBy
|
$orderBy | string |
エントリの順序を指定するための ODATA $orderBy クエリ オプション。 |
|
$top
|
$top | integer |
返される結果セットの最初の n 項目を選択する ODATA $top クエリ オプション (既定 = 50、最大 = 100)。 |
|
$skiptoken
|
$skiptoken | string |
指定された項目に到達するまで項目をスキップし、残りを返す ODATA $skiptoken クエリ オプション。 |
戻り値
取引先担当者を更新する
ID で取引先担当者を検索し、更新します。 更新された取引先担当者を返します。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
連絡先 ID
|
id | True | integer |
連絡先 ID |
取引先担当者カスタム フィールド
|
customFields | object |
カスタム フィールド値が含まれる JSON 文字列 |
|
連絡先メール
|
True | string | ||
取引先担当者連絡用メール
|
emailAlternate | string | ||
取引先担当者ロール
|
role | string | ||
取引先担当者 SPUserId
|
spUserId | integer | ||
取引先担当者名
|
title | True | string |
戻り値
- 本文
- ContactRead
添付ファイルをダウンロードする
指定されたチケットの添付ファイルを名前で返すか、エラー コードを返す
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
チケット ID
|
id | True | integer |
チケット ID |
添付ファイル名
|
filename | True | string |
添付ファイル名 |
戻り値
- 結果ファイル
- binary
組織の削除
ID で組織を削除します。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
組織 ID
|
id | True | integer |
組織 ID |
組織を作成する
組織の一覧に新しい項目を作成し、それを返す
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
組織カスタム フィールド
|
customFields | object |
カスタム フィールド値が含まれる JSON 文字列 |
|
組織タイトル
|
title | True | string |
戻り値
- Body
- OrganizationRead
組織を更新する
ID を指定して組織を取得し、それを返します。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
組織 ID
|
id | True | integer |
組織 ID |
組織カスタム フィールド
|
customFields | object |
カスタム フィールド値が含まれる JSON 文字列 |
|
組織タイトル
|
title | True | string |
戻り値
- Body
- OrganizationRead
複数の組織を取得する
組織の一覧を取得する
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
$select
|
$select | string |
リスト アイテムに返すフィールドを指定するための ODATA $select クエリ オプション。 * を使用して、使用可能なフィールドすべてを返すことができます。 |
|
$expand
|
$expand | string |
リクエストがルックアップの値を返すよう指定する ODATA $expand クエリ オプション。 |
|
$filter
|
$filter | string |
返されるエントリを制限するための ODATA $filter クエリ |
|
$orderBy
|
$orderBy | string |
エントリの順序を指定するための ODATA $orderBy クエリ オプション。 |
|
$top
|
$top | integer |
返される結果セットの最初の n 項目を選択する ODATA $top クエリ オプション (既定 = 50、最大 = 100)。 |
|
$skiptoken
|
$skiptoken | string |
指定された項目に到達するまで項目をスキップし、残りを返す ODATA $skiptoken クエリ オプション。 |
戻り値
連絡先を作成する
新しい取引先担当者を作成してそれを返します。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
取引先担当者カスタム フィールド
|
customFields | object |
カスタム フィールド値が含まれる JSON 文字列 |
|
連絡先メール
|
True | string | ||
取引先担当者連絡用メール
|
emailAlternate | string | ||
取引先担当者ロール
|
role | string | ||
取引先担当者 SPUserId
|
spUserId | integer | ||
取引先担当者名
|
title | True | string | |
存在する場合は取引先担当者を更新する
|
updateIfExists | boolean |
既に存在する場合は取引先担当者を更新する |
戻り値
- 本文
- ContactRead
電子メールで単一の取引先担当者を取得する
電子メールで取引先担当者を取得し、返します。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
取引先担当者の電子メール
|
True | string |
取引先担当者の電子メール |
|
$select
|
$select | string |
リスト アイテムに返すフィールドを指定するための ODATA $select クエリ オプション。 * を使用して、使用可能なフィールドすべてを返すことができます。 |
|
$expand
|
$expand | string |
リクエストがルックアップの値を返すよう指定する ODATA $expand クエリ オプション。 |
戻り値
- 本文
- ContactRead
定義
担当者
名前 | パス | 型 | 説明 |
---|---|---|---|
担当者カスタム フィールド
|
customFields | object |
カスタム フィールド値が含まれる JSON 文字列 |
担当者メール
|
string | ||
担当者連絡用メール
|
emailAlternate | string | |
担当者 ID
|
id | integer | |
担当者ロール
|
role | string | |
担当者 SPUserId
|
spUserId | integer | |
担当者氏名
|
title | string |
CC
名前 | パス | 型 | 説明 |
---|---|---|---|
Cc CustomFields
|
customFields | object |
カスタム フィールド値が含まれる JSON 文字列 |
Cc メール
|
string | ||
Cc 連絡用メール
|
emailAlternate | string | |
Cc ID
|
id | integer | |
Cc ロール
|
role | string | |
Cc SPUserId
|
spUserId | integer | |
Cc 氏名
|
title | string |
CommentRead
名前 | パス | 型 | 説明 |
---|---|---|---|
コメント本文
|
body | string | |
コメント作成日
|
created | date-time | |
コメント カスタム フィールド
|
customFields | object |
カスタム フィールド値が含まれる JSON 文字列 |
コメント作成者メール
|
fromEmail | string | |
コメント作成者名
|
fromName | string | |
コメント ID
|
id | integer | |
コメント メッセージ ID
|
messageId | string |
ContactRead
名前 | パス | 型 | 説明 |
---|---|---|---|
取引先担当者カスタム フィールド
|
customFields | object |
カスタム フィールド値が含まれる JSON 文字列 |
連絡先メール
|
string | ||
取引先担当者連絡用メール
|
emailAlternate | string | |
連絡先 ID
|
id | integer | |
取引先担当者ロール
|
role | string | |
取引先担当者 SPUserId
|
spUserId | integer | |
取引先担当者氏名
|
title | string |
OrganizationRead
名前 | パス | 型 | 説明 |
---|---|---|---|
組織カスタム フィールド
|
customFields | object |
カスタム フィールド値が含まれる JSON 文字列 |
組織 ID
|
id | integer | |
組織タイトル
|
title | string |
要求者
名前 | パス | 型 | 説明 |
---|---|---|---|
要求者カスタム フィールド
|
customFields | object |
カスタム フィールド値が含まれる JSON 文字列 |
要求者メール
|
string | ||
要求者連絡用メール
|
emailAlternate | string | |
要求者 ID
|
id | integer | |
要求者ロール
|
role | string | |
要求者 SPUserId
|
spUserId | integer | |
要求者氏名
|
title | string |
TagRead
名前 | パス | 型 | 説明 |
---|---|---|---|
タグ カスタム フィールド
|
customFields | object |
カスタム フィールド値が含まれる JSON 文字列 |
タグ ID
|
id | integer | |
タグ タイトル
|
title | string |
TicketRead
名前 | パス | 型 | 説明 |
---|---|---|---|
チケット担当者
|
assignedTo | Assignee | |
チケット添付ファイル
|
attachments | array of string | |
チケット カテゴリ
|
category | string | |
チケット Cc
|
cc | array of Cc | |
チケット作成日
|
created | date-time | |
チケット カスタム フィールド
|
customFields | object |
カスタム フィールド値が含まれる JSON 文字列 |
チケット期限
|
dueDate | date-time | |
チケット ID
|
id | integer | |
チケット優先度
|
priority | string | |
チケット要求者
|
requester | Requester | |
チケット解決日
|
resolutionDate | date-time | |
チケット状態
|
status | string | |
チケット件名
|
subject | string | |
チケット タグ
|
tags | array of TagRead | |
カスタム チケット ID
|
ticketID | string |
バイナリ
これは基本的なデータ型 [バイナリ] です。