Zendesk

통합 버전: 8.0

Google Security Operations와 호환되도록 Zendesk 구성

관리자가 API 토큰을 생성합니다. 다음 단계를 따르세요.

Zendesk 인터페이스의 사이드바로 이동하여 관리 아이콘을 클릭한 다음 채널 > API를 선택합니다.

  1. 설정 탭을 클릭하고 토큰 액세스를 사용 설정합니다.
  2. 활성 API 토큰 오른쪽에 있는 + 버튼을 클릭합니다.
  3. 원하는 경우 API 토큰 설명에 설명을 입력합니다.
  4. 나중에 사용할 수 있도록 토큰을 복사하여 안전한 곳에 붙여넣습니다. 창이 닫힌 후에는 전체 토큰이 다시 표시되지 않습니다.
  5. 저장을 클릭하여 API 페이지로 돌아갑니다.

Google SecOps에서 Zendesk 통합 구성

Google SecOps에서 통합을 구성하는 방법에 대한 자세한 내용은 통합 구성을 참고하세요.

작업

티켓에 주석 추가

설명

기존 티켓에 댓글을 추가합니다.

매개변수

매개변수 유형 기본값 설명
티켓 ID 문자열 해당 사항 없음 티켓 번호입니다.
댓글 본문 문자열 해당 사항 없음 해당 사항 없음
작성자 이름 문자열 해당 사항 없음 해당 사항 없음
내부용 메모 불리언 해당 사항 없음 해당 사항 없음

사용 사례

해당 사항 없음

실행

이 작업은 모든 항목에서 실행됩니다.

작업 결과

항목 보강

해당 사항 없음

통계

해당 사항 없음

스크립트 결과
스크립트 결과 이름 값 옵션 예시
is_success True/False is_success:False
JSON 결과
N/A

티켓에 매크로 적용

설명

티켓에 매크로를 적용합니다.

매개변수

매개변수 유형 기본값 설명
티켓 ID 문자열 해당 사항 없음 티켓 번호입니다.
매크로 제목 문자열 해당 사항 없음 해당 사항 없음

사용 사례

해당 사항 없음

실행

이 작업은 모든 항목에서 실행됩니다.

작업 결과

항목 보강

해당 사항 없음

통계

해당 사항 없음

스크립트 결과
스크립트 결과 이름 값 옵션 예시
is_applied True/False is_applied:False
JSON 결과
N/A

티켓 만들기

설명

특정 속성으로 티켓을 만듭니다.

알려진 제한사항

유니코드 문자가 포함된 이메일은 Zendesk API에서 지원되지 않습니다. '이메일 참조' 매개변수에 영향을 미칩니다. 작업에서 이를 무시합니다.

매개변수

매개변수 유형 기본값 설명
Subject 문자열 해당 사항 없음 해당 사항 없음
설명 문자열 해당 사항 없음 해당 사항 없음
할당된 사용자 문자열 해당 사항 없음 사용자 전체 이름입니다.
할당 그룹 문자열 해당 사항 없음 그룹 이름입니다.
우선순위 문자열 해당 사항 없음 우선순위는 긴급, 높음, 보통, 낮음 중 하나입니다.
티켓 유형 문자열 해당 사항 없음 우선순위는 긴급, 높음, 보통, 낮음 중 하나입니다.
태그 문자열 해당 사항 없음 해당 사항 없음
내부용 메모 체크박스 선택 해제됨 댓글을 공개 또는 내부로 지정합니다. 선택 해제하면 공개, 선택하면 내부 전용
이메일 참조 CSV 해당 사항 없음 티켓 생성 알림을 수신할 이메일 주소를 쉼표로 구분하여 지정합니다. 참고: 최대 48개의 이메일 참조를 추가할 수 있습니다. 이는 Zendesk 제한사항입니다.
이메일 참조 유효성 검사 불리언 선택됨 사용 설정된 경우 작업은 '이메일 참조' 매개변수에 제공된 이메일을 가진 사용자가 존재하는지 확인하려고 시도합니다. 한 명 이상의 사용자가 존재하지 않으면 작업이 실패합니다. 이 매개변수가 사용 중지되면 작업에서 이 검사를 실행하지 않습니다.

