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 キーを作成します
• 使用できるアクションのレビュー

次に、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:

_flowV4TicketsByTicketIdCommentsByIdGet

ID を指定してコメントを取得し、それを返します。

パラメーター

名前	キー	必須	型	説明
チケット ID	ticketId	True	integer	チケット ID
コメント ID	id	True	integer	コメント ID
$select	$select		string	リスト アイテムに返すフィールドを指定するための ODATA $select クエリ オプション。 * を使用して、使用可能なフィールドすべてを返すことができます。
$expand	$expand		string	リクエストがルックアップの値を返すよう指定する ODATA $expand クエリ オプション。

戻り値

本文​​

CommentRead

ID で単一の取引先担当者を取得する

操作 ID:

_flowV4ContactsByIdGet

ID で取引先担当者を取得し、返します。

パラメーター

名前	キー	必須	型	説明
取引先担当者 ID	id	True	integer	取引先担当者 ID
$select	$select		string	リスト アイテムに返すフィールドを指定するための ODATA $select クエリ オプション。 * を使用して、使用可能なフィールドすべてを返すことができます。
$expand	$expand		string	リクエストがルックアップの値を返すよう指定する ODATA $expand クエリ オプション。

戻り値

本文​​

ContactRead

コメントの作成

操作 ID:

_flowV4TicketsByTicketIdCommentsPost

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

タイトルで単一の組織を取得する

操作 ID:

_flowV4OrganizationsByTitleByTitleGet

タイトルで組織を取得し、返します。

パラメーター

名前	キー	必須	型	説明
組織のタイトル	title	True	string	組織のタイトル
$select	$select		string	リスト アイテムに返すフィールドを指定するための ODATA $select クエリ オプション。 * を使用して、使用可能なフィールドすべてを返すことができます。
$expand	$expand		string	リクエストがルックアップの値を返すよう指定する ODATA $expand クエリ オプション。

戻り値

本文​​

OrganizationRead

タイトルで組織を削除する

操作 ID:

_flowV4OrganizationsByTitleByTitleDelete

タイトルで組織を削除する

パラメーター

名前	キー	必須	型	説明
組織のタイトル	title	True	string	組織のタイトル

タイトルで組織を更新する

操作 ID:

_flowV4OrganizationsByTitleByTitlePut

タイトルで組織を取得し、更新します。 更新された組織を返します。

パラメーター

名前	キー	必須	型	説明
組織タイトル	title	True	string	組織タイトル
組織カスタム フィールド	customFields		object	カスタム フィールド値が含まれる JSON 文字列
組織タイトル	title	True	string

戻り値

Body

OrganizationRead

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

操作 ID:

_flowV4TicketsByTicketIdCommentsGet

指定された 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 クエリ オプション。

戻り値

応答

array of CommentRead

チケットを作成する

操作 ID:

_flowV4TicketsPost

新しいチケットを作成し、作成されたチケットを返します。

パラメーター

名前	キー	必須	型	説明
チケット担当者の電子メールまたは 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:

_flowV4TicketsByIdDelete

ID でチケットを削除します。

パラメーター

名前	キー	必須	型	説明
チケット ID	id	True	integer	チケット ID

チケットを取得する

操作 ID:

_flowV4TicketsGet

チケットの一覧を取得する

パラメーター

名前	キー	必須	型	説明
$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 クエリ オプション。

戻り値

応答

array of TicketRead

チケットを更新する

操作 ID:

_flowV4TicketsByIdPut

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

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

操作 ID:

_flowV4ContactsByEmailByEmailPut

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

パラメーター

名前	キー	必須	型	説明
連絡先メール	email	True	string	Contact email
取引先担当者カスタム フィールド	customFields		object	カスタム フィールド値が含まれる JSON 文字列
連絡先メール	email	True	string
取引先担当者連絡用メール	emailAlternate		string
取引先担当者ロール	role		string
取引先担当者 SPUserId	spUserId		integer
取引先担当者名	title	True	string

戻り値

本文​​

ContactRead

単一のチケットを取得する

操作 ID:

_flowV4TicketsByIdGet

ID でチケットを取得し、返す

パラメーター

