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 中配置集成的详细说明，请参阅配置集成。

集成参数

使用以下参数配置集成：

参数显示名称	类型	默认值	是必填字段	说明
API 根	字符串	https://yourdomain.freshservice.com	是	Freshservice 实例 API 根网址。
API 密钥	密码	不适用	是	要在集成中使用的 Freshservice API 密钥。
验证 SSL	复选框	勾选	否	如果启用，集成会验证根网址是否配置了有效证书。

注意： 如果需要，您可以在稍后阶段进行更改。配置完成后，您可以在 playbook 中使用实例。如需详细了解如何配置和支持多个实例，请参阅支持多个实例。

操作

Ping

说明

使用 Google Security Operations Marketplace 标签页中的集成配置页面上提供的参数，测试与 Freshservice 实例的连接。

运行于

此操作不会在实体上运行。

操作执行结果

脚本结果

脚本结果名称	值选项
is_success	is_success=False
is_success	is_success=True

案例墙

结果类型	值 / 说明	类型
输出消息*	操作不应失败，也不应停止 playbook 执行： 如果成功：“已使用提供的连接参数成功连接到 Freshservice 实例！” 如果出现严重错误（例如凭据错误或连接丢失），操作应失败并停止 playbook 执行：“Failed to connect to the Freshservice instance! 错误为 {0}".format(exception.stacktrace)	常规

列出车票

说明

根据指定的搜索条件列出 Freshservice 工单。请注意，此操作不适用于 Google SecOps 实体。

参数

参数显示名称	类型	默认值	是必填字段	说明
票卡类型	DDL	全部	否	指定要返回的工单类型。
请求者	字符串	不适用	否	指定要返回的支持请求的请求者电子邮件地址。
包含统计数据	复选框	尚未核查	否	如果启用，操作将返回有关工单的其他统计信息。
搜索过去 X 小时	整数	不适用	否	指定要搜索门票的时间范围。
每页行数	整数	30	否	指定 Freshservice 分页中每页应返回的工单数量。
从指定页开始	整数	1	否	指定应从哪个页面开始返回工单（使用 Freshservice 分页）。
要返回的行数上限	整数	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": "[e-mail]",
                "id": 17000032840,
                "mobile": "[e-mail]",
                "name": "Dana",
                "phone": null
            }
        }
    ]
}

案例墙

结果类型	值/说明	类型
输出消息*	操作不应失败，也不应停止 playbook 执行： 如果找到工单（is_success = true）：“已成功提取 Freshservice 工单。” 如果没有返回任何机票（is_success = false）：“未找到符合所提供输入参数的机票。” 如果获取工单时遇到 API 错误 (is_success = false)：“Failed to list tickets with the provided input parameters. 错误为：{来自 API 的错误}" 操作应失败并停止 playbook 执行： 如果出现严重错误，例如凭据错误、无法连接到服务器、其他错误：“执行操作‘列出支持请求’时出错。原因：{0}''.format(error.Stacktrace)	常规
表	表格名称：Freshservice Tickets Found 表格列： ID 类型 主题 说明 请求者的电子邮件地址 类别 状态 优先级 来源 创建日期 更新日期 截止日期 已上报 已删除	常规

创建工单

说明

创建 Freshservice 工单。

注意： 目前，Freshservice API 仅支持创建类型为“Incident”的支持请求。

参数

