次の方法で共有


Freshservice (プレビュー)

Freshservice は、クラウドベースの IT サービス デスクおよびサービス管理ソリューションであり、設定と使用が簡単で、組織全体で従業員のエクスペリエンスを変革します。

このコネクタは、次の製品および地域で利用可能です。

Service クラス 地域
Logic Apps 標準 以下を除くすべての Logic Apps 地域 :
     -   Azure 政府の地域
     -   Azure 中国の地域
     -   国防総省 (DoD)
Power Automate プレミアム 以下を除くすべての Power Automate 地域 :
     -   米国政府 (GCC)
     -   米国政府 (GCC High)
     -   21Vianet が運用する中国のクラウド
     -   国防総省 (DoD)
Power Apps プレミアム 以下を除くすべての Power Apps 地域 :
     -   米国政府 (GCC)
     -   米国政府 (GCC High)
     -   21Vianet が運用する中国のクラウド
     -   米国国防総省 (DoD)
Connector Metadata
発行者 マイクロソフト

認証

重要

ユーザー名とパスワードに基づいた認証は、FreshService ではサポートされなくなりました。 コネクタは、1 種類の認証のみ (API キー) をサポートするようになりました。 FreshService API 移行ドキュメント

接続を作成する

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

API キー API キー認証の種類 すべての地域 共有不可
既定 [非推奨] このオプションは、明示的な認証の種類を持たない古い接続専用に対してのみ使用され、下位互換性を保つためにのみ提供されます。 すべての地域 共有不可

API Key

認証 ID: 基本

適用可能: すべての領域

API キー認証の種類

これは共有可能な接続ではありません。 Power App が別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。

