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이 유효한 인증서로 구성되었는지 확인합니다.

작업

핑

설명

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시간 검색 정수 해당 사항 없음 아니요 티켓을 검색할 기간을 지정합니다.
페이지당 행 수 정수 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": "dana@example.com",
                "id": 17000032840,
                "mobile": "dana@example.com",
                "name": "Dana",
                "phone": null
            }
        }
    ]
}
케이스 월
결과 유형 값/설명 유형
출력 메시지*

작업이 실패하거나 플레이북 실행을 중지하지 않습니다.

  • 티켓이 발견된 경우 (is_success = true): 'Freshservice 티켓을 가져왔습니다.'
  • 티켓이 반환되지 않은 경우 (is_success = false): '제공된 입력 매개변수에 대한 티켓이 없습니다.'
  • 티켓을 가져오는 중 API 오류가 발생한 경우 (is_success = false): '제공된 입력 매개변수로 티켓을 나열할 수 없습니다. 오류는 {API의 오류}입니다.'

작업이 실패하고 플레이북 실행을 중지합니다.

잘못된 사용자 인증 정보, 서버 연결 없음 등 치명적인 오류가 있는 경우: ''티켓 목록' 작업을 실행하는 중에 오류가 발생했습니다. 이유: {0}'.format(error.Stacktrace)

 일반
표

표 이름: Freshservice 티켓 발견

테이블 열:

ID

유형

제목

설명

요청자 이메일

카테고리

상태

우선순위

소스

생성일

업데이트된 날짜

마감일

에스컬레이션됨

삭제됨

 일반

티켓 만들기

설명

Freshservice 티켓을 만듭니다.

매개변수

매개변수 표시 이름 유형 기본값 필수 항목 설명
Subject 문자열 해당 사항 없음 예 생성된 티켓의 제목 필드를 지정합니다.
설명 문자열 해당 사항 없음 예 생성된 티켓의 설명 필드를 지정합니다.
요청자 이메일 문자열 해당 사항 없음 예 생성된 티켓의 요청자 이메일을 지정합니다.
상담사 할당 대상 문자열 해당 사항 없음 아니요 티켓을 할당할 상담사 이메일을 지정합니다.
그룹 할당 대상 문자열 해당 사항 없음 아니요 티켓을 할당할 그룹 이름을 지정합니다.
우선순위 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": []
    }
}
케이스 월
결과 유형 값/설명 유형
출력 메시지*

작업이 실패하거나 플레이북 실행을 중지하지 않습니다.

  • 작업이 성공적으로 실행된 경우(is_success=true): 새 Freshservice 티켓이 생성되었습니다.

  • 제공된 매개변수로 인해 작업을 실행할 수 없는 경우(is_success =false): 제공된 매개변수로 새 티켓을 만들 수 없습니다. 오류는 <error text>입니다.

작업이 실패하고 플레이북 실행을 중지합니다.

잘못된 사용자 인증 정보, 서버 연결 없음, 기타 오류와 같은 치명적인 오류, 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": []
    }
}
케이스 월
결과 유형 값/설명 유형
출력 메시지*

작업이 실패하거나 플레이북 실행을 중지하지 않습니다.

  • 작업이 성공적으로 실행된 경우(is_success=true):

    • Freshservice 티켓 <ticket id>이 업데이트되었습니다.

  • 제공된 매개변수로 인해 작업을 실행할 수 없는 경우(is_success =false):

    • 제공된 매개변수로 티켓 <ticket_id>을 업데이트할 수 없습니다. 오류는 <error text>입니다.

작업이 실패하고 플레이북 실행을 중지합니다.

잘못된 사용자 인증 정보, 서버 연결 없음 등 치명적인 오류인 경우: ''티켓 업데이트' 작업을 실행할 때 오류가 발생했습니다. 이유: {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": [
                "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
    }
}
케이스 월
결과 유형 값/설명 유형
출력 메시지*