参数显示名称	类型	默认值	是必填字段	说明
主题	字符串	不适用	是	为创建的工单指定主题字段。
说明	字符串	不适用	是	为创建的工单指定说明字段。
请求者的电子邮件地址	字符串	不适用	是	为创建的工单指定请求者的电子邮件地址。
代理分配给	字符串	不适用	否	指定要将工单分配给的客服人员电子邮件地址。
群组分配对象	字符串	不适用	否	指定要将工单分配到的群组名称。
优先级	DDL	中	是	指定要分配给工单的优先级。
紧急情况	DDL	中	否	指定要分配给工单的紧急程度。
影响	DDL	中	否	指定要分配给工单的影响程度。
标记	字符串	不适用	否	指定要分配给工单的标记。参数接受多个值，这些值以英文逗号分隔的字符串形式表示。
自定义字段	JSON	不适用	否	指定一个 JSON 对象，其中包含要添加到工单的自定义字段。Acton 会将新的自定义字段附加到工单的任何现有自定义字段中。示例格式： {"key1":"value1", "key2":"value2"}
要添加的文件附件	字符串 (CSV)	不适用	否	指定要随工单一起上传的文件的完整路径。参数接受多个值，这些值以英文逗号分隔的字符串形式提供。附件的总大小不得超过 15MB。

运行于

此操作不会在实体上运行。

操作执行结果

脚本结果

脚本结果名称	值选项
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": []
    }
}

案例墙

结果类型	值/说明	类型
输出消息*	操作不应失败，也不应停止 playbook 执行： 如果操作成功运行（is_success=true）：系统会创建新的 Freshservice 支持请求。 如果因提供的参数而导致操作运行失败（is_success =false）：无法使用提供的参数创建新工单，错误为：<错误文本>。 操作应失败并停止 playbook 执行： 如果出现严重错误、SDK 错误（例如凭据错误、无法连接到服务器、其他错误）：“执行操作‘创建支持请求’时出错。原因：{0}''.format(error.Stacktrace)	常规

更新票券

说明

根据提供的操作输入参数更新 Freshservice 工单。请注意，如果为工单提供了新标签，由于 Freshservice API 存在限制，该操作会替换工单中的现有标签，而不是将新标签附加到现有标签。

参数

参数显示名称	类型	默认值	是必填字段	说明
工单 ID	整数	不适用	是	指定要更新的工单 ID。
状态	DDL	未更改	否	为工单指定新状态。
主题	字符串	不适用	否	指定要更新的主题字段。
说明	字符串	不适用	否	指定要更新的说明字段。
请求者的电子邮件地址	字符串	不适用	否	指定要更新的请求者电子邮件地址。
代理分配给	字符串	不适用	否	指定要更新的代理电子邮件地址。
群组分配对象	字符串	不适用	否	指定要更新的群组名称。
优先级	DDL	未更改	否	指定要更新的优先级。
紧急情况	DDL	未更改	否	指定更新的紧急程度。
影响	DDL	未更改	否	指定要更新的影响。
标记	字符串	不适用	否	指定要在工单中替换的标记。参数接受多个值，这些值以英文逗号分隔的字符串形式提供。请注意，由于 Freshservice API 存在限制，此操作会替换工单中的现有标记，而不是将新标记附加到现有标记。
自定义字段	JSON	不适用	否	指定一个 JSON 对象，其中包含要添加到工单的自定义字段。Acton 会将新的自定义字段附加到工单的任何现有自定义字段中。示例格式： {"key1":"value1", "key2":"value2"}
要添加的文件附件	字符串 (CSV)	不适用	否	指定要随工单一起上传的文件的完整路径。参数接受多个值，这些值以英文逗号分隔的字符串形式提供。附件的总大小不得超过 15MB。

运行于

此操作不会在实体上运行。

操作执行结果

脚本结果

脚本结果名称	值选项
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": []
    }
}

案例墙

结果类型	值/说明	类型
输出消息*	操作不应失败，也不应停止 playbook 执行： 如果操作成功运行 (is_success=true)： Freshservice 工单 <工单 ID> 已更新。 如果操作因提供的参数而未能成功运行（is_success =false） 未能使用提供的参数更新工单 <ticket_id>，错误为：<error text>。 操作应失败并停止 playbook 执行： 如果出现严重错误、SDK 错误（例如凭据错误、无法连接到服务器）或其他错误：“Error executing action "Update Ticket". 原因：{0}''.format(error.Stacktrace)	常规