사용 사례

해당 사항 없음

실행

이 작업은 모든 항목에서 실행됩니다.

작업 결과

항목 보강

해당 사항 없음

통계

해당 사항 없음

스크립트 결과
스크립트 결과 이름 값 옵션 예시
ticket_id 해당 사항 없음 해당 사항 없음
JSON 결과
N/A
케이스 월
결과 유형 값/설명 유형
출력 메시지*

'이메일 참조 유효성 검사'가 사용 설정되어 있고 이메일을 하나 이상 찾을 수 없는 경우 (실패): '{작업 이름}' 작업을 실행하는 동안 오류가 발생했습니다. 이유: 다음 이메일의 사용자를 찾을 수 없습니다. {entity.identifier} 맞춤법을 확인하거나 '이메일 참조 유효성 검사' 매개변수를 사용 중지하세요.

하나 이상의 입력이 유효한 이메일 주소가 아닌 경우: '{작업 이름}' 작업을 실행하는 동안 오류가 발생했습니다. 이유: 다음 이메일의 사용자를 찾을 수 없습니다. {entity.identifier} 맞춤법을 확인하거나 '이메일 참조 유효성 검사' 매개변수를 사용 중지하세요.

 일반

티켓 세부정보 가져오기

설명

티켓 ID로 티켓 세부정보, 댓글, 첨부파일을 가져옵니다.

매개변수

매개변수 유형 기본값 설명
티켓 ID 문자열 해당 사항 없음 티켓의 ID입니다.

사용 사례

해당 사항 없음

실행

이 작업은 모든 항목에서 실행됩니다.

작업 결과

항목 보강

해당 사항 없음

통계

해당 사항 없음

스크립트 결과
스크립트 결과 이름 값 옵션 예시
ticket_details 해당 사항 없음 해당 사항 없음
JSON 결과
{
   "Details":
      {
        "ticket":
           {
             "follower_ids": [],
             "via":
               {
                     "source":
                           {"to": {},
                            "from": {},
                            "rel": "None"},
                    "channel": "web"
                },
              "updated_at": "2019-02-03T10:08:00Z",
              "submitter_id": 360638872459,
              "assignee_id": 360638872459,
              "brand_id": 360000159559,
              "id": 2,
              "custom_fields": [],
              "satisfaction_rating": "None",
              "sharing_agreement_ids": [],
              "allow_attachments": "True",
              "collaborator_ids": [],
              "priority": "high",
              "subject": "Test",
              "type": "incident",
              "status": "open",
              "description": "Test Test Test",
              "tags": ["test"],
              "forum_topic_id": "None",
              "organization_id": 360018882419,
              "due_at": "None",
              "is_public": "True",
              "requester_id": 360638872459,
              "followup_ids": [],
              "recipient": "None",
              "problem_id": "None",
              "url": "https://siemplifyhelp.zendesk.com/api/v2/tickets/2.json", "fields": [],
              "created_at": "2019-02-03T10:08:00Z",
              "raw_subject": "Test",
              "email_cc_ids": [],
              "allow_channelback": "False",
              "has_incidents": "False",
              "group_id": 360000361099,
              "external_id": "None"
           }
       },
    "Comments":
       [{
          "body": "Test Test Test",
          "plain_body": "Test Test Test",
          "via":
           {
              "source":
                      {"to": {},
                       "from": {},
                       "rel": "None"},
              "channel": "web"
            },
          "attachments":
           [{
              "thumbnails": [],
              "url": "https://siemplifyhelp.zendesk.com/api/v2/attachments/360701661660.json",
              "file_name": "Siemplify 10 2018-12-11 (1).lic",
              "content_url": "https://siemplifyhelp.zendesk.com/attachments/token/GeO6Xbc5I009xGRKLwWd7u7Qv/?name=Siemplify+10+2018-12-11+%281%29.lic",
               "height": "None",
               "width": "None",
               "mapped_content_url": "https://siemplifyhelp.zendesk.com/attachments/token/GeO6Xbc5I009xGRKLwWd7u7Qv/?name=Siemplify+10+2018-12-11+%281%29.lic",
               "content_type": "application/unknown",
               "inline": "False",
               "id": 360701661660,
               "size": 1272
            }],
          "audit_id": 393260420939,
          "created_at": "2019-02-03T10:08:00Z",
          "id": 393260420979,
          "author_id": 360638872459,
          "html_body": "<div> Test Test Test < br >< /div>",
          "type": "Comment",
          "public": "True",
          "metadata":
            {
               "system":
                  {
                     "latitude": 32.066599999999994,
                     "client": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/71.0.3578.98 Safari/537.36",
                      "ip_address": "1.1.1.1",
                      "location": "Tel Aviv, 05, Israel",
                      "longitude": 34.764999999999986
                   },
               "custom": {}
             }
         }],
     "Attachments": [{"test.txt": ""}]
 }

