Freshdesk
Freshdesk はクラウドベースのカスタマー サポート ソリューションであり、顧客サービスを合理化し、顧客が適切なサポートを受けるのを確実にするのに役立ちます。 Freshdesk コネクタは、Freshdesk エージェントがチケットと連絡先を管理することを目的としています。
このコネクタは、次の製品とリージョンで使用できます。
| サービス | クラス | リージョン |
|---|---|---|
| コピロット スタジオ | Standard | 次を除くすべての Power Automate リージョン : - 米国政府 (GCC High) - 21Vianet が運営する China Cloud - 米国国防総省 (DoD) |
| ロジック アプリ | Standard | 次を除くすべての Logic Apps リージョン : - Azure China リージョン - 米国国防総省 (DoD) |
| Power Apps | Standard | 次を除くすべての Power Apps リージョン : - 米国政府 (GCC High) - 21Vianet が運営する China Cloud - 米国国防総省 (DoD) |
| Power Automate | Standard | 次を除くすべての Power Automate リージョン : - 米国政府 (GCC High) - 21Vianet が運営する China Cloud - 米国国防総省 (DoD) |
| お問い合わせ | |
|---|---|
| 名前 | Microsoft |
| URL |
Microsoft LogicApps のサポート Microsoft Power Automate のサポート Microsoft Power Apps のサポート |
| コネクタ メタデータ | |
|---|---|
| Publisher | Microsoft |
| Website | https://freshdesk.com/ |
| プライバシー ポリシー | https://www.freshworks.com/privacy/ |
既知の問題と制限事項
- トリガー "チケットが作成されたとき"、"エージェントに割り当てられたチケットが更新されたとき"、"チケットが更新されたとき" の説明は、応答で既定では返されません。 "説明を含める" パラメーターを "Yes" に設定することで、トリガーの応答に含める指定を行うことができます。 ただし、この場合は埋め込みを使用するため、Freshdesk 側のアカウントの追加コストに関連付けられています。 チケットの説明が必要な場合は、トリガーを "チケットの取得" アクションと組み合わせて使用することをお勧めします。このアクションの応答には既定で説明が含まれているためです。
- チケットの種類 "サービス タスク" の作成は現在サポートされていません。
接続を作成する
コネクタでは、次の認証の種類がサポートされています。
| デフォルト | 接続を作成するためのパラメーター。 | すべてのリージョン | 共有不可 |
デフォルト
適用対象: すべてのリージョン
接続を作成するためのパラメーター。
これは共有可能な接続ではありません。 電源アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
| 名前 | タイプ | Description | 必須 |
|---|---|---|---|
| アカウント URL | 文字列 | 例: https://company.freshdesk.com | 正しい |
| 電子メールまたは API キー (https://aka.ms/ii9u75) | 文字列 | メール アドレス | 正しい |
| パスワード | securestring | パスワード (API キーを使用している場合は、任意の値を指定できます) | 正しい |
調整制限
| 名前 | 呼び出し | 更新期間 |
|---|---|---|
| 接続ごとの API 呼び出し | 100 | 60 秒 |
| トリガーポーリングの頻度 | 1 | 15 秒 |
アクション
| チケットにメモを追加する |
チケットにプライベートノートまたはパブリックノートを追加します。 |
| チケットを作成する |
チケットを作成します。 |
| チケットを取得する |
ID でチケットを取得します。 |
| チケットを更新する |
チケットを更新します (指定した値のみが更新されます)。 |
チケットにメモを追加する
チケットにプライベートノートまたはパブリックノートを追加します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
チケット ID
|
ticketId | True | integer |
メモを追加するチケット ID。 |
|
Content
|
body | True | string |
メモの内容。 |
|
非公開
|
private | boolean |
これがプライベート ノートかどうかを示します (既定値は true)。 |
戻り値
- Body
- AddNote200Response
チケットを作成する
チケットを作成します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
サブジェクト
|
subject | True | string |
チケットの件名。 |
|
Description
|
description | True | string |
チケットの説明。 |
|
Email
|
True | string |
要求元の電子メール。 |
|
|
Priority
|
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)。 |
|
|
Agent
|
responder_id | integer |
チケットのエージェント。 |
|
|
Product
|
product_id | integer |
チケットが含まれている必要がある製品 (管理者専用)。 |
戻り値
チケットを取得する
ID でチケットを取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
チケット ID
|
ticketId | True | string |
チケット ID。 |
戻り値
チケットを更新する
チケットを更新します (指定した値のみが更新されます)。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
チケット ID
|
ticketId | True | integer |
更新するチケット ID。 |
|
Description
|
description | string |
チケットの説明。 |
|
|
サブジェクト
|
subject | string |
チケットの件名。 |
|
|
Priority
|
priority | string |
チケットの優先順位。 |
|
|
ステータス
|
status | string |
チケットの状態。 |
|
|
タイプ
|
type | string |
サポート チームが扱うさまざまな種類の問題に応じてチケットを分類するのに役立ちます。 |
|
|
期限
|
due_by | date-time |
チケットが解決される時期を示すタイムスタンプ (形式は yyyy-MM-ddTHH:mm:ssZ)。 |
|
|
Agent
|
responder_id | integer |
チケットのエージェント。 |
戻り値
トリガー
| エージェントが追加されたとき |
エージェントが追加されたとき (管理者専用)。 このトリガーは、Freshdesk アカウントのエージェント数が 100 未満の場合にのみ機能します。 |
| エージェントに割り当てられたチケットが更新されたとき |
選択したエージェントに割り当てられているチケットが更新されたとき。 |
| チケットが作成されたとき |
チケットが作成されたとき。 |
| チケットが更新されたとき |
チケットが更新されたとき。 |
| チケットの状態が変わるとき |
チケットの状態が変更されたとき。 |
| 連絡先が追加されたとき |
連絡先が追加されたとき。 このトリガーは、Freshdesk アカウントの連絡先が 100 未満の場合にのみ機能します。 |
エージェントが追加されたとき
エージェントが追加されたとき (管理者専用)。 このトリガーは、Freshdesk アカウントのエージェント数が 100 未満の場合にのみ機能します。
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
id
|
id | integer |
id |
|
チケット スコープ
|
ticket_scope | integer |
エージェントのチケットのアクセス許可。 |
|
Created At
|
created_at | date-time |
エージェント作成タイムスタンプ (形式は yyyy-MM-ddTHH:mm:ssZ)。 |
|
更新日時
|
updated_at | date-time |
エージェントがタイムスタンプを更新しました (形式は yyyy-MM-ddTHH:mm:ssZ)。 |
|
Active
|
contact.active | boolean |
エージェントが検証される場合は true に設定します。 |
|
Email
|
contact.email | string |
エージェントの電子メール アドレス。 |
|
役職
|
contact.job_title | string |
エージェントの役職。 |
|
Language
|
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 |
エージェントのタイム ゾーン。 |
|
Created At
|
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
|
active | boolean |
連絡先が検証済みの場合は true に設定します。 |
|
住所
|
address | string |
連絡先のアドレス。 |
|
会社 ID
|
company_id | integer |
この連絡先が属する会社の ID。 |
|
Description
|
description | string |
連絡先の簡単な説明。 |
|
Email
|
string |
連絡先のプライマリ メール アドレス。 |
|
|
ID (アイディー)
|
id | integer |
連絡先の ID。 |
|
役職
|
job_title | string |
連絡先の役職。 |
|
Language
|
language | string |
連絡先の言語。 |
|
モバイル
|
mobile | string |
連絡先の携帯電話番号。 |
|
名前
|
name | string |
連絡先の名前。 |
|
電話
|
phone | string |
連絡先の電話番号。 |
|
タイム ゾーン
|
time_zone | string |
連絡先が存在するタイム ゾーン。 |
|
Twitter Id
|
twitter_id | string |
連絡先の Twitter ハンドル。 |
|
Created At
|
created_at | date-time |
連絡先の作成タイムスタンプ (形式は yyyy-MM-ddTHH:mm:ssZ)。 |
|
更新日時
|
updated_at | date-time |
更新されたタイムスタンプ (形式は yyyy-MM-ddTHH:mm:ssZ) にお問い合わせください。 |
定義
CreateTicket200Response
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
Spam
|
spam | boolean |
チケットがスパムとしてマークされている場合は true に設定します。 |
|
Priority
|
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
|
description | string |
チケットの HTML コンテンツ。 |
|
説明テキスト
|
description_text | string |
プレーンテキストでのチケットの内容。 |
|
Created At
|
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 に設定します。 |
|
Content
|
body | string |
HTML でのメモの内容。 |
|
コンテンツ テキスト
|
body_text | string |
ノートの内容 (プレーンテキスト)。 |
|
チケット ID
|
ticket_id | integer |
このメモを追加するチケットの ID。 |
|
Created At
|
created_at | date-time |
作成タイムスタンプ (形式は yyyy-MM-ddTHH:mm:ssZ) に注意してください。 |
|
更新日
|
updated_at | date-time |
更新されたタイムスタンプをメモします (形式は yyyy-MM-ddTHH:mm:ssZ)。 |