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 に設定する。 |
戻り値
- Body
- AddNote_Response
チケットを作成 (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 に設定する。 |
戻り値
- Body
- AddNote_ResponseV2
トリガー
| チケットが作成されるとき (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。 |