列出支持请求对话

说明

根据指定的搜索条件列出 Freshservice 工单对话。 请注意，此操作不适用于 Google SecOps 实体。

参数

参数显示名称	类型	默认值	是必填字段	说明
工单 ID	整数	不适用	是	指定要返回对话的工单 ID。
每页行数	整数	30	否	指定 Freshservice 分页中每页应返回多少个支持请求对话。
从指定页开始	整数	1	否	指定应从哪个页面开始返回工单对话（使用 Freshservice 分页）。
要返回的行数上限	整数	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": [
                "[e-mail]"
            ],
            "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": "[e-mail]",
            "source": 0,
            "from_email": "[e-mail]",
            "cc_emails": [],
            "bcc_emails": [],
            "attachments": []
        }
    ],
    "meta": {
        "count": 2
    }
}

案例墙

结果类型	值/说明	类型
输出消息*	操作不应失败，也不应停止 playbook 执行： 如果找到支持请求对话（is_success = true）： “已成功提取 Freshservice 支持请求 <支持请求 ID> 对话。” 如果未返回任何支持请求对话（is_success = false）： “未找到支持请求 <ticket id> 的任何对话” 如果未找到提供的工单 ID（is_success = false）： “未在 Freshservice 中找到工单 <工单 ID>。 如果获取支持请求时遇到 API 错误 (is_success = false)：“Failed to list ticket conversations with the provided input parameters. 错误为：{来自 API 的错误}" 操作应失败并停止 playbook 执行： 如果出现严重错误，例如凭据错误、无法连接到服务器、其他错误： “执行操作‘列出支持请求对话’时出错。原因：{0}''.format(error.Stacktrace)	常规
表	表格名称：Freshservice 工单 <工单 ID> 对话 表格列： ID 类型 公开范围 用户电子邮件 文本 来自电子邮件 收件人电子邮件地址 电子邮件抄送地址 密送电子邮件地址	常规

添加支持请求回复

说明

向 Freshservice 工单添加回复。请注意，此操作不适用于 Google SecOps 实体。

参数

参数显示名称	类型	默认值	是必填字段	说明
工单 ID	整数	不适用	是	指定要返回对话的工单 ID。
回复文本	字符串	不适用	是	指定要添加到工单中的回复文本。

运行于

此操作不会在实体上运行。

操作执行结果

脚本结果

脚本结果名称	值选项
is_success	is_success=False
is_success	is_success=True

JSON 结果

    "conversation": {
        "id": 17014998560,
        "user_id": 17000032840,
        "from_email": "[e-mail]",
        "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": [
            "[e-mail]"
        ],
        "attachments": [],
        "created_at": "2021-07-05T09:19:02Z",
        "updated_at": "2021-07-05T09:19:02Z"
    }
}

案例墙

结果类型	值/说明	类型
输出消息*	操作不应失败，也不应停止 playbook 执行： 如果操作成功运行 (is_success=true)： 工单 <ticket id> 中添加了新的回复。 如果未找到提供的支持请求 ID (is_success = false)： “在 Freshservice 中找不到工单 <工单 ID>。 操作应失败并停止 playbook 执行： 如果出现严重错误、SDK 错误（例如凭据错误、无法连接到服务器、其他错误）：“执行操作‘添加支持请求回复’时出错。原因：{0}''.format(error.Stacktrace)	常规

添加工单备注

说明

向 Freshservice 工单添加备注。请注意，此操作不适用于 Google SecOps 实体。

参数

参数显示名称	类型	默认值	是必填字段	说明
工单 ID	整数	不适用	是	指定要返回对话的工单 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"
    }
}

案例墙