작업이 실패하거나 플레이북 실행을 중지하지 않습니다.

  • 티켓 대화가 발견된 경우 (is_success = true):
    'Freshservice 티켓 <ticket id> 대화를 가져왔습니다.'
  • 티켓 대화가 반환되지 않는 경우 (is_success = false):
    "티켓 <ticket id>에 대한 티켓 대화가 없습니다."
  • 제공된 티켓 ID를 찾을 수 없는 경우 (is_success = false):
    'Freshservice에서 티켓 <ticket id>을 찾을 수 없습니다.
  • 티켓을 가져오는 중 API 오류가 발생한 경우 (is_success = false): '제공된 입력 매개변수로 티켓 대화를 나열할 수 없습니다. 오류: {API의 오류}'

작업이 실패하고 플레이북 실행을 중지합니다.

잘못된 사용자 인증 정보, 서버 연결 없음 등 치명적인 오류인 경우:

'티켓 대화 목록 작업을 실행하는 동안 오류가 발생했습니다. 이유: {0}'.format(error.Stacktrace)

 일반
표

표 이름: Freshservice 티켓 <티켓 ID> 대화

테이블 열:

ID

유형

공개 상태

사용자 이메일

텍스트

이메일로 시작

받는 사람 이메일

참조 이메일

BCC 이메일

 일반

티켓 답글 추가

설명

Freshservice 티켓에 답장을 추가합니다. 이 작업은 Google SecOps 항목에서는 작동하지 않습니다.

매개변수

매개변수 표시 이름 유형 기본값 필수 항목 설명
티켓 ID 정수 해당 사항 없음 예 대화를 반환할 티켓 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"
    }
}
케이스 월
결과 유형 값/설명 유형
출력 메시지*

작업이 실패하거나 플레이북 실행을 중지하지 않습니다.

  • 작업이 성공적으로 실행된 경우(is_success=true):

    • 티켓 <티켓 ID>에 새 답글이 추가되었습니다.

  • 제공된 티켓 ID를 찾을 수 없는 경우 (is_success = false):

    • 'Freshservice에서 티켓 <ticket id>을(를) 찾을 수 없습니다.

작업이 실패하고 플레이북 실행을 중지합니다.

잘못된 사용자 인증 정보, 서버 연결 없음, 기타 오류와 같은 치명적인 오류, 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"
    }
}
케이스 월
결과 유형 값/설명 유형
출력 메시지*

작업이 실패하거나 플레이북 실행을 중지하지 않습니다.

  • 작업이 성공적으로 실행된 경우(is_success=true):

    • 티켓 <ticket id>에 새 <note type> 메모가 추가되었습니다.

  • 제공된 티켓 ID를 찾을 수 없는 경우 (is_success = false):

    • 'Freshservice에서 티켓 <ticket id>을(를) 찾을 수 없습니다.

작업이 실패하고 플레이북 실행을 중지합니다.

잘못된 사용자 인증 정보, 서버 연결 없음, 기타 오류와 같은 치명적인 오류, SDK 오류인 경우: ''티켓 메모 추가' 작업을 실행하는 중에 오류가 발생했습니다. 이유: {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": "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": []
        },
케이스 월
결과 유형 값/설명 유형
출력 메시지*

작업이 실패하거나 플레이북 실행을 중지하지 않습니다.

  • 에이전트가 발견된 경우 (is_success = true): 'Freshservice 에이전트를 가져왔습니다.'
  • 반환된 상담사가 없는 경우 (is_success = false): '제공된 입력 매개변수에 대한 상담사를 찾을 수 없습니다.'
  • 에이전트를 가져오는 중 API 오류가 발생한 경우 (is_success = false): '제공된 입력 매개변수로 에이전트를 나열할 수 없습니다. 오류는 {API의 오류}입니다.'

작업이 실패하고 플레이북 실행을 중지합니다.

잘못된 사용자 인증 정보, 서버 연결 없음 등 치명적인 오류인 경우:

'Error executing action "List Agents". 이유: {0}'.format(error.Stacktrace)

 일반

표

표 이름: Freshservice 상담사 발견

테이블 열:

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": "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
        }
    ]
}
케이스 월
결과 유형 값/설명 유형
출력 메시지*

