Freshworks Freshservice

統合バージョン: 14.0

ユースケース

サービスデスクとの統合。

Freshservice の構成

Freshservice と Google Security Operations の統合は、Freshservice API キーに基づいて機能します。

Freshservice でアカウントの API キーを取得する方法

  1. Freshservice サポート ポータルにログインする
  2. ポータルの右上にあるアカウントのプロフィール写真をクリックします。
  3. [プロフィール設定] ページに移動する
  4. アカウント API キーは、[パスワードの変更] セクションの右側に表示されます。
  5. この API キーは、Google SecOps 統合構成で必要になるため、保存してください。

Google SecOps で Freshworks Freshservice の統合を構成する

Google SecOps で統合を構成する方法について詳しくは、統合を構成するをご覧ください。

統合のパラメータ

次のパラメータを使用して統合を構成します。

パラメータの表示名 タイプ デフォルト値 必須 Description
API ルート 文字列 https://yourdomain.freshservice.com はい Freshservice インスタンスの API ルート URL。
API キー パスワード なし はい 統合で使用する Freshservice API キー。
SSL を確認する チェックボックス オン いいえ 有効になっている場合、統合により、ルート URL が有効な証明書で構成されていることが確認されます。

アクション

Ping

説明

[Google Security Operations Marketplace] タブの統合構成ページで提供されるパラメータを使用して、Freshservice インスタンスへの接続をテストします。

実行

このアクションはエンティティに対しては実行されません。

アクションの結果

スクリプトの結果
スクリプトの結果名 値のオプション
is_success is_success=False
is_success is_success=True
ケースウォール
結果のタイプ 値 / 説明 種類
出力メッセージ *

アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。

  • 成功した場合: 「指定された接続パラメータを使用して Freshservice インスタンスに正常に接続されました。」

アクションが失敗し、ハンドブックの実行を停止します:認証情報の誤りや接続の切断などの重大なエラーの場合:「Freshservice インスタンスに接続できませんでした。エラーは {0}」.format(exception.stacktrace)

 全般

チケットの一覧表示

説明

指定した検索条件に基づいて Freshservice チケットを一覧表示します。Google SecOps エンティティではアクションが機能しません。

パラメータ

パラメータの表示名 タイプ デフォルト値 必須 説明
チケットのタイプ DDL すべて いいえ 返されるチケットのタイプを指定します。
リクエスト元 文字列 なし いいえ 返されるチケットのリクエスト元のメールアドレスを指定します。
統計情報を含める チェックボックス オフ いいえ 有効にすると、アクションでチケットに関する追加の統計情報が返されます。
過去 X 時間の検索 Integer なし いいえ チケットを検索する期間を指定します。
1 ページあたりの行数 Integer 30 いいえ Freshservice のページネーションで 1 ページあたりに返すチケットの数を指定します。
開始ページ Integer 1 いいえ Freshservice のページネーションでチケットを返す開始ページを指定します。
返される最大行数 Integer 30 いいえ アクションが返すチケットの合計数を指定します。

実行

このアクションはエンティティに対しては実行されません。

アクションの結果

スクリプトの結果
スクリプトの結果名 値のオプション
is_success is_success=False
is_success is_success=True
JSON の結果
{
    "tickets": [
        {
            "subject": "Support Needed...",
            "group_id": null,
            "department_id": null,
            "category": null,
            "sub_category": null,
            "item_category": null,
            "requester_id": 17000032840,
            "responder_id": null,
            "due_by": "2021-07-08T21:00:00Z",
            "fr_escalated": false,
            "deleted": false,
            "spam": false,
            "email_config_id": null,
            "fwd_emails": [],
            "reply_cc_emails": [],
            "cc_emails": [],
            "is_escalated": false,
            "fr_due_by": "2021-07-01T18:00:00Z",
            "id": 7,
            "priority": 1,
            "status": 2,
            "source": 2,
            "created_at": "2021-06-29T08:56:24Z",
            "updated_at": "2021-06-29T10:04:51Z",
            "to_emails": null,
            "type": "Incident",
            "description": "<div>Details about the issue...</div>",
            "description_text": "Details about the issue...",
            "custom_fields": {},
            "requester": {
                "email": "dana@example.com",
                "id": 17000032840,
                "mobile": "dana@example.com",
                "name": "Dana",
                "phone": null
            }
        }
    ]
}
Case Wall
結果のタイプ 値 / 説明 タイプ
出力メッセージ *

アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。

  • チケットが見つかった場合（is_success = true）:「Freshservice チケットが正常に取得されました。」
  • チケットが返されなかった場合（is_success = false）:「指定された入力パラメータに対応するチケットが見つかりませんでした。」
  • チケットの取得で API エラーが発生した場合（is_success = false）: 「指定された入力パラメータでチケットの一覧を取得できませんでした。エラー: {API からのエラー}」

アクションが失敗し、ハンドブックの実行が停止します。

認証情報が誤っている、サーバーへの接続がないなどの致命的なエラーの場合、その他: 「アクション「チケットの一覧表示」の実行エラー。理由: {0}」.format(error.Stacktrace)

 一般
テーブル

テーブル名: Freshservice Tickets Found

テーブル列:

ID

タイプ

件名

説明

リクエスト元のメールアドレス

カテゴリ

ステータス

優先度

ソース

Created Date

更新日

期限

Escalated

削除済み

 全般

チケットを作成

説明

Freshservice チケットを作成します。

パラメータ

パラメータの表示名 タイプ デフォルト値 必須 説明
件名 文字列 なし はい 作成されたチケットの件名フィールドを指定します。
説明 文字列 なし はい 作成されたチケットの説明フィールドを指定します。
リクエスト元のメールアドレス 文字列 なし はい 作成されたチケットのリクエスト元のメールアドレスを指定します。
Agent Assign To（エージェントの割り当て先） 文字列 なし いいえ チケットの割り当て先のエージェントのメールアドレスを指定します。
グループの割り当て先 文字列 なし いいえ チケットの割り当て先となるグループ名を指定します。
優先度 DDL 中 はい チケットに割り当てる優先度を指定します。
緊急度 DDL 中 いいえ チケットに割り当てる緊急度を指定します。
影響 DDL 中 いいえ チケットに割り当てる影響を指定します。
タグ 文字列 なし いいえ チケットに割り当てるタグを指定します。このパラメータは、カンマ区切りの文字列として複数の値を受け入れます。
カスタム フィールド JSON なし いいえ

チケットに追加するカスタム フィールドを含む JSON オブジェクトを指定します。Acton は、チケットの既存のカスタム フィールドに新しいカスタム フィールドを追加します。形式例:

{"key1":"value1", "key2":"value2"}
追加する添付ファイル 文字列（CSV） なし いいえ チケットとともにアップロードするファイルのフルパスを指定します。このパラメータは、カンマ区切りの文字列として複数の値を受け入れます。添付ファイルの合計サイズは 15 MB を超えないようにしてください。

実行

このアクションはエンティティに対しては実行されません。

アクションの結果