结果类型	值/说明	类型
输出消息*	操作不应失败，也不应停止 playbook 执行： 如果操作成功运行 (is_success=true)： 已向工单 <ticket id> 添加新的 <note type> 注释。 如果未找到提供的支持请求 ID (is_success = false)： “在 Freshservice 中找不到工单 <工单 ID>。 操作应失败并停止 playbook 执行： 如果出现严重错误、SDK 错误（例如凭据错误、无法连接到服务器、其他错误）：“Error executing action "Add a Ticket Note". 原因：{0}''.format(error.Stacktrace)	常规

列出代理

说明

根据指定的搜索条件列出 Freshservice 客服人员。请注意，此操作不适用于 Google SecOps 实体。

参数

参数显示名称	类型	默认值	是必填字段	说明
客服人员电子邮件地址	字符串	不适用	否	指定要返回哪些客服记录对应的电子邮件地址。
代理状态	DDL	全部	否	指定要返回的代理状态。
包含非空闲的客服人员	复选框	尚未核查	否	如果启用，结果将包含非活跃代理记录。
每页行数	整数	30	否	指定每页应返回多少个客服记录，以用于 Freshservice 分页。
从指定页开始	整数	1	否	指定应从哪个页面开始返回代理记录（使用 Freshservice 分页）。
要返回的行数上限	整数	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": "[e-mail]",
            "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": []
        },

案例墙

结果类型	值/说明	类型
输出消息*	操作不应失败，也不应停止 playbook 执行： 如果找到代理（is_success = true）：“已成功提取 Freshservice 代理。” 如果未返回任何代理（is_success = false）：“未找到与所提供输入参数匹配的代理。” 如果获取代理时遇到 API 错误（is_success = false）：“未能使用提供的输入参数列出代理。错误为：{来自 API 的错误}" 操作应失败并停止 playbook 执行： 如果出现严重错误，例如凭据错误、无法连接到服务器、其他错误： “执行操作‘列出代理’时出错。原因：{0}''.format(error.Stacktrace)	常规
表	表格名称：Freshservice Agents Found 表格列： ID 电子邮件 名字 姓氏 角色 群组 部门 位置 有效 偶尔 自定义字段 创建日期 更新日期 上次活跃日期 上次登录日期	常规

列出请求者

说明

根据指定的搜索条件列出在 Freshservice 中注册的请求者。请注意，此操作不适用于 Google SecOps 实体。

参数

参数显示名称	类型	默认值	是必填字段	说明
请求者的电子邮件地址	字符串	不适用	否	指定要返回哪些请求者的记录所对应的电子邮件地址。
每页行数	整数	30	否	指定每页应返回多少个客服记录，以用于 Freshservice 分页。
从指定页开始	整数	1	否	指定应从哪个页面开始返回代理记录（使用 Freshservice 分页）。
要返回的行数上限	整数	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": "[e-mail]",
            "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
        }
    ]
}

案例墙

结果类型	值/说明	类型
输出消息*	操作不应失败，也不应停止 playbook 执行： 如果找到请求者（is_success = true）： “已成功提取 Freshservice 注册的请求者。” 如果没有返回请求者（is_success = false）： “未找到与所提供输入参数对应的请求者。” 如果获取请求者的 API 出错（is_success = false）：“无法使用提供的输入参数列出请求者。错误为：{来自 API 的错误}" 操作应失败并停止 playbook 执行： 如果出现严重错误，例如凭据错误、无法连接到服务器、其他错误： “执行操作‘列出请求者’时出错。原因：{0}''.format(error.Stacktrace)	常规
表	表格名称：Freshservice Requester Found 表格列： ID 电子邮件 名字 姓氏 部门 位置 有效 自定义字段 创建日期 更新日期	常规

创建代理

说明

创建新的 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": "[e-mail]",
        "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": []
    }
}

案例墙