작업이 실패하거나 플레이북 실행을 중지하지 않습니다.

  • 요청자가 있는 경우 (is_success = true):
    'Freshservice에 등록된 요청자를 가져왔습니다.'
  • 요청자가 반환되지 않은 경우 (is_success = false):
    '제공된 입력 매개변수에 대한 요청자가 없습니다.'
  • 요청자를 가져오는 중에 API 오류가 발생한 경우 (is_success = false): '제공된 입력 매개변수로 요청자를 나열할 수 없습니다. 오류는 {API의 오류}입니다.'

작업이 실패하고 플레이북 실행을 중지합니다.

잘못된 사용자 인증 정보, 서버 연결 없음 등 치명적인 오류인 경우:

'Error executing action "List Requesters". 이유: {0}'.format(error.Stacktrace)

 일반

표

표 이름: Freshservice 요청자 발견

테이블 열:

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": "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": []
    }
}
케이스 월
결과 유형 값/설명 유형
출력 메시지*

작업이 실패하거나 플레이북 실행을 중지하지 않습니다.

  • 작업이 성공적으로 실행된 경우(is_success=true):

    • 새 Freshservice 에이전트가 생성되었습니다.

  • 제공된 매개변수로 인해 작업을 실행할 수 없는 경우(is_success =false):

    • 제공된 매개변수로 새 에이전트를 만들 수 없습니다. 오류는 <오류 텍스트>입니다.

작업이 실패하고 플레이북 실행을 중지합니다.

잘못된 사용자 인증 정보, 서버 연결 없음, 기타 오류와 같은 치명적인 오류, 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": "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": []
    }
}
케이스 월
결과 유형 값/설명 유형
출력 메시지*

작업이 실패하거나 플레이북 실행을 중지하지 않습니다.

  • 작업이 성공적으로 실행된 경우(is_success=true):

    • Freshservice 상담사 <agent_id>가 업데이트되었습니다.

  • 제공된 매개변수로 인해 작업을 실행할 수 없는 경우(is_success =false):

    • 제공된 매개변수로 freshservice 에이전트 <agent_id>를 업데이트할 수 없습니다. 오류는 <error text>입니다.

작업이 실패하고 플레이북 실행을 중지합니다.

잘못된 사용자 인증 정보, 서버 연결 없음, 기타 오류와 같은 치명적인 오류, 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": "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": []
    }
}
케이스 월
결과 유형 값/설명 유형
출력 메시지*

작업이 실패하거나 플레이북 실행을 중지하지 않습니다.

  • 작업이 성공적으로 실행된 경우(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
    }
}
케이스 월
결과 유형 값/설명 유형
출력 메시지*

작업이 실패하거나 플레이북 실행을 중지하지 않습니다.

  • 작업이 성공적으로 실행된 경우(is_success=true):

    • 새 Freshservice 요청자가 생성되었습니다.

  • 제공된 매개변수로 인해 작업을 실행할 수 없는 경우(is_success =false):

    • 제공된 매개변수로 새 요청자를 만들 수 없습니다. 오류는 <오류 텍스트>입니다.

작업이 실패하고 플레이북 실행을 중지합니다.

잘못된 사용자 인증 정보, 서버 연결 없음, 기타 오류와 같은 치명적인 오류, 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": "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": []
    }
}
케이스 월
결과 유형 값/설명 유형
출력 메시지*

작업이 실패하거나 플레이북 실행을 중지하지 않습니다.

  • 작업이 성공적으로 실행된 경우(is_success=true):

    • Freshservice 요청자 <requester_id>가 업데이트되었습니다.

  • 제공된 매개변수로 인해 작업을 실행할 수 없는 경우(is_success =false):

    • 제공된 매개변수로 freshservice 요청자 <requester_id>를 업데이트할 수 없습니다. 오류는 <error text>입니다.

작업이 실패하고 플레이북 실행을 중지합니다.

잘못된 사용자 인증 정보, 서버 연결 없음, 기타 오류와 같은 치명적인 오류, SDK 오류인 경우: ''요청자 업데이트' 작업을 실행하는 중에 오류가 발생했습니다. 이유: {0}'.format(error.Stacktrace)

 일반

