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

Plumsail HelpDesk Power Automate のビデオ

前提条件

使用を開始するには、次の前提条件を満たしておく必要があります。

次に、API キーを作成すると、最初のフローを作成する準備ができます。

フローで "Plumsail HelpDesk" を検索し、適切なアクションを追加するだけです。

HelpDesk のアクションのリスト

最初にアクションを追加するとき、Connection NameAccess Key を求められます。 接続に任意の名前を入力できます。 たとえば、Plumsail HelpDesk などとします。

次に、最初のステップで作成した API キーを Access Key の入力に貼り付けます。

フロー接続を作成する

接続の作成

コネクタは、次の認証タイプをサポートしています:

既定 接続を作成するためのパラメーター。 すべてのリージョン 共有可能

既定

適用できるもの: すべての領域

接続を作成するためのパラメーター。

これは共有可能な接続です。 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

戻り値

チケットのすべてのコメントを取得する

指定された 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

メールを指定して連絡先を更新する

電子メールで取引先担当者を検索し、更新します。 更新された取引先担当者を返します。

パラメーター

名前 キー 必須 説明
連絡先メール
email True string

Contact email

取引先担当者カスタム フィールド
customFields object

カスタム フィールド値が含まれる JSON 文字列

連絡先メール
email 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 文字列

連絡先メール
email 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

戻り値

組織を更新する

ID を指定して組織を取得し、それを返します。

パラメーター

名前 キー 必須 説明
組織 ID
id True integer

組織 ID

組織カスタム フィールド
customFields object

カスタム フィールド値が含まれる JSON 文字列

組織タイトル
title True string

戻り値

複数の組織を取得する

組織の一覧を取得する

パラメーター

名前 キー 必須 説明
$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 文字列

連絡先メール
email True string
取引先担当者連絡用メール
emailAlternate string
取引先担当者ロール
role string
取引先担当者 SPUserId
spUserId integer
取引先担当者名
title True string
存在する場合は取引先担当者を更新する
updateIfExists boolean

既に存在する場合は取引先担当者を更新する

戻り値

本文​​
ContactRead

電子メールで単一の取引先担当者を取得する

電子メールで取引先担当者を取得し、返します。

パラメーター

名前 キー 必須 説明
取引先担当者の電子メール
email True string

取引先担当者の電子メール

$select
$select string

リスト アイテムに返すフィールドを指定するための ODATA $select クエリ オプション。 * を使用して、使用可能なフィールドすべてを返すことができます。

$expand
$expand string

リクエストがルックアップの値を返すよう指定する ODATA $expand クエリ オプション。

戻り値

本文​​
ContactRead

定義

担当者

名前 パス 説明
担当者カスタム フィールド
customFields object

カスタム フィールド値が含まれる JSON 文字列

担当者メール
email string
担当者連絡用メール
emailAlternate string
担当者 ID
id integer
担当者ロール
role string
担当者 SPUserId
spUserId integer
担当者氏名
title string

CC

名前 パス 説明
Cc CustomFields
customFields object

カスタム フィールド値が含まれる JSON 文字列

Cc メール
email 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 文字列

連絡先メール
email 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 文字列

要求者メール
email 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

バイナリ

これは基本的なデータ型 [バイナリ] です。