结果类型	值/说明	类型
输出消息*	操作不应失败，也不应停止 playbook 执行： 如果操作成功运行 (is_success=true)： 已创建新的 Freshservice 代理。 如果操作因提供的参数而未能成功运行（is_success =false） 未能使用提供的参数创建新代理，错误为：<错误文本>。 操作应失败并停止 playbook 执行： 如果出现严重错误、SDK 错误（例如凭据错误、无法连接到服务器）或其他错误：“执行操作‘创建代理’时出错。原因：{0}''.format(error.Stacktrace)	常规

更新代理

说明

更新现有 Freshservice 客服人员。请注意，此操作不适用于 Google SecOps 实体。

参数

参数显示名称	类型	默认值	是必填字段	说明
代理 ID	整数	不适用	是	指定要更新的代理 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": "[e-mail]",
        "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": []
    }
}

案例墙

结果类型	值/说明	类型
输出消息*	操作不应失败，也不应停止 playbook 执行： 如果操作成功运行 (is_success=true)： Freshservice 代理 <agent_id> 已更新。 如果操作因提供的参数而未能成功运行（is_success =false） 未能使用提供的参数更新 Freshservice 客服人员 <agent_id>，错误为：<error text>。 操作应失败并停止 playbook 执行： 如果出现严重错误、SDK 错误（例如凭据错误、无法连接到服务器、其他错误）：“执行操作‘更新代理’时出错。原因：{0}''.format(error.Stacktrace)	常规

停用代理

说明

停用 Freshservice 代理。请注意，此操作不适用于 Google SecOps 实体。

参数

参数显示名称	类型	默认值	是必填字段	说明
代理 ID	整数	不适用	是	指定要停用的代理 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": "[e-mail]",
        "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": []
    }
}

案例墙

结果类型	值/说明	类型
输出消息*	操作不应失败，也不应停止 playbook 执行： 如果操作成功运行 (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”：“您无权执行此操作。” 操作应失败并停止 playbook 执行： 如果出现严重错误、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": "[e-mail]",
        "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
    }
}

案例墙

结果类型	值/说明	类型
输出消息*	操作不应失败，也不应停止 playbook 执行： 如果操作成功运行 (is_success=true)： 已创建新的 Freshservice 请求者。 如果操作因提供的参数而未能成功运行（is_success =false） 未能使用提供的参数创建新的请求者，错误为：<错误文本>。 操作应失败并停止 playbook 执行： 如果出现严重错误、SDK 错误（例如凭据错误、无法连接到服务器）或其他错误：“执行操作‘创建请求者’时出错。原因：{0}''.format(error.Stacktrace)	常规

更新请求者

说明

更新现有 Freshservice 请求者。请注意，此操作不适用于 Google SecOps 实体。

参数

参数显示名称	类型	默认值	是必填字段	说明
请求者 ID	整数	不适用	是	指定要更新的请求者 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": "[e-mail]",
        "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": []
    }
}

案例墙

结果类型	值/说明	类型
输出消息*	操作不应失败，也不应停止 playbook 执行： 如果操作成功运行 (is_success=true)： Freshservice 请求者 <requester_id> 已更新。 如果操作因提供的参数而未能成功运行（is_success =false） 未能使用提供的参数更新 Freshservice 请求者 <requester_id>，错误为：<error text>。 操作应失败并停止 playbook 执行： 如果出现严重错误、SDK 错误（例如凭据错误、无法连接到服务器）或其他错误：“执行操作‘更新请求者’时出错。原因：{0}''.format(error.Stacktrace)	常规

停用请求者

说明

停用 Freshservice 请求者。请注意，此操作不适用于 Google SecOps 实体。

参数

参数显示名称	类型	默认值	是必填字段	说明
请求者 ID	整数	不适用	是	指定要停用的请求者 ID。

运行于

此操作不会在实体上运行。

操作执行结果

脚本结果

脚本结果名称	值选项
is_success	is_success=False
is_success	is_success=True

案例墙