요청자 비활성화

설명

Freshservice 요청자를 비활성화합니다. 이 작업은 Google SecOps 항목에서는 작동하지 않습니다.

매개변수

매개변수 표시 이름 유형 기본값 필수 항목 설명
요청자 ID 정수 해당 사항 없음 예 비활성화할 요청자 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 정수 해당 사항 없음 예 시간 항목을 반환할 티켓 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": {}
       }
   ]
}
케이스 월
결과 유형 값/설명 유형
출력 메시지*

작업이 실패하거나 플레이북 실행을 중지하지 않습니다.

  • 티켓 시간 항목이 발견된 경우 (is_success = true):
    'Freshservice 티켓 <ticket id> 시간 항목을 가져왔습니다.'
  • 티켓 시간 항목이 반환되지 않는 경우 (is_success = false):
    '티켓 <ticket id>에 대한 티켓 시간 항목이 없습니다.'
  • 제공된 티켓 ID를 찾을 수 없는 경우 (is_success = false):
    'Freshservice에서 티켓 <ticket id>을 찾을 수 없습니다.
  • 제공된 상담사 이메일에 대한 상담사 ID를 찾을 수 없는 경우 (is_success = false):
    'Freshservice에서 상담사 <agent_email>을 찾을 수 없습니다.
  • 티켓 시간 항목을 가져오는 중 API 오류가 발생한 경우 (is_success = false): '제공된 입력 매개변수로 티켓 시간 항목을 나열할 수 없습니다. 오류: {API의 오류}'

작업이 실패하고 플레이북 실행을 중지합니다.

잘못된 사용자 인증 정보, 서버 연결 없음 등 치명적인 오류인 경우:

'Error executing action "List Ticket Time Entries". 이유: {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"
       }
   }
}
케이스 월
결과 유형 값/설명 유형
출력 메시지*

작업이 실패하거나 플레이북 실행을 중지하지 않습니다.

  • 작업이 성공적으로 실행된 경우(is_success=true):

    • 새 시간 항목이 티켓 <ticket id>에 추가되었습니다.

  • 제공된 티켓 ID를 찾을 수 없는 경우 (is_success = false):

    • 'Freshservice에서 티켓 <ticket id>을(를) 찾을 수 없습니다.

  • 제공된 상담사 이메일을 찾을 수 없는 경우 (is_success = false):

    • '이메일이 <agent_email>인 상담사를 Freshservice에서 찾을 수 없습니다.

  • 제공된 사용 시간이 잘못된 형식인 경우 (is_success = false):

    • '지정된 시간 값 <time_spent>의 형식이 잘못되었습니다. 'hh:mm' 형식이어야 합니다.

작업이 실패하고 플레이북 실행을 중지합니다.

잘못된 사용자 인증 정보, 서버 연결 없음, 기타 오류와 같은 치명적인 오류, SDK 오류인 경우: ''티켓 시간 입력 추가' 작업을 실행하는 중에 오류가 발생했습니다. 이유: {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"
        }
    }
}
케이스 월
결과 유형 값/설명 유형
출력 메시지*

작업이 실패하거나 플레이북 실행을 중지하지 않습니다.

  • 작업이 성공적으로 실행된 경우(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)

 일반

티켓 시간 항목 삭제

설명

Freshservice 티켓의 시간 항목을 삭제합니다. 이 작업은 Google SecOps 항목에서는 작동하지 않습니다.

매개변수

매개변수 표시 이름 유형 기본값 필수 항목 설명
티켓 ID 정수 해당 사항 없음 예 시간 항목을 삭제할 티켓 ID를 지정합니다.
시간 입력 ID 정수 해당 사항 없음 예 삭제할 시간 항목 ID를 지정합니다.

실행

이 작업은 항목에서 실행되지 않습니다.

작업 결과

스크립트 결과
스크립트 결과 이름 값 옵션
is_success is_success=False
is_success is_success=True
케이스 월
결과 유형 값/설명 유형
출력 메시지*