名前	キー	必須	型	説明
チケット ID	id	True	integer	チケット ID
$select	$select		string	リスト アイテムに返すフィールドを指定するための ODATA $select クエリ オプション。 * を使用して、使用可能なフィールドすべてを返すことができます。
$expand	$expand		string	リクエストがルックアップの値を返すよう指定する ODATA $expand クエリ オプション。

戻り値

本文​​

TicketRead

単一の組織を取得する

操作 ID:

_flowV4OrganizationsByIdGet

ID で組織を取得し、返します

パラメーター

名前	キー	必須	型	説明
組織 ID	id	True	integer	組織 ID
$select	$select		string	リスト アイテムに返すフィールドを指定するための ODATA $select クエリ オプション。 * を使用して、使用可能なフィールドすべてを返すことができます。
$expand	$expand		string	リクエストがルックアップの値を返すよう指定する ODATA $expand クエリ オプション。

戻り値

本文​​

OrganizationRead

取引先担当者を削除する

操作 ID:

_flowV4ContactsByIdDelete

ID で取引先担当者を削除する

パラメーター

名前	キー	必須	型	説明
取引先担当者 ID	id	True	integer	取引先担当者 ID

取引先担当者を取得する

操作 ID:

_flowV4ContactsGet

取引先担当者の一覧を取得する

パラメーター

名前	キー	必須	型	説明
$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 クエリ オプション。

戻り値

応答

array of ContactRead

取引先担当者を更新する

操作 ID:

_flowV4ContactsByIdPut

ID で取引先担当者を検索し、更新します。 更新された取引先担当者を返します。

パラメーター

名前	キー	必須	型	説明
連絡先 ID	id	True	integer	連絡先 ID
取引先担当者カスタム フィールド	customFields		object	カスタム フィールド値が含まれる JSON 文字列
連絡先メール	email	True	string
取引先担当者連絡用メール	emailAlternate		string
取引先担当者ロール	role		string
取引先担当者 SPUserId	spUserId		integer
取引先担当者名	title	True	string

戻り値

本文​​

ContactRead

添付ファイルをダウンロードする

操作 ID:

_flowV4TicketsByIdAttachmentsByFilenameGet

指定されたチケットの添付ファイルを名前で返すか、エラー コードを返す

パラメーター

名前	キー	必須	型	説明
チケット ID	id	True	integer	チケット ID
添付ファイル名	filename	True	string	添付ファイル名

戻り値

結果ファイル

binary

組織の削除

操作 ID:

_flowV4OrganizationsByIdDelete

ID で組織を削除します。

パラメーター

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

組織を作成する

操作 ID:

_flowV4OrganizationsPost

組織の一覧に新しい項目を作成し、それを返す

パラメーター

名前	キー	必須	型	説明
組織カスタム フィールド	customFields		object	カスタム フィールド値が含まれる JSON 文字列
組織タイトル	title	True	string

戻り値

Body

OrganizationRead

組織を更新する

操作 ID:

_flowV4OrganizationsByIdPut

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

パラメーター

名前	キー	必須	型	説明
組織 ID	id	True	integer	組織 ID
組織カスタム フィールド	customFields		object	カスタム フィールド値が含まれる JSON 文字列
組織タイトル	title	True	string

戻り値

Body

OrganizationRead

複数の組織を取得する

操作 ID:

_flowV4OrganizationsGet

組織の一覧を取得する

パラメーター

名前	キー	必須	型	説明
$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 クエリ オプション。

戻り値

応答

array of OrganizationRead

連絡先を作成する

操作 ID:

_flowV4ContactsPost

新しい取引先担当者を作成してそれを返します。

パラメーター

名前	キー	必須	型	説明
取引先担当者カスタム フィールド	customFields		object	カスタム フィールド値が含まれる JSON 文字列
連絡先メール	email	True	string
取引先担当者連絡用メール	emailAlternate		string
取引先担当者ロール	role		string
取引先担当者 SPUserId	spUserId		integer
取引先担当者名	title	True	string
存在する場合は取引先担当者を更新する	updateIfExists		boolean	既に存在する場合は取引先担当者を更新する

戻り値

本文​​

ContactRead

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

操作 ID:

_flowV4ContactsByEmailByEmailGet

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

パラメーター

名前	キー	必須	型	説明
取引先担当者の電子メール	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

バイナリ

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