结果类型	值/说明	类型
输出消息*	操作不应失败，也不应停止 playbook 执行： 如果操作成功运行 (is_success=true)： Freshservice 请求者 <requester_id> 已停用。 如果因 404 错误而导致操作未能运行 (is_success =false) 未能找到要停用的 Freshservice 请求者 <requester_id>。 如果因 405 错误导致操作运行失败 (is_success =false) 无法停用 Freshservice 请求者 <requester_id>，可能是因为该请求者已被停用？API 响应：“message”：“不允许使用 DELETE 方法。应为以下方法之一：GET 操作应失败并停止 playbook 执行： 如果出现严重错误、SDK 错误（例如凭据错误、无法连接到服务器）或其他错误：“执行操作‘停用请求者’时出错。原因：{0}''.format(error.Stacktrace)	常规

列出工单时间条目

说明

根据指定的搜索条件列出 Freshservice 工单时间条目。 请注意，此操作不适用于 Google SecOps 实体。

参数

参数显示名称	类型	默认值	是必填字段	说明
工单 ID	整数	不适用	是	指定要返回时间条目的工单 ID。
客服人员电子邮件地址	字符串	不适用	是	指定代理的电子邮件地址，以列出相应支持请求的时间条目。
每页行数	整数	30	否	指定每页应返回多少个工单时间条目，以用于 Freshservice 分页。
从指定页开始	整数	1	否	指定应从哪个页面开始返回工单时间条目（使用 Freshservice 分页）。
要返回的行数上限	整数	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": {}
       }
   ]
}

案例墙

结果类型	值/说明	类型
输出消息*	操作不应失败，也不应停止 playbook 执行： 如果找到工单时间条目（is_success = true）： “Successfully fetched Freshservice ticket<ticket id > time entries.”（已成功提取 Freshservice 工单<工单 ID> 时间条目。） 如果未返回任何工单时间条目 (is_success = false)： “未找到工单 <工单 ID> 的任何工单时间条目” 如果未找到提供的工单 ID（is_success = false）： “未在 Freshservice 中找到工单 <工单 ID>。 如果未找到所提供代理电子邮件地址对应的代理 ID (is_success = false)： “在 Freshservice 中未找到代理 <agent_email>。 如果获取工单时间条目时遇到 API 错误 (is_success = false)：“未能使用提供的输入参数列出工单时间条目。错误为：{来自 API 的错误}" 操作应失败并停止 playbook 执行： 如果出现严重错误，例如凭据错误、无法连接到服务器、其他错误： “执行操作‘列出工单时间条目’时出错。原因：{0}''.format(error.Stacktrace)	常规
表	表格名称：Freshservice 工单 <工单 ID> 时间条目 表格列： 时间条目 ID 客服人员电子邮件地址 注意 计费部分 用时 任务 ID 自定义字段 计时器正在运行 创建时间 更新时间 开始时间 执行时间	常规

添加门票时间条目

说明

向 Freshservice 工单添加时间条目。请注意，此操作不适用于 Google SecOps 实体。

参数

参数显示名称	类型	默认值	是必填字段	说明
工单 ID	整数	不适用	是	指定要为其添加时间条目的支持请求 ID。
客服人员电子邮件地址	字符串	不适用	是	指定要为其添加工单时间条目的客服人员电子邮件地址。
注意	字符串	不适用	否	指定要添加到工单时间条目的备注。
用时	字符串	不适用	是	指定工单时间条目的时间花费。格式：{hh:mm}
计费部分	复选框	错误	否	如果启用，工单时间条目将标记为可结算。
自定义字段	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"
       }
   }
}

案例墙

