트리거 개요

트리거는 고객이 Genesys Cloud 내에서 발생하는 특정 이벤트에 대한 반응을 구성할 수 있도록 하는 Genesys Cloud 내의 리소스입니다. 작업은 Architect를 통해 생성할 수 있는 워크플로입니다. 워크플로 생성 방법에 대한 자세한 내용은 Genesys 클라우드 리소스 센터의 Architect 정보를 참조하세요.

트리거에는 세 가지 주요 구성 요소가 포함됩니다.

  • 주제 이름: 작업을 호출하려는 주제 또는 이벤트입니다.
  • 워크플로 대상: 일치하는 이벤트에 대해 수행할 작업입니다.
  • 조건: 이벤트가 실행되기 위해 충족되어야 하는 기준입니다.

주제 이름

새로운 주제는 정기적으로 업데이트되며 조직에 따라 주제가 달라질 수 있습니다.

  • v2.users.{id}.activity
  • v2.detail.events.conversation.{id}.acd.end
  • v2.detail.events.conversation.{id}.acd.start
  • v2.detail.events.conversation.{id}.acw
  • v2.detail.events.conversation.{id}.wrapup
  • v2.detail.events.conversation.{id}.attributes
  • v2.detail.events.conversation.{id}.customer.end
  • v2.detail.events.conversation.{id}.customer.start
  • v2.detail.events.conversation.{id}.outbound
  • v2.detail.events.conversation.{id}.user.end
  • v2.detail.events.conversation.{id}.user.start
  • v2.detail.events.conversation.{id}.voicemail.end
  • v2.detail.events.conversation.{id}.voicemail.start
  • v2.outbound.email.campaigns.contact.preContact
  • v2.outbound.email.campaigns.contact.postContact
  • v2.outbound.messaging.campaigns.contact.preContact
  • v2.outbound.messaging.campaigns.contact.postContact
  • v2.quality.evaluations
  • v2.operations.events.{id}
  • v2.detail.events.collaboratechat.adhoc.{id}.messages
  • v2.detail.events.collaboratechat.group.{id}.messages
  • v2.workforcemanagement.managementunits.{id}.adherence
  • v2.workforcemanagement.teams.{id}.adherence
  • v2.users.{id}.workforcemanagement.adherence
  • v2.users.{id}.workforcemanagement.schedules
  • v2.users.{id}.workforcemanagement.notifications
  • v2.users.{id}.workforcemanagement.timeoffrequests
  • v2.users.{id}.integrationpresence

트리거 보기에서 주제를 선택하면 주제의 이벤트 스키마가 참조용으로 표시됩니다. GET 요청으로 가져오면 조직에서 사용할 수 있는 주제 목록을 얻을 수 있습니다. 자세한 내용은 다음을 참조하세요. 프로세스 자동화 API 그리고 사용 가능한 주제 .

워크플로우 대상

관리자는 Architect에서 워크플로를 생성합니다. 트리거 보기에서는 활성 및 게시된 워크플로만 워크플로 대상으로 선택할 수 있습니다. 입력 매개변수가 워크플로우로 전송되는 데이터 형식은 최상위 기본 필드 또는 JSON일 수 있습니다.

  • 문자열, 열거형, 숫자 및 부울과 같은 최상위 기본 요소가 워크플로로 전송됩니다.
  • For JSON data format, the entire event is sent to the workflow as a JSON object. The workflow must be configured to have an input variable named jsonData of type JSON.
메모 : Architect의 워크플로 속성은 대소문자를 구분합니다. 워크플로에서 속성을 참조할 때는 이벤트 스키마에 표시된 것과 정확히 같은 대소문자를 사용해야 합니다.

워크플로에 대한 자세한 내용은 워크플로 작업을 참조하세요.

조건

조건은 트리거가 워크플로 대상을 호출하는 기준 목록입니다. 조건 표현식은 세 부분으로 구성됩니다.

  • JSON 경로 : 비교할 이벤트 부분을 정의합니다. 특정 요소를 찾기 위해 JSON 문서를 탐색하고 구문 분석하는 데 사용되는 언어인 JSONPath를 사용하여 조건을 표현합니다. Jayway JsonPath Evaluator 또는 JSONPath 테스트 유틸리티 도구를 사용하여 JSON 페이로드 및 JSONPath 문에 대한 응답을 확인할 수도 있습니다.
  • 운영자 : JSON 경로 출력을 값과 비교하는 데 사용되는 비교 유형을 정의합니다. 문자열 비교는 대소문자를 구분합니다.트리거 보기에서 연산자 목록에 대한 설명을 보려면 필터 연산자에 대한 도움말 보기 .
  • : 단일 값 또는 값 목록을 사용하는 작업에 대한 사용자 정의 값입니다. 입력 값은 문자열, 숫자 또는 부울 값일 수 있습니다. 연산자의 선택에 따라 값의 입력 형태가 변경됩니다. 값의 입력 유형은 비교의 정확성을 보장합니다.
    연산자 입력 유형
    크거나 같음 번호
    작거나 같음 번호
    동일한

    개체

    같지 않음

    개체

    보다 작음

    번호

    보다 큰

    번호

    ~ 안에

    객체 배열

    NotIn

    객체 배열

    포함

    개체

    모든 부문

    객체 배열

    존재한다

    부울

    크기

    번호

    메모 : 트리거에는 최대 10개의 조건이 있을 수 있으며, 워크플로를 시작하려면 모든 조건을 충족해야 합니다. 여러 조건 중 하나라도 true(OR 논리)일 때 워크플로를 호출하려면 각각 고유한 조건 집합이 있는 여러 트리거를 만들어야 합니다.

타이밍 구성

예를 들어 상태 변경 워크플로에 대한 트리거 처리가 지연되는 경우 설정된 시간 이후에 워크플로를 실행하는 것은 관련이 없습니다.

다음으로, 트리거 생성 방법을 알아보세요.