Freshdesk
Freshdesk は、クラウドベースのカスタマー サポート ソリューションであり、カスタマー サービスを効率化し、カスタマーが必要なサポートを確実に受けられるようにするのに役立ちます。 Freshdesk コネクタは、Freshdesk エージェントがチケットおよび連絡先を管理するためのものです。
このコネクタは、次の製品および地域で利用可能です。
| Service | クラス | 地域 |
|---|---|---|
| Logic Apps | 標準 | 以下を除くすべての Logic Apps 地域 : - Azure 中国の地域 - 国防総省 (DoD) |
| Power Automate | 標準 | 以下を除くすべての Power Automate 地域 : - 米国政府 (GCC High) - 21Vianet が運用する中国のクラウド - 国防総省 (DoD) |
| Power Apps | 標準 | 以下を除くすべての Power Apps 地域 : - 米国政府 (GCC High) - 21Vianet が運用する中国のクラウド - 国防総省 (DoD) |
| 連絡先 | |
|---|---|
| 件名 | Microsoft |
| URL | Microsoft LogicApps サポート Microsoft Power Automate サポート Microsoft Power Apps サポート |
| コネクタ メタデータ | |
|---|---|
| 公開元 | Microsoft |
| Web サイト | https://freshdesk.com/ |
| プライバシー ポリシー | https://www.freshworks.com/privacy/ |
既知の問題と制限事項
- 「チケットが作成されたとき」、「エージェントに割り当てられたチケットが更新されたとき」、「チケットが更新されたとき」のトリガーの場合、既定では、チケットの説明は応答で返されません。 「説明を含める」パラメーターを「はい」に設定することにより、トリガー応答に含めることを指定できます。 ただし、この場合 埋め込み が使用されるため、Freshdesk 側のアカウントの 追加料金 に関連付けられていることに注意してください。 チケットの説明が必要な場合は、トリガーを「チケットの取得」アクションと組み合わせて使用することをお勧めします。このアクションの応答には既定で説明が含まれているからです。
- チケットタイプ "サービス タスク" の作成は現在サポートされていません。
接続の作成
コネクタは、次の認証タイプをサポートしています:
| 既定 | 接続を作成するためのパラメーター。 | すべての地域 | 共有不可 |
既定
適用できるもの: すべての領域
接続を作成するためのパラメーター。
これは共有可能な接続ではありません。 パワー アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
| 件名 | タイプ | 内容 | 必要 |
|---|---|---|---|
| 取引先企業 URL | 文字列 | 例: https://company.freshdesk.com | 真 |
| メールまたは API キー (https://aka.ms/ii9u75) | 文字列 | メール アドレス | 真 |
| パスワード | securestring | パスワード (API キーを使用する場合は、任意の値を指定できます) | True |
調整制限
| 名前 | 呼び出し | 更新期間 |
|---|---|---|
| 接続ごとの API 呼び出し | 100 | 60 秒 |
| トリガー ポーリングの頻度 | 1 | 15 秒 |
アクション
| チケットにメモを追加する |
チケットにプライベートメモまたはパブリックメモを追加します。 |
| チケットを作成する |
チケットを作成します。 |
| チケットを取得する |
ID でチケットを取得する。 |
| チケットを更新する |
チケットを更新します (指定された値のみが更新されます)。 |
チケットにメモを追加する
チケットにプライベートメモまたはパブリックメモを追加します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
チケット ID
|
ticketId | True | integer |
メモを追加するチケット ID。 |
|
内容
|
body | True | string |
メモの内容。 |
|
非公開企業
|
private | boolean |
これが非公開企業のノートであるかどうかを示す (既定は true)。 |
戻り値
- 本文
- AddNote200Response
チケットを作成する
チケットを作成します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
情報カテゴリ
|
subject | True | string |
チケットの情報カテゴリ。 |
|
内容
|
description | True | string |
チケットの内容。 |
|
電子メール
|
True | string |
要求者の電子メール。 |
|
|
優先順位
|
priority | True | string |
チケットの優先順位。 |
|
ステータス
|
status | True | string |
チケットのステータス。 |
|
タイプ
|
type | string |
サポート チームが扱うさまざまな種類の問題に応じてチケットを分類するのに役立ちます。 |
|
|
有効期限
|
due_by | date-time |
チケットがいつ解決されるかを示すタイムスタンプ (形式 yyyy-MM-ddTHH:mm:ssZ)。 |
|
|
期限までの最初の応答
|
fr_due_by | date-time |
最初の応答の期限を示すタイムスタンプ (形式 yyyy-MM-ddTHH:mm:ssZ)。 |
|
|
エージェント
|
responder_id | integer |
チケットのエージェント。 |
|
|
製品
|
product_id | integer |
チケットの一部となる製品 (管理者専用)。 |
戻り値
チケットを取得する
ID でチケットを取得する。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
チケット ID
|
ticketId | True | string |
チケット ID。 |
戻り値
チケットを更新する
チケットを更新します (指定された値のみが更新されます)。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
チケット ID
|
ticketId | True | integer |
更新するチケット ID。 |
|
内容
|
description | string |
チケットの内容。 |
|
|
情報カテゴリ
|
subject | string |
チケットの情報カテゴリ。 |
|
|
優先順位
|
priority | string |
チケットの優先順位。 |
|
|
ステータス
|
status | string |
チケットのステータス。 |
|
|
タイプ
|
type | string |
サポート チームが扱うさまざまな種類の問題に応じてチケットを分類するのに役立ちます。 |
|
|
有効期限
|
due_by | date-time |
チケットがいつ解決されるかを示すタイムスタンプ (形式 yyyy-MM-ddTHH:mm:ssZ)。 |
|
|
エージェント
|
responder_id | integer |
チケットのエージェント。 |
戻り値
トリガー
| エージェントが追加されたとき |
エージェントが追加されたとき (管理者専用)。 このトリガーは、Freshdesk の取引先企業が 100 未満の場合にのみ機能します。 |
| エージェントに割り当てられたチケットが更新されたとき |
選択したエージェントに割り当てられたチケットが更新されたとき。 |
| チケットが作成されたとき |
チケットが作成されたとき。 |
| チケットが更新されたとき |
チケットが更新されたとき。 |
| ドキュメントのステータスが変更された場合 |
チケットのステータスが変更されたとき。 |
| 取引先担当者が追加されたとき |
取引先企業が追加されたとき。 このトリガーは、Freshdesk の取引先企業が 100 未満の場合にのみ機能します。 |
エージェントが追加されたとき
エージェントが追加されたとき (管理者専用)。 このトリガーは、Freshdesk の取引先企業が 100 未満の場合にのみ機能します。
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
ID
|
id | integer |
ID |
|
チケットの範囲
|
ticket_scope | integer |
エージェントのチケット許可。 |
|
作成場所
|
created_at | date-time |
エージェント作成のタイムスタンプ (形式 yyyy-MM-ddTHH:mm:ssZ)。 |
|
更新場所
|
updated_at | date-time |
エージェントの更新されたタイムスタンプ (形式 yyyy-MM-ddTHH:mm:ssZ)。 |
|
アクティブです
|
contact.active | boolean |
エージェントが検証された場合は true に設定する。 |
|
電子メール
|
contact.email | string |
エージェントのメール アドレス。 |
|
役職
|
contact.job_title | string |
エージェントの役職。 |
|
言語
|
contact.language | string |
エージェントの言語。 |
|
最終ログイン時
|
contact.last_login_at | date-time |
エージェントが最後に成功したログインのタイムスタンプ (形式 yyyy-MM-ddTHH:mm:ssZ)。 |
|
携帯電話
|
contact.mobile | string |
エージェントの携帯電話番号。 |
|
件名
|
contact.name | string |
エージェントの名前。 |
|
電話
|
contact.phone | string |
エージェントの電話番号。 |
|
タイム ゾーン
|
contact.time_zone | string |
エージェントのタイム ゾーン。 |
|
作成場所
|
contact.created_at | date-time |
エージェント作成のタイムスタンプ (形式 yyyy-MM-ddTHH:mm:ssZ)。 |
|
更新場所
|
contact.updated_at | date-time |
エージェントが最後に更新したタイムスタンプ (形式 yyyy-MM-ddTHH:mm:ssZ)。 |
エージェントに割り当てられたチケットが更新されたとき
選択したエージェントに割り当てられたチケットが更新されたとき。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
エージェント ID
|
agentId | True | integer |
エージェント ID。 |
|
説明を含める
|
includeDescription | boolean |
トリガーの応答に説明が含まれている必要がある。 |
戻り値
チケットが作成されたとき
チケットが作成されたとき。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
説明を含める
|
includeDescription | boolean |
トリガーの応答に説明が含まれている必要がある。 |
戻り値
チケットが更新されたとき
チケットが更新されたとき。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
チケット ID
|
ticketId | integer |
チケット ID。 |
|
|
説明を含める
|
includeDescription | boolean |
トリガーの応答に説明が含まれている必要がある。 |
戻り値
ドキュメントのステータスが変更された場合
チケットのステータスが変更されたとき。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
チケット ID
|
ticketId | True | integer |
チケット ID。 |
|
新しいステータス
|
status | string |
チケットの新しいステータス。 |
戻り値
取引先担当者が追加されたとき
取引先企業が追加されたとき。 このトリガーは、Freshdesk の取引先企業が 100 未満の場合にのみ機能します。
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
アクティブです
|
active | boolean |
取引先企業が確認されている場合は true に設定する。 |
|
住所
|
address | string |
取引先企業の住所。 |
|
会社 ID
|
company_id | integer |
この取引先企業が属する会社の ID。 |
|
内容
|
description | string |
取引先企業の簡単な説明。 |
|
電子メール
|
string |
取引先企業の既定の電子メール アドレス。 |
|
|
ID
|
id | integer |
取引先企業 ID。 |
|
役職
|
job_title | string |
取引先企業の役職。 |
|
言語
|
language | string |
取引先企業の言語。 |
|
携帯電話
|
mobile | string |
取引先企業の携帯電話番号。 |
|
件名
|
name | string |
取引先企業の件名。 |
|
電話
|
phone | string |
取引先企業の電話番号。 |
|
タイム ゾーン
|
time_zone | string |
取引先企業が存在するタイム ゾーン。 |
|
Twitter ID
|
twitter_id | string |
取引先企業の Twitter ハンドル。 |
|
作成場所
|
created_at | date-time |
取引先企業作成のタイムスタンプ (形式 yyyy-MM-ddTHH:mm:ssZ)。 |
|
更新場所
|
updated_at | date-time |
取引先企業の更新されたタイムスタンプ (形式 yyyy-MM-ddTHH:mm:ssZ)。 |
定義
CreateTicket200Response
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
スパム
|
spam | boolean |
チケットがスパムとしてマークされている場合は true に設定する。 |
|
優先順位
|
priority | string |
チケットの優先度。 |
|
要求者 ID
|
requester_id | integer |
要求者のユーザー ID。 |
|
エージェント ID
|
responder_id | integer |
チケットが割り当てられているエージェントの ID。 |
|
ソース
|
source | string |
チケットが作成されたチャネル。 |
|
ステータス
|
status | string |
チケットのステータス。 |
|
情報カテゴリ
|
subject | string |
チケットの情報カテゴリ。 |
|
チケット ID
|
id | integer |
チケットの一意 ID。 |
|
タイプ
|
type | string |
サポート チームが扱うさまざまな種類の問題に応じてチケットを分類するのに役立ちます。 |
|
有効期限
|
due_by | date-time |
チケットがいつ解決されるかを示すタイムスタンプ (形式 yyyy-MM-ddTHH:mm:ssZ)。 |
|
エスカレーション済み
|
is_escalated | boolean |
何らかの理由でチケットがエスカレーションされた場合は、true に設定する。 |
|
内容
|
description | string |
チケットの HTML のコンテンツ。 |
|
Description Text
|
description_text | string |
プレーン テキストのチケットの内容。 |
|
作成場所
|
created_at | date-time |
チケット作成のタイムスタンプ (形式 yyyy-MM-ddTHH:mm:ssZ)。 |
|
更新場所
|
updated_at | date-time |
チケットの更新されたタイムスタンプ (形式 yyyy-MM-ddTHH:mm:ssZ)。 |
|
削除済み
|
deleted | boolean |
チケットが削除されている場合は true に設定する。 |
AddNote200Response
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
非公開企業
|
private | boolean |
メモが非公開企業の場合は true に設定する。 |
|
内容
|
body | string |
HTML のメモの内容。 |
|
コンテンツ テキスト
|
body_text | string |
プレーン テキストのメモの内容。 |
|
チケット ID
|
ticket_id | integer |
このメモが追加されるチケットの ID。 |
|
作成場所
|
created_at | date-time |
メモ作成のタイムスタンプ (形式 yyyy-MM-ddTHH:mm:ssZ)。 |
|
更新時
|
updated_at | date-time |
メモの更新されたタイムスタンプ (形式 yyyy-MM-ddTHH:mm:ssZ)。 |