结果类型	值/说明	类型
输出消息*	操作不应失败，也不应停止 playbook 执行： 如果操作成功运行 (is_success=true)： 已向工单 <工单 ID> 添加新的时间条目。 如果未找到提供的支持请求 ID (is_success = false)： “在 Freshservice 中找不到工单 <工单 ID>。 如果找不到提供的代理电子邮件地址（is_success = false）： “在 Freshservice 中找不到电子邮件地址为 <agent_email> 的代理。 如果提供的时间花费格式有误（is_success = false）： “指定的时间支出值 <time_spent> 格式不正确，应采用‘hh:mm’格式。 操作应失败并停止 playbook 执行： 如果出现严重错误、SDK 错误（例如凭据错误、无法连接到服务器）或其他错误：“Error executing action "Add Ticket Time Entry". 原因：{0}''.format(error.Stacktrace)	常规

更新工单时间条目

说明

更新 Freshservice 工单的时间条目。请注意，此操作不适用于 Google SecOps 实体

参数

参数显示名称	类型	默认值	是必填字段	说明
工单 ID	整数	不适用	是	指定要更新的时间条目的工单 ID。
时间条目 ID	整数	不适用	是	指定要更新的时间条目 ID。
客服人员电子邮件地址	字符串	不适用	否	指定要更改工单时间条目的客服人员电子邮件地址。
注意	字符串	不适用	否	为工单时间条目指定备注。
用时	字符串	不适用	否	指定工单时间条目的时间花费。格式：{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"
        }
    }
}

案例墙

结果类型	值/说明	类型
输出消息*	操作不应失败，也不应停止 playbook 执行： 如果操作成功运行 (is_success=true)： 工单 <ticket id> 的时间条目 <time_entry_id> 已更新。 如果找不到提供的工单 ID 或时间条目 ID（is_success = false）： “在 Freshservice 中找不到提供的工单 ID <ticket_id> 或时间条目 ID <time_entry id>。 如果找不到提供的代理电子邮件地址（is_success = false）： “在 Freshservice 中找不到电子邮件地址为 <agent_email> 的代理。 如果提供的时间花费格式有误（is_success = false）： “指定的时间支出值 <time_spent> 格式不正确，应采用‘hh:mm’格式。 操作应失败并停止 playbook 执行： 如果出现严重错误、SDK 错误（例如凭据错误、无法连接到服务器）或其他错误：“Error executing action "Update Ticket Time Entry". 原因：{0}''.format(error.Stacktrace)	常规

删除工单时间条目

说明

删除 Freshservice 工单的时间条目。请注意，此操作不适用于 Google SecOps 实体。

参数

参数显示名称	类型	默认值	是必填字段	说明
工单 ID	整数	不适用	是	指定要删除的时间条目的工单 ID。
时间条目 ID	整数	不适用	是	指定要删除的时间条目的 ID。

运行于

此操作不会在实体上运行。

操作执行结果

脚本结果

脚本结果名称	值选项
is_success	is_success=False
is_success	is_success=True

案例墙