スクリプトの結果
スクリプトの結果名 値のオプション
is_success is_success=False
is_success is_success=True
JSON の結果
{
    "ticket": {
        "cc_emails": [],
        "fwd_emails": [],
        "reply_cc_emails": [],
        "fr_escalated": false,
        "spam": false,
        "email_config_id": null,
        "group_id": null,
        "priority": 2,
        "requester_id": 17000032840,
        "responder_id": null,
        "source": 2,
        "status": 2,
        "subject": "Support Needed 4...",
        "to_emails": null,
        "department_id": null,
        "id": 10,
        "type": "Incident",
        "due_by": "2021-07-02T18:00:00Z",
        "fr_due_by": "2021-06-30T20:00:00Z",
        "is_escalated": false,
        "description": "<div>Details about the issue...</div>",
        "description_text": "Details about the issue...",
        "category": null,
        "sub_category": null,
        "item_category": null,
        "custom_fields": {
            "test": "very_test"
        },
        "created_at": "2021-06-30T08:01:30Z",
        "updated_at": "2021-06-30T08:01:30Z",
        "tags": [
            "test"
        ],
        "attachments": []
    }
}
Case Wall
結果のタイプ 値 / 説明 タイプ
出力メッセージ *

アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。

  • アクションが正常に実行された場合:（is_success=true）: 新しい Freshservice チケットが作成されました。

  • 指定されたパラメータが原因でアクションの実行に失敗した場合（is_success =false）: 指定されたパラメータで新しいチケットを作成できませんでした。エラーは <エラーテキスト> です。

アクションが失敗し、ハンドブックの実行が停止します。

間違った認証情報、サーバーへの接続なし、その他など、致命的なエラー、SDK エラーの場合::「アクション「チケットの作成」の実行エラー。理由: {0}」.format(error.Stacktrace)

 全般

更新チケット

説明

指定されたアクション入力パラメータに基づいて Freshservice チケットを更新します。チケットの新しいタグが指定された場合、Freshservice API の制限により、アクションはチケットの既存のタグを置き換え、新しいタグを既存のタグに追加しません。

パラメータ

パラメータの表示名 タイプ デフォルト値 必須 説明
チケット ID Integer なし はい 更新するチケット ID を指定します。
ステータス DDL 変更なし いいえ チケットの新しいステータスを指定します。
件名 文字列 なし いいえ 更新する件名フィールドを指定します。
説明 文字列 なし いいえ 更新する説明フィールドを指定します。
リクエスト元のメールアドレス 文字列 なし いいえ 更新するリクエスト元のメールアドレスを指定します。
Agent Assign To（エージェントの割り当て先） 文字列 なし いいえ 更新するエージェントのメールアドレスを指定します。
グループの割り当て先 文字列 なし いいえ 更新するグループ名を指定します。
優先度 DDL 変更なし いいえ 更新する優先度を指定します。
緊急度 DDL 変更なし いいえ 更新する緊急度を指定します。
影響 DDL 変更なし いいえ 影響を指定して更新します。
タグ 文字列 なし いいえ チケットで置き換えるタグを指定します。このパラメータは、カンマ区切りの文字列として複数の値を受け入れます。Freshservice API の制限により、このアクションではチケットの既存のタグが置き換えられ、新しいタグが既存のタグに追加されることはありません。
カスタム フィールド JSON なし いいえ

チケットに追加するカスタム フィールドを含む JSON オブジェクトを指定します。Acton は、チケットの既存のカスタム フィールドに新しいカスタム フィールドを追加します。形式例:

{"key1":"value1", "key2":"value2"}
追加する添付ファイル 文字列（CSV） なし いいえ チケットとともにアップロードするファイルのフルパスを指定します。このパラメータは、カンマ区切りの文字列として複数の値を受け入れます。添付ファイルの合計サイズは 15 MB を超えないようにしてください。

実行

このアクションはエンティティに対しては実行されません。

アクションの結果

スクリプトの結果
スクリプトの結果名 値のオプション
is_success is_success=False
is_success is_success=True
JSON の結果
{
    "ticket": {
        "cc_emails": [],
        "fwd_emails": [],
        "reply_cc_emails": [],
        "spam": false,
        "email_config_id": null,
        "fr_escalated": false,
        "group_id": 17000034192,
        "priority": 1,
        "requester_id": 17002188556,
        "responder_id": 17002188556,
        "source": 2,
        "status": 2,
        "subject": "Support Needed 9...",
        "description": "Details about the issue...",
        "description_text": "Details about the issue...",
        "category": null,
        "sub_category": null,
        "item_category": null,
        "custom_fields": {
            "test": "very_test"
        },
        "id": 12,
        "type": "Incident",
        "to_emails": null,
        "department_id": 17000016543,
        "is_escalated": false,
        "tags": [
            "test"
        ],
        "due_by": "2021-07-09T17:00:00-04:00",
        "fr_due_by": "2021-07-02T14:00:00-04:00",
        "created_at": "2021-06-30T08:36:43Z",
        "updated_at": "2021-06-30T09:39:12Z",
        "attachments": []
    }
}
Case Wall
結果のタイプ 値 / 説明 タイプ
出力メッセージ *

アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。

  • アクションが正常に実行された場合:（is_success=true）

    • Freshservice チケット <チケット ID> が更新されました。

  • 指定されたパラメータが原因でアクションの実行に失敗した場合（is_success =false）

    • 指定されたパラメータでチケット <ticket_id> を更新できませんでした。エラー: <error text>。

アクションが失敗し、ハンドブックの実行が停止します。

間違った認証情報、サーバーへの接続なし、その他など、致命的なエラー、SDK エラーの場合::「アクション「チケットの更新」の実行エラー。理由: {0}」.format(error.Stacktrace)

 全般

チケットの会話の一覧表示

説明

指定された検索条件に基づいて Freshservice チケットの会話を一覧表示します。Google SecOps エンティティではアクションが機能しません。

パラメータ

パラメータの表示名 タイプ デフォルト値 必須 説明
チケット ID Integer なし はい 会話を返すチケット ID を指定します。
1 ページあたりの行数 Integer 30 いいえ Freshservice のページネーションで 1 ページあたりに返すチケットの会話数を指定します。
開始ページ Integer 1 いいえ Freshservice のページネーションでチケットの会話を返す開始ページを指定します。
返される最大行数 Integer 30 いいえ チケットの会話アクションが返す合計数を指定します。

実行

このアクションはエンティティに対しては実行されません。

アクションの結果

スクリプトの結果
スクリプトの結果名 値のオプション
is_success is_success=False
is_success is_success=True
JSON の結果
{
    "conversations": [
        {
            "id": 17014994010,
            "user_id": 17000032840,
            "to_emails": [],
            "body": "<div>This is a test note!</div>",
            "body_text": "This is a test note!",
            "ticket_id": 12,
            "created_at": "2021-07-05T06:58:32Z",
            "updated_at": "2021-07-05T06:58:32Z",
            "incoming": false,
            "private": false,
            "support_email": null,
            "source": 2,
            "from_email": null,
            "cc_emails": [],
            "bcc_emails": null,
            "attachments": []
        },
        {
            "id": 17014993985,
            "user_id": 17000032840,
            "to_emails": [
                "dana@example.com"
            ],
            "body": "<div>We are working on this issue. Will keep you posted.</div>",
            "body_text": "We are working on this issue. Will keep you posted.",
            "ticket_id": 12,
            "created_at": "2021-07-05T06:57:27Z",
            "updated_at": "2021-07-05T06:57:27Z",
            "incoming": false,
            "private": false,
            "support_email": "helpdesk@siemplifyservicedesk.freshservice.com",
            "source": 0,
            "from_email": "helpdesk@siemplifyservicedesk.freshservice.com",
            "cc_emails": [],
            "bcc_emails": [],
            "attachments": []
        }
    ],
    "meta": {
        "count": 2
    }
}
Case Wall
結果のタイプ 値 / 説明 タイプ
出力メッセージ *

アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。

  • チケットの会話が見つかった場合（is_success = true）:
    「Freshservice チケット <チケット ID> の会話が正常に取得されました。」
  • チケットの会話が返されなかった場合（is_success = false）:
    「チケット <チケット ID> のチケットの会話が見つかりませんでした」
  • 指定されたチケット ID が見つからなかった場合（is_success = false）:
    「Freshservice でチケット <ticket id> が見つかりませんでした。
  • チケットの取得で API エラーが発生した場合（is_success = false）: 「指定された入力パラメータを使用してチケットの会話を一覧表示できませんでした。エラー: {API からのエラー}」

アクションが失敗し、ハンドブックの実行が停止します。

認証情報が誤っている、サーバーへの接続がないなど、致命的なエラーの場合、その他:

「アクション「チケットの会話を一覧表示」の実行中にエラーが発生しました。理由: {0}」.format(error.Stacktrace)

 全般
テーブル

テーブル名: Freshservice チケット <チケット ID> の会話

テーブル列:

ID

タイプ

公開設定

User Email

テキスト

送信者メールアドレス

宛先メールアドレス

CC メールアドレス

Bcc メール

 全般

チケットの返信を追加する

説明

Freshservice チケットに返信を追加します。Google SecOps エンティティではアクションが機能しません。

パラメータ

パラメータの表示名 タイプ デフォルト値 必須 説明
チケット ID Integer なし はい 会話を返すチケット ID を指定します。
返信テキスト 文字列 なし はい チケットに追加する返信テキストを指定します。

実行

このアクションはエンティティに対しては実行されません。

アクションの結果

スクリプトの結果
スクリプトの結果名 値のオプション
is_success is_success=False
is_success is_success=True
JSON の結果
    "conversation": {
        "id": 17014998560,
        "user_id": 17000032840,
        "from_email": "helpdesk@siemplifyservicedesk.freshservice.com",
        "cc_emails": [],
        "bcc_emails": [],
        "body": "<div>We are working on this issue. Will keep you posted.2</div>",
        "body_text": "We are working on this issue. Will keep you posted.2",
        "ticket_id": 12,
        "to_emails": [
            "dana@example.com"
        ],
        "attachments": [],
        "created_at": "2021-07-05T09:19:02Z",
        "updated_at": "2021-07-05T09:19:02Z"
    }
}
Case Wall
結果のタイプ 値 / 説明 タイプ
出力メッセージ *

アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。

  • アクションが正常に実行された場合:（is_success=true）

    • チケット <チケット ID> に新しい返信が追加されました。

  • 指定されたチケット ID が見つからなかった場合（is_success = false）:

    • 「チケット <チケット ID> が Freshservice に見つかりませんでした。

アクションが失敗し、ハンドブックの実行が停止します。

間違った認証情報、サーバーへの接続なし、その他など、致命的なエラー、SDK エラーの場合::「アクション「チケットの返信を追加」の実行エラー。理由: {0}」.format(error.Stacktrace)

 全般

チケットノートを追加する

説明

Freshservice チケットにメモを追加します。Google SecOps エンティティではアクションが機能しません。

パラメータ

パラメータの表示名 タイプ デフォルト値 必須 説明
チケット ID Integer なし はい 会話を返すチケット ID を指定します。
メモの種類 DDL 非公開 いいえ チケットに追加するメモのアクションの種類を指定します。
メモのテキスト 文字列 なし はい チケットに追加するメモのテキストを指定します。

実行

このアクションはエンティティに対しては実行されません。

アクションの結果

スクリプトの結果
スクリプトの結果名 値のオプション
is_success is_success=False
is_success is_success=True
JSON の結果
{
    "conversation": {
        "id": 17014999107,
        "incoming": false,
        "private": false,
        "user_id": 17000032840,
        "support_email": null,
        "body": "<div>This is a test note2!</div>",
        "body_text": "This is a test note2!",
        "ticket_id": 12,
        "to_emails": [],
        "attachments": [],
        "created_at": "2021-07-05T09:35:28Z",
        "updated_at": "2021-07-05T09:35:28Z"
    }
}
Case Wall
結果のタイプ 値 / 説明 タイプ
出力メッセージ *

アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。

  • アクションが正常に実行された場合:（is_success=true）

    • チケット <ticket id> に新しい <note type> メモが追加されました。

  • 指定されたチケット ID が見つからなかった場合（is_success = false）:

    • 「チケット <チケット ID> が Freshservice に見つかりませんでした。

アクションが失敗し、ハンドブックの実行が停止します。

間違った認証情報、サーバーへの接続なし、その他など、致命的なエラー、SDK エラーの場合::「アクション「チケットにメモを追加」の実行エラー。理由: {0}」.format(error.Stacktrace)

 全般

エージェントの一覧取得

説明

指定された検索条件に基づいて Freshservice エージェントを一覧表示します。Google SecOps エンティティではアクションが機能しません。

パラメータ

パラメータの表示名 タイプ デフォルト値 必須 説明
Agent Email（エージェントのメールアドレス） 文字列 なし いいえ エージェント レコードを返すメールアドレスを指定します。
エージェントのステータス DDL すべて いいえ 返すエージェントの状態を指定します。
アクティブでないエージェントを含める チェックボックス オフ いいえ 有効にすると、結果にアクティブでないエージェント レコードが含まれます。
1 ページあたりの行数 Integer 30 いいえ Freshservice のページネーションで 1 ページあたりに返すエージェント レコードの数を指定します。
開始ページ Integer 1 いいえ Freshservice のページネーションでエージェント レコードを返す開始ページを指定します。
返される最大行数 Integer 30 いいえ アクションが返すエージェント レコードの合計数を指定します。

実行

このアクションはエンティティに対しては実行されません。

アクションの結果