핑

설명

연결을 테스트합니다.

매개변수

해당 사항 없음

사용 사례

해당 사항 없음

실행

이 작업은 모든 항목에서 실행됩니다.

작업 결과

항목 보강

해당 사항 없음

통계

해당 사항 없음

스크립트 결과
스크립트 결과 이름 값 옵션 예시
is_connected True/False is_connected:False
JSON 결과
N/A

티켓 검색

설명

키워드로 티켓을 검색합니다.

매개변수

매개변수 유형 기본값 설명
검색어 문자열 해당 사항 없음 쿼리 콘텐츠 (예: type:ticket status:pending)

사용 사례

해당 사항 없음

실행

이 작업은 모든 항목에서 실행됩니다.

작업 결과

항목 보강

해당 사항 없음

통계

해당 사항 없음

스크립트 결과
스크립트 결과 이름 값 옵션 예시
results_count 해당 사항 없음 해당 사항 없음
JSON 결과
N/A

티켓 업데이트

설명

기존 티켓 세부정보 업데이트

매개변수

매개변수 유형 기본값 설명
티켓 ID 문자열 해당 사항 없음 티켓 번호입니다.
제목 문자열 해당 사항 없음 티켓의 제목입니다.
할당된 사용자 문자열 해당 사항 없음 사용자 전체 이름입니다.
할당 그룹 문자열 해당 사항 없음 그룹 이름입니다.
우선순위 문자열 해당 사항 없음 우선순위는 긴급, 높음, 보통, 낮음 중 하나입니다.
티켓 유형 문자열 해당 사항 없음 티켓 유형은 문제, 인시던트, 질문 또는 작업 중 하나입니다.
태그 문자열 해당 사항 없음 티켓에 추가할 태그입니다.
상태 문자열 해당 사항 없음 상태는 new(신규), open(진행 중), pending(대기 중), hold(보류), solved(해결됨), closed(종료됨) 중 하나입니다.
추가 의견 문자열 해당 사항 없음 티켓에 댓글을 추가하려면 여기에 댓글로 추가할 텍스트를 지정하세요.
내부용 메모 체크박스 선택 해제됨 댓글을 공개 또는 내부로 지정합니다. 선택 해제하면 공개, 선택하면 내부 전용

사용 사례

해당 사항 없음

실행

이 작업은 모든 항목에서 실행됩니다.

작업 결과

항목 보강

해당 사항 없음

통계

해당 사항 없음

스크립트 결과
스크립트 결과 이름 값 옵션 예시
is_updated True/False is_updated:False
JSON 결과
N/A

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