통합을 위한 사용자 지정 작업에 구성 추가

메모 : 이 문서는 AWS Lambda, Function, Genesys Cloud, Google, Microsoft Dynamics 365, Salesforce, 웹 서비스 및 Zendesk 데이터 작업 통합에 적용됩니다.

사용자 지정 작업을 만들 때 먼저 계약을 추가한 다음 구성을 추가합니다. 구성은 작업이 계약을 구현하는 방법을 정의합니다. 자세한 내용은 사용자 지정 작업 만들기 그리고 사용자 지정 작업에 계약 추가.

참고: 작업을 게시한 후 구성을 수정할 수 있습니다. 자세한 내용은 사용자 지정 작업에서 구성 수정.
  1. 클릭 구성 탭. 
  2. HTTP 방법을 선택합니다.
  3. 아래에 요구, 작업이 웹 서비스에 보내는 요청을 구성합니다. Genesys는 아래 필드를 사용하여 요청을 구성할 것을 권장합니다. 단순한.
    : 아래의 속성을 클릭하십시오. 사용 가능한 입력 복사하여 요청에 빠르게 붙여넣습니다. 이러한 속성은 입력 계약에서 가져옵니다. 자세한 내용은 사용자 지정 작업에 계약 추가. 템플릿과 함께 매크로를 사용할 수 있습니다. 자세한 내용은 데이터 작업을 위한 속도 매크로.

    표시되는 필드에 대한 정보를 입력합니다. 표시되는 필드는 선택한 HTTP 메서드와 추가된 계약에 따라 다릅니다.

    메모:
    • AWS Lambda 데이터 작업 통합 및 Google Cloud Functions에 대해서는 다음을 참조하세요. 특별 요청 구성 부분.
    • 과도하게 중첩된 JSON 개체는 데이터 작업 서비스의 성능에 영향을 줄 수 있습니다. 성능을 유지하기 위해 JSON 객체의 깊이는 50레벨로 제한됩니다. 자세한 내용은 Genesys Cloud 개발자 센터에서 한도를 참조하세요.
  4. URL 템플릿 요청

    세트 요청 URL 템플릿 HTTP 요청이 적중하는 원격 엔드포인트로 이동합니다.

  5. 헤더 (선택 과목)

    원격 엔드포인트로 전송된 요청에서 HTTP 헤더로 추가되는 키-값 쌍입니다.

    참고: Accept 헤더를 설정하는 경우 JSON 미디어 유형을 헤더 값으로 사용해야 합니다.

  6. 실행 시간 초과

    데이터 작업에 대한 실행 시간 제한을 1~60초 사이로 설정합니다. 시간 초과 값을 설정하지 않으면 기본 시간 초과인 60초가 사용됩니다. HTTP 요청이 설정된 시간보다 오래 실행되면 데이터 작업은 시간 초과 응답을 반환합니다. 지정된 시간 제한 이후에는 데이터 작업 실행이 동시성 제한에서 제거됩니다. 자세한 내용은 다음을 참조하세요. 데이터 작업이 시간 초과되기까지 몇 초가 걸리나요? .

    메모 : 흐름의 시간 초과 논리가 올바르게 실행되도록 하고 불필요한 데이터 작업 처리를 방지하려면 데이터 작업의 시간 초과를 흐름의 구성된 시간 초과보다 1초 더 길게 설정합니다. 이 모범 사례는 흐름이 이미 시간 초과된 후에는 데이터 작업이 계속되지 않도록 보장하여 동시성 제한을 관리하는 데 도움이 됩니다.

  7. 인코딩 전송

    웹 서비스가 지원하지 않는 경우 전송 인코딩 로 설정 청크, 추가하다 전송 인코딩: 버퍼링된 아래에 헤더. 자세한 내용은 예상치 못한 이유로 사용자 지정 작업이 실패함.

  8. 권한

    요청 구성에 권한 부여 정보를 포함할 수 있습니다. 자세한 내용은 사용자 정의 자격 증명 유형을 사용하는 방법 그리고 사용자 정의(OAuth) 자격 증명 유형을 사용하는 방법.

  9. 특별 요청 구성

    AWS Lambda 데이터 작업 통합과 연결되거나 Google Cloud Functions를 실행하는 사용자 지정 작업에 대한 요청 구성은 웹 서비스에 대한 표준 요청 구성과 다릅니다.

    • URL 템플릿 요청

      세트 요청 URL 템플릿 AWS Lambda 함수의 ARN에. 자세한 내용은 AWS Lambda 함수를 호출하기 위한 IAM 리소스 생성

    • 요청 유형

      세트 요구 유형 에게 우편. 이 HTTP 메서드는 작업이 요청 구성과 함께 요청 본문을 보내도록 합니다.

    • 헤더

      추가되는 키-값 쌍 커스텀 에 지도 클라이언트 컨텍스트 물체. NS 클라이언트 컨텍스트 개체는 차례로 호출의 값입니다. 문맥 물체. 다음 속성이 있으면 자동으로 설정됩니다. 문맥 물체:

      • ININ-조직-ID
      • ININ-홈-조직-ID
      • ININ-Correlation-Id
      • ININ-사용자-ID
      • ININ-통합-ID

      Java 예제의 경우 클라이언트 컨텍스트 개체, 참조 인터페이스 ClientContext

    • 요청 템플릿

      아래에 지정하는 모든 값 요청 템플릿 에서 사용할 수 있습니다. 이벤트 호출된 AWS Lambda 함수의 매개변수입니다.

    • URL 템플릿 요청

      세트 요청 URL 템플릿 HTTP 요청이 적중하는 원격 엔드포인트로 이동합니다.

    • 요청 유형

      세트 요구 유형 에게 우편. 이 HTTP 메서드는 작업이 요청 구성과 함께 요청 본문을 보내도록 합니다.

    • 헤더

      추가되는 키-값 쌍 커스텀 에 지도 클라이언트 컨텍스트 물체. NS 클라이언트 컨텍스트 개체는 차례로 호출의 값입니다. 문맥 물체. 다음 속성이 있으면 자동으로 설정됩니다. 문맥 물체:

      • ININ-조직-ID
      • ININ-홈-조직-ID
      • ININ-Correlation-Id
      • ININ-사용자-ID

      Java 예제의 경우 클라이언트 컨텍스트 개체, 참조 인터페이스 ClientContext

    • 요청 템플릿

      아래에 지정한 모든 값 요청 템플릿 에서 사용 가능합니다 이벤트 호출된 AWS Lambda 함수의 매개변수. 그만큼 클라이언트 컨텍스트 길이 제한이 있어 Genesys Cloud Function 데이터 작업에 필요한 인증서를 전달하는 데 사용할 수 없습니다. 자격 증명에 구성된 인증서를 포함하려면 크기 제한이 없는 요청 템플릿의 본문을 사용합니다.

    • URL 템플릿 요청

      세트 요청 URL 템플릿 데이터 작업을 실행할 Google Cloud 함수의 위치: https://-/.

    • 요청 유형

      세트 요구 유형 에게 우편.

    • 요청 템플릿

      요청 템플릿$로 설정합니다. 

    요청 부분에 대한 자세한 설명은 다음을 참조하십시오. 데이터 작업에 대한 구성 요청.

    JSON에 대해 잘 아는 사람은 JSON 입력 옵션을 사용할 수 있습니다. JSON 생성을 위한 가이드로 다른 작업 또는 다음 예제의 요청을 사용합니다.

    {
      "requestUrlTemplate": "https://www.example.com/health/check/services/${input.service}",
      "requestType": "GET",
      "headers": {},
      "requestTemplate": "${input.rawRequest}"
    }

  10. 아래에 응답, JSON 구성을 추가합니다.

    JSON 구성은 웹 서비스 또는 AWS Lambda 함수의 응답이 처리되는 방식을 정의합니다.

    JSON 생성을 위한 가이드로 다른 작업 또는 다음 예제의 응답을 사용할 수 있습니다. 성공 템플릿과 함께 매크로를 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요. 데이터 작업을 위한 속도 매크로.

    : 아래의 속성을 클릭하십시오. 사용 가능한 출력 복사하여 응답에 빠르게 붙여넣습니다. 이러한 속성은 출력 계약에서 가져옵니다. 자세한 내용은 사용자 지정 작업에 계약 추가.
    {
          "translationMap": {
              "buildNumber": "$.Build-Version",
              "serviceName": "$.name",
              "status": "$.Status"
          },
          "successTemplate": "{\r\n      \t\"build\": ${buildNumber},\r\n      \t\"name\": ${serviceName},\r\n\"status\": ${status}\r\n      }"
     }

    응답 부분에 대한 자세한 설명은 다음을 참조하십시오. 데이터 작업에 대한 응답 구성.

다음, 함수를 추가하세요 Genesys Cloud Function에 대해 알아보세요. 다른 데이터 작업의 경우 액션을 테스트하다 검증 및 실행 오류에 대해.

자세한 내용은 통합을 위한 사용자 지정 작업 정보.

통합에 대한 자세한 내용은 다음을 참조하십시오. 데이터 작업 통합 정보.