スクリプトの結果
スクリプトの結果名 値のオプション
is_success is_success=False
is_success is_success=True
JSON の結果
{
    "agents": [
        {
            "active": true,
            "address": null,
            "background_information": null,
            "can_see_all_tickets_from_associated_departments": false,
            "created_at": "2021-06-29T10:37:36Z",
            "custom_fields": {},
            "department_ids": [
                17000016543
            ],
            "email": "dana@example.com",
            "external_id": null,
            "first_name": "dmitry",
            "has_logged_in": false,
            "id": 17002188556,
            "job_title": null,
            "language": "en",
            "last_active_at": null,
            "last_login_at": null,
            "last_name": "s",
            "location_id": null,
            "mobile_phone_number": null,
            "occasional": true,
            "reporting_manager_id": null,
            "role_ids": [
                17000023339
            ],
            "roles": [
                {
                    "role_id": 17000023339,
                    "assignment_scope": "entire_helpdesk",
                    "groups": []
                }
            ],
            "scopes": {
                "ticket": null,
                "problem": null,
                "change": null,
                "asset": null,
                "solution": null,
                "contract": null
            },
            "scoreboard_level_id": 1,
            "signature": "<p> </p>\n",
            "time_format": "12h",
            "time_zone": "American Samoa",
            "updated_at": "2021-06-29T10:37:36Z",
            "work_phone_number": null,
            "group_ids": [
                17000034192
            ],
            "member_of": [
                17000034192
            ],
            "observer_of": []
        },
Case Wall
結果のタイプ 値 / 説明 タイプ
出力メッセージ *

アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。

  • エージェントが見つかった場合（is_success = true）:「Freshservice エージェントが正常に取得されました。」
  • エージェントが返されなかった場合（is_success = false）: 「指定された入力パラメータに対応するエージェントが見つかりませんでした。」
  • エージェントの取得時に API エラーが発生した場合（is_success = false）: 「指定された入力パラメータを使用してエージェントのリストを取得できませんでした。エラー: {API からのエラー}」

アクションが失敗し、ハンドブックの実行が停止します。

認証情報が誤っている、サーバーへの接続がないなど、致命的なエラーの場合、その他:

「Error executing action "List Agents". 理由: {0}」.format(error.Stacktrace)

 一般

表

テーブル名: Freshservice Agents Found

テーブル列:

ID

メール

名

姓

ロール

グループ

部門

場所

有効

不定期

カスタム フィールド

Created Date

更新日

最終利用日

最終ログイン日

 全般

リクエスト元の一覧表示

説明

指定された検索条件に基づいて、Freshservice に登録されているリクエスト担当者のリストを取得します。Google SecOps エンティティではアクションが機能しません。

パラメータ

パラメータの表示名 タイプ デフォルト値 必須 説明
リクエスト元のメールアドレス 文字列 なし いいえ リクエスト元のレコードを返すメールアドレスを指定します。
1 ページあたりの行数 Integer 30 いいえ Freshservice のページネーションで 1 ページあたりに返すエージェント レコードの数を指定します。
開始ページ Integer 1 いいえ Freshservice のページネーションでエージェント レコードを返す開始ページを指定します。
返される最大行数 Integer 30 いいえ アクションが返すエージェント レコードの合計数を指定します。

実行

このアクションはエンティティに対しては実行されません。

アクションの結果

スクリプトの結果
スクリプトの結果名 値のオプション
is_success is_success=False
is_success is_success=True
JSON の結果
{
    "requesters": [
        {
            "active": true,
            "address": null,
            "background_information": null,
            "can_see_all_tickets_from_associated_departments": false,
            "created_at": "2020-07-06T08:07:30Z",
            "custom_fields": {
                "test": null
            },
            "department_ids": [],
            "external_id": null,
            "first_name": "Dana",
            "has_logged_in": false,
            "id": 17000038164,
            "job_title": null,
            "language": "en",
            "last_name": "Doe",
            "location_id": null,
            "mobile_phone_number": null,
            "primary_email": "dana@example.com",
            "reporting_manager_id": null,
            "secondary_emails": [],
            "time_format": "12h",
            "time_zone": "Eastern Time (US & Canada)",
            "updated_at": "2020-07-06T08:07:30Z",
            "work_phone_number": null
        }
    ]
}
Case Wall
結果のタイプ 値 / 説明 タイプ
出力メッセージ *

アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。

  • リクエスト元が見つかった場合（is_success = true）:
    「Freshservice に登録されているリクエスト元が正常に取得されました。」
  • リクエスト元が返されなかった場合（is_success = false）:
    「指定された入力パラメータに対応するリクエスト元が見つかりませんでした。」
  • リクエスト取得時に API エラーが発生した場合（is_success = false）: 「指定された入力パラメータを使用してリクエストの一覧を取得できませんでした。エラー: {API からのエラー}」

アクションが失敗し、ハンドブックの実行が停止します。

認証情報が誤っている、サーバーへの接続がないなど、致命的なエラーの場合、その他:

「Error executing action "List Requesters". 理由: {0}」.format(error.Stacktrace)

 一般

表

テーブル名: Freshservice Requester Found

テーブル列:

ID

メール

名

姓

部門

場所

有効

カスタム フィールド

Created Date

更新日

 全般

エージェントを作成

説明

新しい Freshservice エージェントを作成します。Google SecOps エンティティではアクションが機能しません。

パラメータ

パラメータの表示名 タイプ デフォルト値 必須 説明
メール 文字列 なし はい 作成するエージェントのメールアドレスを指定します。
名 文字列 なし はい 作成するエージェントの姓を指定します。
姓 文字列 なし いいえ 作成するエージェントの姓を指定します。
不定期である チェックボックス オフ いいえ 有効にすると、エージェントは臨時のエージェントとして作成されます。有効にしないと、フルタイムのエージェントとして作成されます。
関連する部門のすべてのチケットを表示できる チェックボックス オフ いいえ

有効にすると、エージェントは関連付けられた部門のすべてのチケットを表示できます。
部門 CSV なし いいえ エージェントに関連付けられている部門名を指定します。このパラメータは、カンマ区切りの文字列として複数の値を受け入れます。
場所 文字列 なし いいえ エージェントに関連付けられたロケーション名を指定します。
グループ メンバーシップ CSV なし いいえ エージェントがメンバーとなるグループ名を指定します。
ロール CSV なし はい

エージェントに追加するロールを指定します。このパラメータは、カンマ区切りの文字列として複数の値を受け入れます。

例: {"role_id":17000023338,"assignment_scope": ""}
役職 文字列 なし いいえ エージェントの役職を指定します。
カスタム フィールド JSON なし いいえ

エージェントに追加するカスタム フィールドを含む JSON オブジェクトを指定します。Acton は、チケットの既存のカスタム フィールドに新しいカスタム フィールドを追加します。形式例:

{"key1":"value1", "key2":"value2"}

実行

このアクションはエンティティに対しては実行されません。

アクションの結果

スクリプトの結果
スクリプトの結果名 値のオプション
is_success is_success=False
is_success is_success=True
JSON の結果
{
    "agent": {
        "active": true,
        "address": null,
        "background_information": null,
        "can_see_all_tickets_from_associated_departments": false,
        "created_at": "2021-07-06T05:40:41Z",
        "custom_fields": {
            "test": "testvalue"
        },
        "department_ids": [],
        "email": "rolanda.hooch@hogwarts.edu",
        "external_id": null,
        "first_name": "Rolanda",
        "has_logged_in": false,
        "id": 17002198254,
        "job_title": "Flying Instructor",
        "language": "en",
        "last_active_at": null,
        "last_login_at": null,
        "last_name": "Hooch",
        "location_id": null,
        "mobile_phone_number": "553632",
        "occasional": true,
        "reporting_manager_id": null,
        "role_ids": [
            17000023338
        ],
        "roles": [
            {
                "role_id": 17000023338,
                "assignment_scope": "entire_helpdesk",
                "groups": []
            }
        ],
        "scopes": {
            "ticket": null,
            "problem": null,
            "change": null,
            "asset": null,
            "solution": null,
            "contract": null
        },
        "scoreboard_level_id": 1,
        "signature": null,
        "time_format": "12h",
        "time_zone": "Eastern Time (US & Canada)",
        "updated_at": "2021-07-06T05:40:41Z",
        "work_phone_number": "443532",
        "group_ids": [
            17000034192
        ],
        "member_of": [
            17000034192
        ],
        "observer_of": []
    }
}
Case Wall
結果のタイプ 値 / 説明 タイプ
出力メッセージ *

アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。

  • アクションが正常に実行された場合:（is_success=true）

    • 新しい Freshservice エージェントが作成されました。

  • 指定されたパラメータが原因でアクションの実行に失敗した場合（is_success =false）

    • 指定されたパラメータで新しいエージェントを作成できませんでした。エラーは <エラーテキスト> です。

アクションが失敗し、ハンドブックの実行が停止します。

間違った認証情報、サーバーへの接続なし、その他など、致命的なエラー、SDK エラーの場合::「アクション「エージェントの作成」の実行エラー。理由: {0}」.format(error.Stacktrace)

 全般

エージェントを更新

説明

既存の Freshservice エージェントを更新します。Google SecOps エンティティではアクションが機能しません。

パラメータ

パラメータの表示名 タイプ デフォルト値 必須 説明
エージェント ID Integer なし はい 更新するエージェント ID を指定します。
メール 文字列 なし いいえ 更新するエージェントのメールアドレスを指定します。
名 文字列 なし いいえ 更新するエージェントの姓を指定します。
姓 文字列 なし いいえ 更新するエージェントの姓を指定します。
不定期である チェックボックス オフ いいえ 有効にすると、エージェントは臨時のエージェントとして更新されます。有効にしないと、フルタイムのエージェントになります。
関連する部門のすべてのチケットを表示できる チェックボックス オフ いいえ

有効にすると、エージェントは関連付けられた部門のすべてのチケットを表示できます。
部門 CSV なし いいえ エージェントに関連付けられている部門名を指定します。このパラメータは、カンマ区切りの文字列として複数の値を受け入れます。
場所 文字列 なし いいえ エージェントに関連付けられたロケーション名を指定します。
グループ メンバーシップ CSV なし いいえ エージェントがメンバーとなるグループ名を指定します。
ロール CSV なし いいえ

エージェントに追加するロールを指定します。このパラメータは、カンマ区切りの文字列として複数の値を受け入れます。

例: {"role_id":17000023338,"assignment_scope": "entire_helpdesk"}
役職 文字列 なし いいえ エージェントの役職を指定します。
カスタム フィールド JSON なし いいえ

エージェントに追加するカスタム フィールドを含む JSON オブジェクトを指定します。Acton は、チケットの既存のカスタム フィールドに新しいカスタム フィールドを追加します。形式例:

{"key1":"value1", "key2":"value2"}

実行

このアクションはエンティティに対しては実行されません。

アクションの結果

スクリプトの結果
スクリプトの結果名 値のオプション
is_success is_success=False
is_success is_success=True
JSON の結果
{
    "agent": {
        "active": true,
        "address": null,
        "background_information": null,
        "can_see_all_tickets_from_associated_departments": false,
        "created_at": "2021-07-06T05:40:41Z",
        "custom_fields": {
            "test": "testvalue"
        },
        "department_ids": [],
        "email": "rolanda.hooch@hogwarts.edu",
        "external_id": null,
        "first_name": "Rolanda",
        "has_logged_in": false,
        "id": 17002198254,
        "job_title": "Flying Instructor",
        "language": "en",
        "last_active_at": null,
        "last_login_at": null,
        "last_name": "Hooch",
        "location_id": null,
        "mobile_phone_number": "553632",
        "occasional": true,
        "reporting_manager_id": null,
        "role_ids": [
            17000023338
        ],
        "roles": [
            {
                "role_id": 17000023338,
                "assignment_scope": "entire_helpdesk",
                "groups": []
            }
        ],
        "scopes": {
            "ticket": null,
            "problem": null,
            "change": null,
            "asset": null,
            "solution": null,
            "contract": null
        },
        "scoreboard_level_id": 1,
        "signature": null,
        "time_format": "12h",
        "time_zone": "Eastern Time (US & Canada)",
        "updated_at": "2021-07-06T05:40:41Z",
        "work_phone_number": "443532",
        "group_ids": [
            17000034192
        ],
        "member_of": [
            17000034192
        ],
        "observer_of": []
    }
}
Case Wall
結果のタイプ 値 / 説明 タイプ
出力メッセージ *

アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。

  • アクションが正常に実行された場合:（is_success=true）

    • Freshservice エージェント <agent_id> が更新されました。

  • 指定されたパラメータが原因でアクションの実行に失敗した場合（is_success =false）

    • 指定されたパラメータで freshservice エージェント <agent_id> を更新できませんでした。エラーは <error text> です。

アクションが失敗し、ハンドブックの実行が停止します。

間違った認証情報、サーバーへの接続なし、その他など、致命的なエラー、SDK エラーの場合::「アクション「エージェントの更新」の実行エラー。理由: {0}」.format(error.Stacktrace)

 全般

エージェントを無効にする

説明

Freshservice エージェントを無効にします。Google SecOps エンティティではアクションが機能しません。

パラメータ

パラメータの表示名 タイプ デフォルト値 必須 説明
エージェント ID Integer なし はい 無効にするエージェント ID を指定します。

実行

このアクションはエンティティに対しては実行されません。

アクションの結果

スクリプトの結果
スクリプトの結果名 値のオプション
is_success is_success=False
is_success is_success=True
JSON の結果
{
    "agent": {
        "active": false,
        "address": null,
        "background_information": null,
        "can_see_all_tickets_from_associated_departments": false,
        "created_at": "2021-07-06T05:40:41Z",
        "custom_fields": {
            "test": "testvalue3"
        },
        "department_ids": [],
        "email": "rolanda.hooch@hogwarts.edu",
        "external_id": null,
        "first_name": "Rolanda",
        "has_logged_in": false,
        "id": 17002198254,
        "job_title": "Flying Instructor",
        "language": "en",
        "last_active_at": null,
        "last_login_at": null,
        "last_name": "Hooch",
        "location_id": null,
        "mobile_phone_number": "553632",
        "occasional": true,
        "reporting_manager_id": null,
        "role_ids": [
            17000023338
        ],
        "roles": [
            {
                "role_id": 17000023338,
                "assignment_scope": "entire_helpdesk",
                "groups": []
            }
        ],
        "scopes": {
            "ticket": null,
            "problem": null,
            "change": null,
            "asset": null,
            "solution": null,
            "contract": null
        },
        "scoreboard_level_id": 2,
        "signature": "<p> </p>\n",
        "time_format": "24h",
        "time_zone": "Eastern Time (US & Canada)",
        "updated_at": "2021-07-06T06:26:59Z",
        "work_phone_number": "443532",
        "group_ids": [],
        "member_of": [],
        "observer_of": []
    }
}
Case Wall
結果のタイプ 値 / 説明 タイプ
出力メッセージ *

アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。

  • アクションが正常に実行された場合:（is_success=true）

    • Freshservice エージェント <agent_id> が無効になりました。

  • 404 エラーが原因でアクションの実行に失敗した場合（is_success =false）

    • 無効にする freshservice エージェント <agent_id> が見つかりませんでした。

  • 403 エラーが原因でアクションの実行に失敗した場合（is_success =false）

    • freshservice エージェント <agent_id> を無効にできませんでした。すでに無効になっている可能性があります。API レスポンス: "code": "access_denied","message": "You are not authorized to perform this action."

アクションが失敗し、ハンドブックの実行が停止します。

間違った認証情報、サーバーへの接続なし、その他など、致命的なエラー、SDK エラーの場合::「アクション「エージェントの無効化」の実行エラー。理由: {0}」.format(error.Stacktrace)

 全般

リクエスタを作成する

説明

新しい Freshservice リクエスターを作成します。Google SecOps エンティティではアクションが機能しません。

パラメータ

パラメータの表示名 タイプ デフォルト値 必須 説明
メール 文字列 なし はい 作成するリクエスト送信者のメールアドレスを指定します。
名 文字列 なし はい 作成するリクエスト元の名前を指定します。
姓 文字列 なし いいえ 作成するリクエスト担当者の姓を指定します。
関連する部門のすべてのチケットを表示できる チェックボックス オフ いいえ

有効にすると、リクエスト元は関連付けられた部門のすべてのチケットを表示できるようになります。
部門 CSV なし いいえ リクエスト元に関連付けられた部門名を指定します。このパラメータは、カンマ区切りの文字列として複数の値を受け入れます。
場所 文字列 なし いいえ リクエスト元に関連付けられている場所の名前を指定します。
役職 文字列 なし いいえ リクエストしたユーザーの役職を指定します。
カスタム フィールド JSON なし いいえ

リクエストに追加するカスタム フィールドを含む JSON オブジェクトを指定します。Acton は、チケットの既存のカスタム フィールドに新しいカスタム フィールドを追加します。形式例:

{"key1":"value1", "key2":"value2"}

実行

このアクションはエンティティに対しては実行されません。

アクションの結果

スクリプトの結果
スクリプトの結果名 値のオプション
is_success is_success=False
is_success is_success=True
JSON の結果
{
    "requester": {
        "active": true,
        "address": null,
        "background_information": null,
        "can_see_all_tickets_from_associated_departments": false,
        "created_at": "2021-07-06T08:12:47Z",
        "custom_fields": {
            "test": "testvalue"
        },
        "department_ids": [],
        "external_id": null,
        "first_name": "Rolanda",
        "has_logged_in": false,
        "id": 17002198308,
        "job_title": "Flying Instructor",
        "language": "en",
        "last_name": "Hooch",
        "location_id": null,
        "mobile_phone_number": null,
        "primary_email": "rolanda.hooch2@hogwarts.edu",
        "reporting_manager_id": null,
        "secondary_emails": [],
        "time_format": "12h",
        "time_zone": "Eastern Time (US & Canada)",
        "updated_at": "2021-07-06T08:12:47Z",
        "work_phone_number": null
    }
}
Case Wall
結果のタイプ 値 / 説明 タイプ
出力メッセージ *

アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。

  • アクションが正常に実行された場合:（is_success=true）

    • 新しい Freshservice リクエスト作成者が作成されました。

  • 指定されたパラメータが原因でアクションの実行に失敗した場合（is_success =false）

    • 指定されたパラメータで新しいリクエスト作成者を生成できませんでした。エラーは <エラーテキスト> です。

アクションが失敗し、ハンドブックの実行が停止します。

間違った認証情報、サーバーへの接続なし、その他など、致命的なエラー、SDK エラーの場合::「アクション「リクエスタの作成」の実行エラー。理由: {0}」.format(error.Stacktrace)

 全般

更新リクエスト

説明

既存の Freshservice リクエスト担当者を更新します。Google SecOps エンティティではアクションが機能しません。

パラメータ

パラメータの表示名 タイプ デフォルト値 必須 説明
リクエスト依頼者の ID Integer なし はい 更新するリクエスト ID を指定します。
メール 文字列 なし いいえ 更新するリクエスト元のメールアドレスを指定します。
名 文字列 なし いいえ 更新するリクエスト元の名前を指定します。
姓 文字列 なし いいえ 更新するリクエスト元の姓を指定します。
関連する部門のすべてのチケットを表示できる チェックボックス オフ いいえ

有効にすると、リクエスト元は関連付けられた部門のすべてのチケットを表示できるようになります。
部門 CSV なし いいえ リクエスト元に関連付けられた部門名を指定します。このパラメータは、カンマ区切りの文字列として複数の値を受け入れます。
場所 文字列 なし いいえ リクエスト元に関連付けられた場所の名前を指定します。
役職 文字列 なし いいえ リクエストしたユーザーの役職を指定します。
カスタム フィールド JSON なし いいえ

リクエストに追加するカスタム フィールドを含む JSON オブジェクトを指定します。Acton は、チケットの既存のカスタム フィールドに新しいカスタム フィールドを追加します。形式例:

{"key1":"value1", "key2":"value2"}

実行

このアクションはエンティティに対しては実行されません。

アクションの結果

スクリプトの結果
スクリプトの結果名 値のオプション
is_success is_success=False
is_success is_success=True
JSON の結果
{
    "agent": {
        "active": true,
        "address": null,
        "background_information": null,
        "can_see_all_tickets_from_associated_departments": false,
        "created_at": "2021-07-06T05:40:41Z",
        "custom_fields": {
            "test": "testvalue"
        },
        "department_ids": [],
        "email": "rolanda.hooch@hogwarts.edu",
        "external_id": null,
        "first_name": "Rolanda",
        "has_logged_in": false,
        "id": 17002198254,
        "job_title": "Flying Instructor",
        "language": "en",
        "last_active_at": null,
        "last_login_at": null,
        "last_name": "Hooch",
        "location_id": null,
        "mobile_phone_number": "553632",
        "occasional": true,
        "reporting_manager_id": null,
        "role_ids": [
            17000023338
        ],
        "roles": [
            {
                "role_id": 17000023338,
                "assignment_scope": "entire_helpdesk",
                "groups": []
            }
        ],
        "scopes": {
            "ticket": null,
            "problem": null,
            "change": null,
            "asset": null,
            "solution": null,
            "contract": null
        },
        "scoreboard_level_id": 1,
        "signature": null,
        "time_format": "12h",
        "time_zone": "Eastern Time (US & Canada)",
        "updated_at": "2021-07-06T05:40:41Z",
        "work_phone_number": "443532",
        "group_ids": [
            17000034192
        ],
        "member_of": [
            17000034192
        ],
        "observer_of": []
    }
}
Case Wall
結果のタイプ 値 / 説明 タイプ
出力メッセージ *

アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。

  • アクションが正常に実行された場合:（is_success=true）

    • Freshservice のリクエスト元 <requester_id> が更新されました。

  • 指定されたパラメータが原因でアクションの実行に失敗した場合（is_success =false）

    • 指定されたパラメータで Freshservice のリクエスト元 <requester_id> を更新できませんでした。エラーは <error text> です。

アクションが失敗し、ハンドブックの実行が停止します。

間違った認証情報、サーバーへの接続なし、その他など、致命的なエラー、SDK エラーの場合::「アクション「リクエスタの更新」の実行エラー。理由: {0}」.format(error.Stacktrace)

 全般

リクエスト元を無効にする

説明

Freshservice のリクエスト元を無効にします。Google SecOps エンティティではアクションが機能しません。

パラメータ

パラメータの表示名 タイプ デフォルト値 必須 説明
リクエスト依頼者の ID Integer なし はい 無効にするリクエスト元 ID を指定します。

実行

このアクションはエンティティに対しては実行されません。

アクションの結果

スクリプトの結果
スクリプトの結果名 値のオプション
is_success is_success=False
is_success is_success=True
ケースウォール
結果のタイプ 値 / 説明 タイプ
出力メッセージ *

アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。

  • アクションが正常に実行された場合:（is_success=true）

    • Freshservice のリクエスト元 <requester_id> が無効になっています。

  • 404 エラーが原因でアクションの実行に失敗した場合（is_success =false）

    • 無効にする Freshservice の報告者 <requester_id> が見つかりませんでした。

  • 405 エラーが原因でアクションの実行に失敗した場合（is_success =false）

    • freshservice の報告者 <requester_id> を無効にできませんでした。すでに無効になっている可能性があります。API レスポンス: 「message」: 「DELETE メソッドは許可されていません。メソッドは GET のいずれかにする必要があります。

アクションが失敗し、ハンドブックの実行が停止します。

間違った認証情報、サーバーへの接続なし、その他など、致命的なエラー、SDK エラーの場合::「アクション「リクエスト元の無効化」の実行エラー。理由: {0}」.format(error.Stacktrace)

 全般

チケットの時間エントリを一覧表示する

説明

指定された検索条件に基づいて、Freshservice チケットの時間エントリを一覧表示します。Google SecOps エンティティではアクションが機能しません。

パラメータ

パラメータの表示名 タイプ デフォルト値 必須 説明
チケット ID Integer なし はい 時間エントリを返すチケット ID を指定します。
Agent Email（エージェントのメールアドレス） 文字列 なし はい チケットの時間エントリを一覧表示するエージェントのメールアドレスを指定します。
1 ページあたりの行数 Integer 30 いいえ Freshservice のページネーションで 1 ページあたりに返すチケット時間エントリの数を指定します。
開始ページ Integer 1 いいえ Freshservice のページネーションでチケットのタイム エントリを返す開始ページを指定します。
返される最大行数 Integer 30 いいえ チケット時間エントリ アクションが返す合計数を指定します。

実行

このアクションはエンティティに対しては実行されません。

アクションの結果

スクリプトの結果
スクリプトの結果名 値のオプション
is_success is_success=False
is_success is_success=True
JSON の結果
{
   "time_entries": [
       {
           "id": 17000399635,
           "created_at": "2021-07-08T06:26:47Z",
           "updated_at": "2021-07-08T06:26:47Z",
           "start_time": "2021-07-08T06:26:47Z",
           "timer_running": false,
           "billable": true,
           "time_spent": "01:00",
           "executed_at": "2021-07-08T06:26:47Z",
           "task_id": null,
           "note": "test_entry2",
           "agent_id": 17002188556,
           "custom_fields": {}
       }
   ]
}
Case Wall
結果のタイプ 値 / 説明 タイプ
出力メッセージ *

アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。

  • チケットの時間エントリが見つかった場合（is_success = true）:
    「Freshservice チケット <ticket id> の時間エントリが正常に取得されました。」
  • チケットの時間エントリが返されなかった場合（is_success = false）:
    「チケット <チケット ID> のチケット時間エントリが見つかりませんでした」
  • 指定されたチケット ID が見つからなかった場合（is_success = false）:
    「Freshservice でチケット <ticket id> が見つかりませんでした。
  • 指定されたエージェントのメールアドレスに対応するエージェント ID が見つからなかった場合（is_success = false）:
    「Freshservice でエージェント <agent_email> が見つかりませんでした。
  • チケットのタイム エントリの取得で API エラーが発生した場合（is_success = false）: 「指定された入力パラメータを使用してチケットのタイム エントリの一覧を取得できませんでした。エラー: {API からのエラー}」

アクションが失敗し、ハンドブックの実行が停止します。

認証情報が誤っている、サーバーへの接続がないなど、致命的なエラーの場合、その他:

「アクション「チケットの時間エントリを一覧表示」の実行中にエラーが発生しました。理由: {0}」.format(error.Stacktrace)

 一般
テーブル

テーブル名: Freshservice チケット <チケット ID> の時間エントリ

テーブル列:

時間エントリ ID

Agent Email（エージェントのメールアドレス）

注

請求可能

かかった時間

タスク ID

カスタム フィールド

タイマー作動中

Created Time

更新日時

開始時刻

実行日時

 全般

チケットの時間エントリを追加する

説明

Freshservice チケットに時間エントリを追加します。Google SecOps エンティティではアクションが機能しません。

パラメータ

パラメータの表示名 タイプ デフォルト値 必須 説明
チケット ID Integer なし はい 時間エントリを追加するチケット ID を指定します。
Agent Email（エージェントのメールアドレス） 文字列 なし はい チケットのタイム エントリを追加するエージェントのメールアドレスを指定します。
注 文字列 なし いいえ チケットの時間エントリに追加するメモを指定します。
かかった時間 文字列 なし はい チケットの時間エントリに費やした時間を指定します。形式: {hh:mm}
請求可能 チェックボックス False いいえ 有効にすると、チケットの時間エントリが請求対象としてマークされます。
カスタム フィールド JSON なし いいえ

チケットの時間エントリに追加するカスタム フィールドを含む JSON オブジェクトを指定します。Acton は、チケットの既存のカスタム フィールドに新しいカスタム フィールドを追加します。形式例:

{"key1":"value1", "key2":"value2"}

実行

このアクションはエンティティに対しては実行されません。

アクションの結果

スクリプトの結果
スクリプトの結果名 値のオプション
is_success is_success=False
is_success is_success=True
JSON の結果
{
   "time_entry": {
       "id": 17000405061,
       "created_at": "2021-07-10T18:22:18Z",
       "updated_at": "2021-07-10T18:22:18Z",
       "start_time": "2021-07-10T18:22:18Z",
       "timer_running": false,
       "billable": true,
       "time_spent": "01:00",
       "executed_at": "2021-07-10T18:22:18Z",
       "task_id": null,
       "note": "test_entry3",
       "agent_id": 17002188556,
       "custom_fields": {
           "test": "very_test"
       }
   }
}
Case Wall
結果のタイプ 値 / 説明 タイプ
出力メッセージ *

アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。

  • アクションが正常に実行された場合:（is_success=true）

    • 新しい時間エントリがチケット <チケット ID> に追加されました。

  • 指定されたチケット ID が見つからなかった場合（is_success = false）:

    • 「チケット <チケット ID> が Freshservice に見つかりませんでした。

  • 指定されたエージェントのメールアドレスが見つからなかった場合（is_success = false）:

    • 「メールアドレス <agent_email> のエージェントが Freshservice に見つかりませんでした。

  • 指定された所要時間の形式が正しくない場合（is_success = false）:

    • 「指定された所要時間 <time_spent> の形式が正しくありません。'hh:mm' 形式で指定してください。

アクションが失敗し、ハンドブックの実行が停止します。

間違った認証情報、サーバーへの接続なし、その他など、致命的なエラー、SDK エラーの場合::「アクション「チケットの時間エントリを追加」の実行エラー。理由: {0}」.format(error.Stacktrace)

 全般

Update Ticket Time Entry（チケットの時間エントリを更新）

説明

Freshservice チケットの時間エントリを更新します。Google SecOps エンティティではアクションが機能しません。

パラメータ

パラメータの表示名 タイプ デフォルト値 必須 説明
チケット ID Integer なし はい 更新する時間エントリのチケット ID を指定します。
時間エントリ ID Integer なし はい 更新する時間エントリ ID を指定します。
Agent Email（エージェントのメールアドレス） 文字列 なし いいえ チケットの時間エントリを変更するエージェントのメールアドレスを指定します。
注 文字列 なし いいえ チケットの時間エントリのメモを指定します。
かかった時間 文字列 なし いいえ チケットの時間エントリに費やした時間を指定します。形式: {hh:mm}
請求可能 チェックボックス False（チェックされていない） いいえ 有効にすると、チケットの時間エントリが請求対象としてマークされます。
カスタム フィールド JSON なし いいえ

チケットの時間エントリに追加するカスタム フィールドを含む JSON オブジェクトを指定します。Acton は、チケットの既存のカスタム フィールドに新しいカスタム フィールドを追加します。形式例:

{"key1":"value1", "key2":"value2"}

実行

このアクションはエンティティに対しては実行されません。

アクションの結果

スクリプトの結果
スクリプトの結果名 値のオプション
is_success is_success=False
is_success is_success=True
JSON の結果
{
    "time_entry": {
        "id": 17000405061,
        "created_at": "2021-07-10T18:22:18Z",
        "updated_at": "2021-07-10T18:30:54Z",
        "start_time": "2021-07-10T18:22:18Z",
        "timer_running": false,
        "billable": false,
        "time_spent": "03:30",
        "executed_at": "2021-07-10T18:22:18Z",
        "task_id": null,
        "note": "test_entry_updated",
        "agent_id": 17002188556,
        "custom_fields": {
            "test": "very_test2"
        }
    }
}
Case Wall
結果のタイプ 値 / 説明 タイプ
出力メッセージ *

アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。

  • アクションが正常に実行された場合:（is_success=true）

    • チケット <ticket id> の時間エントリ <time_entry_id> が更新されました。

  • 指定されたチケット ID または時間エントリ ID が見つからなかった場合（is_success = false）:

    • 「指定されたチケット ID <ticket_id> または時間エントリ ID <time_entry id> が Freshservice で見つかりませんでした。

  • 指定されたエージェントのメールアドレスが見つからなかった場合（is_success = false）:

    • 「メールアドレス <agent_email> のエージェントが Freshservice に見つかりませんでした。

  • 指定された所要時間の形式が正しくない場合（is_success = false）:

    • 「指定された所要時間 <time_spent> の形式が正しくありません。'hh:mm' 形式で指定してください。

アクションが失敗し、ハンドブックの実行が停止します。

間違った認証情報、サーバーへの接続なし、その他など、致命的なエラー、SDK エラーの場合::「アクション「チケットの時間エントリの更新」の実行エラー。理由: {0}」.format(error.Stacktrace)

 全般

Delete Ticket Time Entry（チケットの時間エントリを削除）

説明

Freshservice チケットの時間エントリを削除します。Google SecOps エンティティではアクションが機能しません。

パラメータ

パラメータの表示名 タイプ デフォルト値 必須 説明
チケット ID Integer なし はい 削除する時間エントリのチケット ID を指定します。
時間エントリ ID Integer なし はい 削除する時間エントリ ID を指定します。

実行

このアクションはエンティティに対しては実行されません。

アクションの結果

スクリプトの結果
スクリプトの結果名 値のオプション
is_success is_success=False
is_success is_success=True
ケースウォール
結果のタイプ 値 / 説明 タイプ
出力メッセージ *

アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。

  • アクションが正常に実行された場合:（is_success=true）

    • チケット <ticket id> の時間エントリ <time_entry_id> が削除されました。

  • 指定されたチケット ID または時間エントリ ID が見つからなかった場合（is_success = false）:

    • 「Provided ticket id <ticket_id> or time entry id <time_entry id> was not found in Freshservice（指定されたチケット ID <ticket_id> または時間エントリ ID <time_entry id> が Freshservice で見つかりませんでした）」

アクションが失敗し、ハンドブックの実行が停止します。

間違った認証情報、サーバーへの接続なし、その他など、致命的なエラー、SDK エラーの場合::「アクション「チケットの時間エントリの削除」の実行エラー。理由: {0}」.format(error.Stacktrace)

 一般

コネクタ

Freshservice Tickets Connector

説明

コネクタを使用して Freshservice チケットを取得し、そこから Google SecOps アラートを作成できます。コネクタのホワイトリストを使用すると、特定のタイプのチケット（インシデントまたはサービス リクエスト）のみを取り込むことができます。

Google SecOps で Freshservice Tickets Connector を構成する

Google SecOps でコネクタを構成する方法の詳細については、コネクタの構成をご覧ください。

コネクタ パラメータ

次のパラメータを使用してコネクタを構成します。

パラメータの表示名 種類 デフォルト値 必須 説明
プロダクト フィールド名 文字列 Freshworks Freshservice はい
イベント フィールド名 文字列 "type" はい
環境フィールド名 文字列 "" いいえ いいえ
環境の正規表現パターン 文字列 .* いいえ いいえ
API ルート 文字列

https://yourdomain.freshservice.com

 はい Freshservice インスタンスの API ルート URL。
API キー パスワード なし はい 統合で使用する Freshservice API キー。
SSL を確認する チェックボックス オン いいえ 有効になっている場合、統合はルート URL が有効な証明書で構成されているかどうかを検証しようとします。
オフセット時間（時間） 整数 24 はい X 時間前から遡ってチケットを取得します。
1 サイクルあたりの最大チケット数 Integer 30 はい 1 回のコネクタ実行で処理するチケットの数。
取得する最小優先度 文字列 中 いいえ Google SecOps に取り込むチケットの最小優先度（低、中など）。有効な値: Low、Medium、High、Urgent
取得するチケットのステータス CSV 営業中、休業中 いいえ Google SecOps に取り込むチケット ステータス。このパラメータは、カンマ区切りの文字列として複数の値を受け入れます。有効な値: Open、Pending、Resolved、Closed
許可リストを拒否リストとして使用 チェックボックス オフ ○ 有効にすると、許可リストが拒否リストとして使用されます。

コネクタ ルール

プロキシのサポート

コネクタでプロキシがサポートされます。

ジョブ

Freshservice Sync Tickets Closure Job

説明

対応する Google Security Operations SOAR アラートが閉じられた場合、Freshservice でチケットを閉じます。

パラメータ

パラメータの表示名 タイプ デフォルト値 必須 Description
API ルート 文字列 https://yourdomain.freshservice.com はい Freshservice インスタンスの API ルート URL。
API キー パスワード なし はい 統合で使用する Freshservice API キー。
SSL を確認する チェックボックス オン いいえ 有効になっている場合、統合はルート URL が有効な証明書で構成されているかどうかを検証しようとします。
オフセット時間（時間） 整数 24 はい X 時間前から遡ってチケットのクローズを同期します。
チケットのデフォルトの説明 文字列 チケットは、Siemplify Freshservice Sync Tickets Closure Job によってクローズされます。 はい チケットに説明がない場合にチケットに追加する説明を指定します。Freshservice では説明フィールドが必須であるため、この説明を追加することで Freshservice でチケットをクローズできます。

Freshservice Sync Tickets Conversations Job

説明

Google SecOps アラートのケースと対応する Freshservice チケットの間で会話（返信とメモの両方）を同期します。同期メカニズムは、Google SecOps → Freshservice と Freshservice → Google SecOps の両方向で機能します。

パラメータ

パラメータの表示名 タイプ デフォルト値 必須 Description
API ルート 文字列 https://yourdomain.freshservice.com はい Freshservice インスタンスの API ルート URL。
API キー パスワード なし はい 統合で使用する Freshservice API キー。
SSL を確認する チェックボックス オン いいえ 有効になっている場合、統合はルート URL が有効な証明書で構成されているかどうかを検証しようとします。
オフセット時間（時間） 整数 24 はい X 時間前から遡ってチケットの会話を同期する
Siemplify のコメントの接頭辞 文字列 SIEMPLIFY: はい 同期ジョブによって Freshservice チケット用に作成されたコメントに追加される接頭辞。
Freshservice コメントの接頭辞 文字列 Freshservice のコメント同期ジョブ: はい 同期ジョブによって Google SecOps アラートのケース コメントに追加される接頭辞。
同期する会話の種類 CSV Replies、Notes はい Freshservice の会話タイプを指定します。このパラメータは、カンマ区切りの文字列として複数の値を受け入れます。
非公開メモを取得しますか？ チェックボックス チェックボックスがオフ（false） いいえ 有効にすると、関連する Freshservice チケットの公開メモと非公開メモの両方が取得されます。
Siemplify からのコメントを X として同期する 文字列 非公開メモ はい Google SecOps からコメントを追加するために使用する会話タイプのジョブを指定します。有効な値: Private Note、Public Note、Reply。

さらにサポートが必要な場合 コミュニティ メンバーや Google SecOps のプロフェッショナルから回答を得ることができます。