结果类型	值/说明	类型
输出消息*	操作不应失败，也不应停止 playbook 执行： 如果操作成功运行 (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 操作应失败并停止 playbook 执行： 如果出现严重错误、SDK 错误（例如凭据错误、无法连接到服务器）或其他错误：“Error executing action "Delete Ticket Time Entry". 原因：{0}''.format(error.Stacktrace)	常规

连接器

Freshservice Tickets 连接器

说明

连接器可用于提取 Freshservice 工单，以便从中创建 Google SecOps 提醒。连接器许可名单可用于仅注入特定类型的支持请求 - 突发事件或服务请求。

注意： Google SecOps 版本 5.6.0-5.6.2 存在一个问题，会影响连接器的功能。为确保连接器正常运行，请将 Google SecOps 升级到 5.6.2 Hot Fix 3 或更高版本。

在 Google SecOps 中配置 Freshservice Tickets 连接器

有关如何在 Google SecOps 中配置连接器的详细说明，请参阅配置连接器。

连接器参数

使用以下参数配置连接器：

参数显示名称	类型	默认值	是否为必需属性	说明
商品字段名称	字符串	Freshworks Freshservice	是
事件字段名称	字符串	“type”	是
环境字段名称	字符串	""	否	否
环境正则表达式模式	字符串	.*	否	否
API 根	字符串	https://yourdomain.freshservice.com	是	Freshservice 实例 API 根网址。
API 密钥	密码	不适用	是	要在集成中使用的 Freshservice API 密钥。
验证 SSL	复选框	勾选	否	如果启用，集成将尝试验证根网址是否配置了有效证书。
偏移时间（以小时为单位）	整数	24	是	从 X 小时前开始提取工单。
每个周期最多可创建的工单数	整数	30	是	一次连接器运行期间应处理的工单数量。
提取的最低优先级	字符串	中	否	要提取到 Google SecOps 的工单的最低优先级，例如“低”或“中”。可能的值：低、中、高、紧急
要提取的票卡状态	CSV	开放/关闭	否	要注入到 Google SecOps 的工单状态。参数接受多个值，这些值以英文逗号分隔的字符串形式提供。可能的值：Open、Pending、Resolved、Closed
将白名单用作黑名单	复选框	尚未核查	是	如果启用，白名单将用作黑名单。

连接器规则

代理支持

连接器支持代理。

作业

Freshservice 同步工单关闭作业

说明

如果相应的 Google Security Operations SOAR 警报已关闭，则在 Freshservice 中关闭工单。

注意： 此作业仅支持带有 "Freshservice" 标记的 Google SecOps SOAR 支持请求。

参数

参数显示名称	类型	默认值	是必填字段	说明
API 根	字符串	https://yourdomain.freshservice.com	是	Freshservice 实例 API 根网址。
API 密钥	密码	不适用	是	要在集成中使用的 Freshservice API 密钥。
验证 SSL	复选框	勾选	否	如果启用，集成将尝试验证根网址是否配置了有效证书。
偏移时间（以小时为单位）	整数	24	是	同步 X 小时前的工单关闭情况。
默认支持请求说明	字符串	工单由 Siemplify Freshservice 同步工单关闭作业关闭。	是	指定应添加到工单的说明（如果工单没有说明），以便在 Freshservice 中关闭工单，因为 Freshservice 的说明字段是强制性的。

Freshservice 同步工单对话作业

说明

在 Google SecOps 提醒的支持请求与相应的 Freshservice 工单之间同步对话（包括回复和备注）。同步机制支持双向同步，即 Google SecOps → Freshservice 和 Freshservice → Google SecOps。

注意： 此作业仅支持带有“Freshservice”标记的 Google SecOps 支持请求。

参数

参数显示名称	类型	默认值	是必填字段	说明
API 根	字符串	https://yourdomain.freshservice.com	是	Freshservice 实例 API 根网址。
API 密钥	密码	不适用	是	要在集成中使用的 Freshservice API 密钥。
验证 SSL	复选框	勾选	否	如果启用，集成将尝试验证根网址是否配置了有效证书。
偏移时间（以小时为单位）	整数	24	是	同步 X 小时前的支持请求对话
Siemplify 注释前缀	字符串	SIEMPLIFY：	是	同步作业将添加到为 Freshservice 工单创建的评论的前缀。
Freshservice 评论前缀	字符串	Freshservice 评论同步作业：	是	同步作业将添加到 Google SecOps 提醒的工单评论中的前缀。
要同步的对话类型	CSV	回复、备注	是	指定 Freshservice 对话类型作业应同步。参数接受多个值，这些值以英文逗号分隔的字符串形式表示。
要提取私密笔记吗？	复选框	复选框未选中 (false)	否	如果启用，系统将提取相关 Freshservice 工单的公开和不公开备注。
将 Siemplify 中的评论同步为 X	字符串	不公开备注	是	指定对话类型作业应使用哪种方式来添加来自 Google SecOps 的评论。可能的值：Private Note、Public Note、Reply。

需要更多帮助？从社区成员和 Google SecOps 专业人士那里获得解答。