件名 タイプ Description Required
API Key string この API の API キー True
サイト URL string ルート サイト URL です (例: https://sample.freshservice.com) True

既定 [非推奨]

適用可能: すべての領域

このオプションは、明示的な認証の種類を持たない古い接続専用に対してのみ使用され、下位互換性を保つためにのみ提供されます。

これは共有可能な接続ではありません。 Power App が別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。

件名 タイプ 内容 必要
ユーザー名 文字列 この API のユーザー名
パスワード securestring この API のパスワード
サイト URL 文字列 ルート サイト URL です (例: https://sample.freshservice.com)

調整制限

名前 呼び出し 更新期間
接続ごとの API 呼び出し 100 60 秒
トリガー ポーリングの頻度 1 120 秒

アクション

チケットにメモを追加する [非推奨]

チケットにプライベートメモまたはパブリックメモを追加します。

チケットを作成 (V2)

チケットを作成します。

チケットを作成する [非推奨]

チケットを作成します。

チケットを更新する (V2)

チケットを更新します (指定された値のみが更新されます)。

チケットを更新する [非推奨]

チケットを更新します (指定された値のみが更新されます)。

メモをチケットに追加する (V2)

チケットにプライベートメモまたはパブリックメモを追加します。

チケットにメモを追加する [非推奨]

チケットにプライベートメモまたはパブリックメモを追加します。

パラメーター

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

更新するチケット ID。

メモ
body True string

チケットに追加するメモ。

Is Private
private boolean

メッセージが非公開の場合は true に設定する。

戻り値

チケットを作成 (V2)

チケットを作成します。

パラメーター

名前 キー 必須 説明
要求者 ID
requester_id True integer

要求者のユーザー ID。 既存の連絡先の場合、電子メールの代わりに requester_id を渡すことができます。

情報カテゴリ
subject True string

チケットの情報カテゴリ。

ステータス
status True string

チケットのステータス。

優先順位
priority True string

チケットの優先順位 (低、中、高など)。

内容
description True string

チケットの内容。

緊急度
urgency string

問題の緊急度 (低、中、高など)。

影響
impact string

問題の影響 (低、中、高など)。

Source
source string

チケットが作成されたチャネル。

戻り値

チケットを作成する [非推奨]

チケットを作成します。

パラメーター

名前 キー 必須 説明
要求者 ID
requester_id True integer

要求者のユーザー ID。 既存の連絡先の場合、電子メールの代わりに requester_id を渡すことができます。

情報カテゴリ
subject True string

チケットの情報カテゴリ。

ステータス
status True string

チケットのステータス。

優先順位
priority True string

チケットの優先順位 (低、中、高など)。

内容
description True string

チケットの内容。

緊急度
urgency string

問題の緊急度 (低、中、高など)。

影響
impact string

問題の影響 (低、中、高など)。

ソース
source string

チケットが作成されたチャネル。

戻り値

名前 パス 説明
helpdesk_ticket
item.helpdesk_ticket Ticket_Response

チケットを更新する (V2)

チケットを更新します (指定された値のみが更新されます)。

パラメーター

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

更新するチケット ID。

要求者 ID
requester_id integer

要求者のユーザー ID。 既存の連絡先の場合、電子メールの代わりに requester_id を渡すことができます。

情報カテゴリ
subject string

チケットの情報カテゴリ。

ステータス
status string

チケットのステータス。

優先順位
priority string

チケットの優先順位 (低、中、高など)。

緊急度
urgency string

問題の緊急度 (低、中、高など)。

影響
impact string

問題の影響 (低、中、高など)。

ソース
source string

チケットが作成されたチャネル。

戻り値

チケットを更新する [非推奨]

チケットを更新します (指定された値のみが更新されます)。

パラメーター

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

更新するチケット ID。

要求者 ID
requester_id integer

要求者のユーザー ID。 既存の連絡先の場合、電子メールの代わりに requester_id を渡すことができます。

情報カテゴリ
subject string

チケットの情報カテゴリ。

ステータス
status string

チケットのステータス。

優先順位
priority string

チケットの優先順位 (低、中、高など)。

緊急度
urgency string

問題の緊急度 (低、中、高など)。

影響
impact string

問題の影響 (低、中、高など)。

Source
source string

チケットが作成されたチャネル。

戻り値

メモをチケットに追加する (V2)

チケットにプライベートメモまたはパブリックメモを追加します。

パラメーター

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

更新するチケット ID。

メモ
body True string

チケットに追加するメモ。

Is Private
private boolean

メッセージが非公開の場合は true に設定する。

戻り値

トリガー

チケットが作成されるとき (V2)

新しいチケットが作成されるときにトリガーします。

チケットの作成時または更新時 [非推奨]

新しいチケットが作成されるときにトリガーします。

チケットが作成されるとき (V2)

新しいチケットが作成されるときにトリガーします。

戻り値

チケットの作成時または更新時 [非推奨]

新しいチケットが作成されるときにトリガーします。

戻り値

定義

Ticket_Response

名前 パス 説明
作成日時
created_at date-time

yyyy-MM-ddTHH:mm:ss.fffZ

削除済み
deleted boolean

チケットが削除/破棄された場合は true に設定する。 削除されたチケットは、「削除済み」フィルター以外のビューでは考慮されません。

部署 ID
department_id_value integer
チケット ID
display_id integer

アカウントに固有のチケット ID。

期限日時
due_by date-time

yyyy-MM-ddTHH:mm:ss.fffZ

グループ ID
group_id integer

チケットが割り当てられているグループの ID。

ID
id integer

チケットの一意の ID。

影響
impact integer

問題の影響を表す数値。

エスカレーション済み
isescalated boolean

エスカレーションが送信された場合は true に設定する。

所有者 ID
owner_id string

問題が割り当てられているエージェントの ID。

優先順位
priority integer

チケットの優先順位を表す数値。

要求者 ID
requester_id integer

要求者のユーザー ID。 既存の連絡先の場合、電子メールの代わりに requester_id を渡すことができます。

応答者 ID
responder_id integer

チケットが割り当てられているエージェントの ID。

ソース
source integer

チケットが作成されたチャネルを表す番号。

スパム
spam boolean

チケットがスパムとしてマークされた場合は true に設定する。

ステータス
status integer

チケットのステータスを表す数値。

情報カテゴリ
subject string

チケットの情報カテゴリ。

チケット タイプ
ticket_type string

チケット フィールドで定義されているようにプロパティ フィールドを入力する。

メールする
to_email string

チケットの受信メールが送信されたメール アドレス。

更新日時
updated_at date-time

yyyy-MM-ddTHH:mm:ss.fffZ

緊急度
urgency integer

問題の緊急度を表す数値。

内容
description string

問題の内容。

説明 HTML
description_html string

チケットの HTML のコンテンツ。 Description と description_html を一緒に渡さないでください。

状態の名前
status_name string

チケットのステータス。

優先名
priority_name string

チケットの優先度。

ソース名
source_name string

チケットが作成されたチャネル。

応答者名
responder_name string

チケットが割り当てられているエージェントの 名前。

メールする
to_emails array of string

チケットの受信メールが送信されたメール アドレス。

部署名
department_name string

部署の名前。

関連する問題 ID
assoc_problem_id integer

チケットに関連する問題の ID。

関連する変更 ID
assoc_change_id integer

問題の変更に関連する ID。

関連する変更原因 ID
assoc_change_cause_id integer

チケットの原因となった変更の ID。

関連するアセット ID
assoc_asset_id integer

チケットに関連するアセットの ID。

緊急名
urgency_name string

問題の緊急性。

影響名
impact_name string

問題の影響。

CreateUpdateTicket_ResponseV2

名前 パス 説明
作成日時
ticket.created_at date-time

yyyy-MM-ddTHH:mm:ss.fffZ

部署 ID
ticket.department_id integer
期限日時
ticket.due_by date-time

yyyy-MM-ddTHH:mm:ss.fffZ

グループ ID
ticket.group_id integer

チケットが割り当てられているグループの ID。

Id
ticket.id integer

チケットの一意の ID。

エスカレーション済み
ticket.is_escalated boolean

エスカレーションが送信された場合は true に設定する。

優先順位
ticket.priority integer

チケットの優先順位を表す数値。

要求者 ID
ticket.requester_id integer

要求者のユーザー ID。 既存の連絡先の場合、電子メールの代わりに requester_id を渡すことができます。

応答者 ID
ticket.responder_id integer

チケットが割り当てられているエージェントの ID。

ソース
ticket.source integer

チケットが作成されたチャネルを表す番号。

スパム
ticket.spam boolean

チケットがスパムとしてマークされた場合は true に設定する。

ステータス
ticket.status integer

チケットのステータスを表す数値。

情報カテゴリ
ticket.subject string

チケットの情報カテゴリ。

チケット タイプ
ticket.type string

チケット フィールドで定義されているようにプロパティ フィールドを入力する。

更新日時
ticket.updated_at date-time

yyyy-MM-ddTHH:mm:ss.fffZ

Description
ticket.description_text string

問題の内容。

説明 HTML
ticket.description string

チケットの HTML のコンテンツ。 Description と description_html を一緒に渡さないでください。

メールする
ticket.to_emails array of string

チケットの受信メールが送信されたメール アドレス。

ListTicket_ResponseV2

名前 パス 説明
作成日時
created_at date-time

yyyy-MM-ddTHH:mm:ss.fffZ

部署 ID
department_id integer
期限日時
due_by date-time

yyyy-MM-ddTHH:mm:ss.fffZ

グループ ID
group_id integer

チケットが割り当てられているグループの ID。

Id
id integer

チケットの一意の ID。

エスカレーション済み
is_escalated boolean

エスカレーションが送信された場合は true に設定する。

優先順位
priority integer

チケットの優先順位を表す数値。

要求者 ID
requester_id integer

要求者のユーザー ID。 既存の連絡先の場合、電子メールの代わりに requester_id を渡すことができます。

応答者 ID
responder_id integer

チケットが割り当てられているエージェントの ID。

ソース
source integer

チケットが作成されたチャネルを表す番号。

スパム
spam boolean

チケットがスパムとしてマークされた場合は true に設定する。

ステータス
status integer

チケットのステータスを表す数値。

情報カテゴリ
subject string

チケットの情報カテゴリ。

チケット タイプ
type string

チケット フィールドで定義されているようにプロパティ フィールドを入力する。

更新日時
updated_at date-time

yyyy-MM-ddTHH:mm:ss.fffZ

Description
description_text string

問題の内容。

説明 HTML
description string

チケットの HTML のコンテンツ。 Description と description_html を一緒に渡さないでください。

メールする
to_emails array of string

チケットの受信メールが送信されたメール アドレス。

UpdateTicket_Response

名前 パス 説明
Is Deleted
ticket.deleted boolean

チケットが削除/破棄された場合は true に設定する。 削除されたチケットは、「削除済み」フィルター以外のビューでは考慮されません。

チケット ID
ticket.display_id integer

アカウントに固有のチケット ID。

情報カテゴリ
ticket.subject string

チケットの情報カテゴリ。

内容
ticket.description string

チケットの説明です。

説明 HTML
ticket.description_html string

チケットの HTML のコンテンツ。 Description と description_html を一緒に渡さないでください。

状態の名前
ticket.status_name string

チケットのステータス。

優先名
ticket.priority_name string

チケットの優先度。

ソース名
ticket.source_name string

チケットが作成されたチャネル。

応答者名
ticket.responder_name string

チケットが割り当てられているエージェントの 名前。

メールする
ticket.to_emails array of string

チケットの受信メールが送信されたメール アドレス。

部署名
ticket.department_name string

部署の名前。

関連する問題 ID
ticket.assoc_problem_id integer

チケットに関連する問題の ID。

関連する変更 ID
ticket.assoc_change_id integer

問題の変更に関連する ID。

関連する変更原因 ID
ticket.assoc_change_cause_id integer

チケットの原因となった変更の ID。

関連するアセット ID
ticket.assoc_asset_id integer

チケットに関連するアセットの ID。

緊急名
ticket.urgency_name string

問題の緊急性。

影響名
ticket.impact_name string

問題の影響。

AddNote_Response

名前 パス 説明
作成日時
note.created_at date-time

yyyy-MM-ddTHH:mm:ss.fffZ

削除済み
note.deleted boolean

チケットが削除/破棄された場合は true に設定する。 削除されたチケットは、「削除済み」フィルター以外のビューでは考慮されません。

ID
note.id integer

メモの一意の ID。

非公開企業
note.private boolean

メモが非公開の場合は true に設定する。

ソース
note.source integer

チケットが作成されたチャネルを表す番号。

更新日時
note.updated_at date-time

yyyy-MM-ddTHH:mm:ss.fffZ

ユーザー ID
note.user_id integer

メモを追加しているエージェントの User_id。

本文​​
note.body string

プレーン テキストのメモの内容。

本文の HTML
note.body_html string

HTML 形式のメモのコンテンツ。 body または body_html のいずれかを渡す必要がある。

attachments
note.attachments array of string

AddNote_ResponseV2

名前 パス 説明
作成日時
conversation.created_at date-time

yyyy-MM-ddTHH:mm:ss.fffZ

Id
conversation.id integer

メモの一意の ID。

Private
conversation.private boolean

メモが非公開の場合は true に設定する。

更新日時
conversation.updated_at date-time

yyyy-MM-ddTHH:mm:ss.fffZ

ユーザー Id
conversation.user_id integer

メモを追加しているエージェントの User_id。

本文​​
conversation.body_text string

プレーン テキストのメモの内容。

本文の HTML
conversation.body string

HTML 形式のメモのコンテンツ。 body または body_html のいずれかを渡す必要がある。

attachments
conversation.attachments array of string
チケット ID
conversation.ticket_id integer

チケットの一意の ID。