작업이 실패하거나 플레이북 실행을 중지하지 않습니다.

  • 작업이 성공적으로 실행된 경우(is_success=true):

    • 티켓 <ticket id>의 시간 입력 <time_entry_id>이 삭제되었습니다.

  • 제공된 티켓 ID 또는 시간 항목 ID를 찾을 수 없는 경우 (is_success = false):

    • '제공된 티켓 ID <ticket_id> 또는 시간 입력 ID <time_entry id>가 Freshservice에서 발견되지 않았습니다.

작업이 실패하고 플레이북 실행을 중지합니다.

잘못된 사용자 인증 정보, 서버 연결 없음, 기타 오류와 같은 치명적인 오류, SDK 오류인 경우: ''티켓 시간 입력 삭제' 작업을 실행하는 중에 오류가 발생했습니다. 이유: {0}'.format(error.Stacktrace)

 일반

커넥터

Freshservice Tickets 커넥터

설명

커넥터를 사용하여 Freshservice 티켓을 가져와 Google SecOps 알림을 만들 수 있습니다. 커넥터 허용 목록을 사용하여 특정 유형의 티켓(인시던트 또는 서비스 요청)만 수집할 수 있습니다.

Google SecOps에서 Freshservice Tickets 커넥터 구성

Google SecOps에서 커넥터를 구성하는 방법에 대한 자세한 내용은 커넥터 구성을 참고하세요.

커넥터 매개변수

다음 매개변수를 사용하여 커넥터를 구성합니다.

매개변수 표시 이름 유형 기본값 필수 항목 설명
제품 필드 이름 문자열 Freshworks Freshservice 예
이벤트 필드 이름 문자열 'type' 예
환경 필드 이름 문자열 "" 아니요 아니요
환경 정규식 패턴 문자열 .* 아니요 아니요
API 루트 문자열

https://yourdomain.freshservice.com

 예 Freshservice 인스턴스 API 루트 URL입니다.
API 키 비밀번호 해당 사항 없음 예 통합에 사용할 Freshservice API 키입니다.
SSL 확인 체크박스 선택 아니요 사용 설정하면 통합에서 루트 URL이 유효한 인증서로 구성되어 있는지 확인합니다.
오프셋 시간(시간) 정수 24 예 X시간부터 역순으로 티켓을 가져옵니다.
주기당 최대 티켓 수 정수 30 예 커넥터 실행 한 번에 처리할 티켓 수입니다.
가져올 최소 우선순위 문자열 보통 아니요 Google SecOps에 수집할 티켓의 최소 우선순위입니다(예: 낮음 또는 중간). 가능한 값: Low, Medium, High, Urgent
가져올 티켓 상태 CSV 영업 중, 영업 종료 아니요 Google SecOps로 수집할 티켓 상태입니다. 매개변수에서 쉼표로 구분된 문자열로 여러 값을 허용합니다. 가능한 값: Open, Pending, Resolved, Closed
허용 목록을 차단 목록으로 사용 체크박스 선택 해제 예 사용 설정하면 허용 목록이 차단 목록으로 사용됩니다.

커넥터 규칙

프록시 지원

커넥터가 프록시를 지원합니다.

작업

Freshservice 티켓 종료 동기화 작업

설명

해당 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 티켓 대화 동기화 작업

설명

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 답글, 메모 예 Freshservice 대화 유형을 동기화해야 하는 작업을 지정합니다. 매개변수는 여러 값을 쉼표로 구분된 문자열로 허용합니다.
비공개 메모를 가져오시겠습니까? 체크박스 체크박스 선택 해제됨 (false) 아니요 사용 설정하면 관련 Freshservice 티켓의 공개 및 비공개 메모를 모두 가져옵니다.
Siemplify의 댓글을 X로 동기화 문자열 비공개 메모 예 Google SecOps에서 댓글을 추가하는 데 사용할 대화 유형 작업을 지정합니다. 가능한 값: 비공개 메모, 공개 메모, 답장

도움이 더 필요하신가요? 커뮤니티 회원 및 Google SecOps 전문가로부터 답변을 받으세요.