연결 관리

이 페이지는 제어 릴리스(CR)의 제품 또는 기능에 관한 내용입니다. CR 그룹 소속이 아니거나 자세한 정보를 원하시면, CXone 계정 담당자에게 문의하십시오.

Integration Hub 연결을 통해 CXone에서 사용할 타사 웹 서비스에 대한 통합을 설정할 수 있습니다.

연결 템플릿 만들기

연결 템플릿으로 통합에 대한 기본 정보를 정의합니다. 템플릿은 특정 요청 및 기타 정보를 구성할 수 있는 연결을 생성할 때 사용됩니다.

연결 템플릿은 생성 후에 수정할 수 없습니다. 헤더를 포함한 세부 정보를 변경해야 하는 경우 새 템플릿을 만들어야 합니다.

Integration Hub의 템플릿 추가 페이지 스크린샷
  1. CXone에서 앱 선택기 를 클릭하고 선택합니다.자동화 및 AI > Integration Hub.
  2. 템플릿 추가를 클릭합니다.
  3. 세부 정보 탭에서 템플릿 이름을 입력합니다.
  4. 연결하려는 애플리케이션의 이름을 입력합니다. 이는 애플리케이션, 플랫폼 또는 웹 서비스가 될 수 있습니다.
  5. 통합 방법으로 REST를 선택합니다. 현재 REST가 유일하게 지원되는 방법입니다.

  6. 인증 유형에 대한 옵션을 선택합니다.

    옵션 세부사항
    OAuth 2.0 템플릿에 OAuth 2.0 인증을 포함하려면 이 옵션을 선택합니다. 현재는 이것이 유일하게 지원되는 인증 유형입니다.
    인증 없음 템플릿에 인증을 포함하지 않으려면 이 옵션을 선택합니다.
  7. 팀 템플릿의 설명을 입력합니다. 다른 사용자들은 연결 라이브러리에서 이 템플릿을 선택할 경우 볼 수 있습니다.
  8. 이미지를 끌어서 놓거나 파일 찾아보기를 클릭하여 아이콘 을 첨부합니다. 이 아이콘은 이 템플릿에서 생성된 모든 연결에 대한 연결 라이브러리에서 이 템플릿에 대해 표시됩니다.
  9. 구성 탭에서 이 템플릿에 사용할 수 있는 메서드(동사)를 선택합니다. 모든 웹 서비스가 모든 REST 동사를 지원하는 것은 아닙니다.
  10. 이 템플릿에 대한 사용자 정의 인증 헤더를 정의하려면 사용자 정의 헤더 추가를 클릭합니다. 이 옵션은 템플릿에 대해 인증을 활성화한 경우에만 사용할 수 있습니다. 헤더를 정의하는 방법:
    1. 표시되는 필드에 헤더 이름을 입력합니다.
    2. 더 많은 사용자 정의 헤더를 추가하려면 사용자 정의 헤더 추가를 클릭합니다.
    3. 이 템플릿에서 생성된 연결에 반드시 사용해야 하는 헤더의 경우 필수?를 선택합니다.
    4. 헤더를 삭제하려면 X를 클릭합니다.
  11. 모든 설정을 다시 확인합니다. 템플릿을 저장한 후에는 편집할 수 없습니다.
  12. 다음 중 하나를 수행합니다.
    • 저장을 클릭하여 연결 라이브러리에 템플릿을 추가합니다.
    • 저장 + 내 연결을 클릭하여 템플릿을 연결 라이브러리에 추가하고 템플릿에서 연결을 만듭니다. 연결이 생성된 후에는 인증 세부 정보, 변수 또는 요청을 추가하여 연결을 구성할 수 있습니다. 요청 내용에 이러한 구성 중 일부 또는 전부를 포함시킬 수 있습니다.

템플릿으로 연결 만들기

연결을 사용하여 요청을 생성하고 인증 세부정보를 추가할 수 있습니다. 연결 내역은 Integration Hub의 '내 연결' 아래에 표시됩니다.

연결 템플릿에서 연결을 만듭니다. 연결 라이브러리는 CXone 시스템에 존재하는 모든 연결 템플릿을 보여줍니다. 수행해야 하는 작업과 일치하는 템플릿이 없으면 새로 생성할 수 있습니다.

  1. CXone에서 앱 선택기 를 클릭하고 선택합니다.자동화 및 AI > Integration Hub.

  2. 연결 라이브러리에서 템플릿을 찾습니다. 라이브러리는 페이지 오른쪽에 있습니다. 연결이나 템플릿을 보고 있는 경우 페이지 오른쪽 상단에 있는 X를 클릭합니다. 그러면 연결 라이브러리를 볼 수 있도록 닫힙니다.

  3. 템플릿 속성 페이지에서 내 연결을 클릭하여 템플릿을 기반으로 연결을 만듭니다.

  4. mTLS 자체 서명 인증서를 사용하는 경우 다음 필드를 기입합니다.

    • 클라이언트 인증서
    • 클라이언트 비공개 키
    • 키 암호문구

    이 필드는 인증 유형으로 OAuth 2.0을 사용하는 경우에만 나타납니다. 클라이언트 인증서와 클라이언트 비공개 키를 함께 입력해야 합니다. 클라이언트 비공개 키가 암호화된 경우 키 암호문구를 입력해야 합니다. mTLS 인증서는 인증 URL이 HTTPS에 있는 경우에만 작동합니다. 이러한 필드의 유효성 검사는 연결이 저장된 후에 발생합니다. 비밀 탭에서 이들 필드를 참조할 수 있습니다.

  5. 연결 이름을 입력하고 저장을 클릭합니다.

  6. 페이지 왼쪽 목록에서 새 연결을 클릭합니다.

  7. 구성 탭에서 타임아웃을 밀리초 단위로 구성합니다. 타임아웃은 인증을 포함하여 연결에 구성된 모든 요청에 적용됩니다.

  8. 필요에 따라 인증 및 요청을 구성합니다. 연결에는 둘 중 하나 또는 둘 다를 포함할 수 있습니다.

  9. 연결에 사용하기 위해 암호화하려는 정보가 있는 경우 변수를 구성합니다.

인증 세부 정보 구성

연결의 인증 탭에서 인증 세부 정보를 구성할 수 있습니다. 이 탭은 이 연결에 사용되는 템플릿에서 인증이 활성화된 경우에만 표시됩니다.

  1. CXone에서 앱 선택기 를 클릭하고 선택합니다.자동화 및 AI > Integration Hub.

  2. 페이지 왼쪽의 '내 연결'에서 작업하려는 연결을 클릭합니다.

  3. 인증 탭에서 인증 요청에 사용될 URL을 입력합니다. URL은 동적일 수 없지만 그 안의 비밀을 참조할 수는 있습니다.

  4. 인증 요청에 사용된 REST 메서드(동사)를 선택합니다. 사용 가능한 동사는 이 연결에 사용된 템플릿으로 정의됩니다.

  5. 헤더 아래의 각 필드에 적절한 값을 입력합니다. 별표(*)가 있는 필드는 필수입니다. 이들 필드는 이 연결에 사용되는 템플릿에 정의됩니다..

  6. 이 연결에 사용자 정의 헤더를 추가:

    1. 사용자 정의 헤더 추가를 클릭합니다.

    2. 헤더 이름과 헤더 값을 입력합니다.

  7. 인증 요청에 쿼리 매개변수 추가:
    1. 쿼리 매개변수 추가를 클릭합니다.
    2. 추가하는 각 쿼리 매개변수에 대해 쿼리 매개변수 이름과 쿼리 매개변수 값을 입력합니다.

  8. 미디어 유형을 선택하고 본문 내용을 입력합니다. 미디어 유형을 선택하고 본문 내용을 입력합니다. 이는 사용하는 인증 서버에 필요한 유형과 일치해야 합니다.

    옵션 세부사항

    ApplicationJson

    본문 내용은 JSON 형식이어야 합니다.
    ApplicationJsonPatch 본문 콘텐츠는 JSON 패치 형식이어야 합니다.
    FormURLEncoded

    본문 콘텐츠는 키-값 쌍이어야 합니다. 이 미디어 유형은 공통 URL 표기를 사용하여 요청을 보냅니다.

    +양식 매개변수 추가를 클릭한 후 양식 매개변수 이름 및 양식 매개변수 값을 입력합니다.
    TextHtml 본문 내용은 HTML 형식이어야 합니다.
    TextPlain 본문 콘텐츠는 일반 텍스트여야 합니다.
    TextXml 본문 내용은 XML 형식이어야 합니다.

  9. 저장을 클릭합니다.

연결에 변수 추가

Integration Hub 변수를 사용하면 연결에서 특정 정보를 공유할 수 있습니다. 이 정보가 암호화되어 있는지 여부를 확인할 수 있습니다. 암호화된 변수 또는 암호는 Studio 스크립트의 암호와 같은 민감 정보를 사용할 때 추가적인 보안 계층을 제공합니다.

변수를 생성하면 언제든지 해당 변수를 암호로 변환할 수 있습니다. 변수가 암호가 되고 커넥터가 저장되면 암호를 다시 변수로 바꿀 수 없습니다.

비밀은 되돌릴 수 없습니다. 비밀 값 필드에서 나가 다른 곳을 클릭하면 콘텐츠가 암호화되고 마스킹 별표( * )로 대체됩니다. 필드가 마스킹된 후에는 필드에 입력한 값을 검색할 방법이 없습니다.

  1. CXone에서 앱 선택기 를 클릭하고 선택합니다.자동화 및 AI > Integration Hub.

  2. 페이지 왼쪽의 '내 연결'에서 작업하려는 연결을 클릭합니다.

  3. 변수 탭에서 + 변수 추가를 클릭합니다.

  4. 변수가 포함하는 내용을 식별하는 변수 이름을 입력합니다. 이름에는 공백이나 특수 문자가 포함될 수 있습니다.

  5. 변수 값을 입력합니다. 이는 변수의 값이며 변수를 암호로 만들 경우 암호화될 정보입니다. 암호로 설정하기 전에 정보가 올바른지 확인합니다.

  6. 변수를 암호화하려면 암호 토글을 활성화합니다.

  7. 연결에서 변수를 제거하려면 해당 변수의 오른쪽에 있는 X를 클릭합니다.

  8. 저장을 클릭합니다.

연결에서 변수 사용

수동 또는 Studio 스크립트 요청에서 변수를 사용할 수 있습니다. 헤더, 쿼리 매개 변수 및 본문 콘텐츠에 사용할 수 있습니다.

인증 세부 정보 또는 수동 요청에서 변수 사용

  1. CXone에서 앱 선택기 를 클릭하고 선택합니다.자동화 및 AI > Integration Hub.

  2. 페이지 왼쪽의 '내 연결'에서 작업하려는 연결을 클릭합니다.

  3. 변수를 사용할 탭을 클릭합니다. 변수는 인증 및 요청 탭에서 사용할 수 있습니다.

  4. 다음 지침에 따라 변수 값을 원하는 위치에 변수를 입력합니다.

    • 이름을 이중 대괄호 안에 넣습니다. 예: [[ variableName ]].
    • 변수 탭의 변수 이름 필드에 입력한 것과 정확히 같은 이름을 사용합니다.
    • 변수는 변수가 생성된 연결에만 사용할 수 있습니다.

Studio 요청에서 변수 사용

Studio 스크립트에서 변수를 사용하려면 스크립트에 CONNECTAuth 또는 CONNECTREQUEST 작업이 있어야 합니다. 작업은 스크립트를 변수가 포함된 연결에 링크해야 합니다.

  1. Studio에서 변수를 사용하려는 스크립트를 엽니다.

  2. 변수를 추가하려는 Snippet 작업을 두 번 클릭합니다.

  3. Snippet 편집기 창에서 다음 지침에 따라 변수 값을 사용하려는 위치에 변수를 추가합니다.

    • 이름을 이중 대괄호 안에 넣습니다. 예: [[ variableName ]].
    • 변수 탭의 변수 이름 필드에 입력한 것과 정확히 같은 이름을 사용합니다.
    • 대괄호와 변수 이름을 큰따옴표( " )로 묶습니다. 예: "[[ variableName ]]". 변수가 URL 등 문자열의 일부인 경우 변수뿐만 아니라 전체 문자열을 큰따옴표로 묶어야 합니다. 예: "[[ variableName ]]/location/anotherlocation/".
    • 변수는 변수가 생성된 연결에만 사용할 수 있습니다. 연결은 CONNECTAuth 또는 CONNECTREQUEST 작업을 사용하여 스크립트에 지정해야 합니다.

    예:

    • ASSIGN requestPayload.body = "[[client_id]]"

    • ASSIGN requestPayload.URL = "[[INSTANCEURI]]/INCONTACTAPI/SERBICES/V26.0/AGENTS"

수동 요청 생성

요청은 통합 연결 대상 웹 서비스에서 필요한 정보를 얻는 방법입니다. Studio 스크립트에서 수동 요청을 사용하거나 Integration Hub에서 실행할 수 있습니다.

요청에 경로 매개변수나 URL, 헤더 또는 매개변수의 변수 대체가 필요한 경우 Studio 요청을 생성해야 합니다. 수동 요청은 이들 옵션을 지원하지 않습니다.

  1. CXone에서 앱 선택기 를 클릭하고 선택합니다.자동화 및 AI > Integration Hub.

  2. 페이지 왼쪽의 '내 연결'에서 작업하려는 연결을 클릭합니다.

  3. 요청 탭에서 요청 추가를 클릭합니다.

  4. 요청 이름을 입력합니다.

  5. 수동을 트리거로 선택합니다.

  6. 이 요청의 URL을 입력합니다.

  7. 이 요청에 대한 메서드(동사)를 클릭합니다.

  8. 헤더 아래에서 요청에 필요한 헤더를 추가합니다.

    1. 헤더 추가를 클릭합니다.

    2. 헤더 이름과 헤더 값을 입력합니다.

  9. 쿼리 매개변수에서 요청에 필요한 쿼리 매개변수를 추가:
    1. 쿼리 매개변수 추가를 클릭합니다.
    2. 쿼리 매개변수 이름과 쿼리 매개변수 값을 입력합니다.

  10. 미디어 유형을 선택하고 본문 내용을 입력합니다. 미디어 유형을 선택하고 본문 내용을 입력합니다. 연결하려는 웹 서비스에 필요한 유형과 일치해야 합니다.

    옵션 세부사항

    ApplicationJson

    본문 콘텐츠는 JSON 형식이어야 하며 콘텐츠 헤더는 application/json이어야 합니다.
    ApplicationJsonPatch 본문 콘텐츠는 JSON 패치 형식이어야 하며, 콘텐츠 헤더는 application/json-patch+json이어야 합니다.
    FormURLEncoded

    본문 콘텐츠는 키/값 쌍이어야 하며 콘텐츠 헤더는 application/x-www-form-urlencoded여야 합니다. 이 미디어 유형은 공통 URL 표기를 사용하여 요청을 보냅니다.

    +양식 매개변수 추가를 클릭한 후 양식 매개변수 이름 및 양식 매개변수 값을 입력합니다.
    TextHtml 본문 콘텐츠는 HTML 형식이어야 하며, 콘텐츠 헤더는 text/html이어야 합니다.
    TextPlain 본문 콘텐츠는 일반 텍스트여야 하며, 콘텐츠 헤더는 text/plain이어야 합니다.
    TextXml 본문 콘텐츠는 XML 형식이어야 하며 콘텐츠 헤더는 text/xml이어야 합니다.
  11. 이 요청의 활성 상태를 변경하려면 페이지 상단에서 활성을 클릭합니다. 텍스트가 비활성으로 변경됩니다.
  12. 확인을 클릭합니다.
  13. 요청 탭에서 방금 추가한 요청에 대해 테스트를 클릭합니다. Integration Hub가 요청을 시도합니다. 창이 나타나고 테스트 결과가 표시됩니다.
  14. 편집을 클릭하고 요청을 변경하거나 저장을 클릭합니다.

Studio 요청 생성

Studio 요청은 Integration Hub에서 생성할 수 없는 API 요청이 있지만 인증 및 암호를 위해 Integration Hub를 사용하기를 원하는 경우에 유용합니다.

  1. CXone에서 앱 선택기 를 클릭하고 선택합니다.자동화 및 AI > Integration Hub.

  2. 페이지 왼쪽의 '내 연결'에서 작업하려는 연결을 클릭합니다.

  3. 요청 탭에서 요청 추가를 클릭합니다.

  4. 요청 이름을 입력합니다.

  5. Studio를 트리거로 선택합니다.

  6. 예제를 사용하여 스크립트에서 JSON을 빌드하려면 요청 추가 페이지에서 예제 요청 페이로드를 선택하여 복사합니다.

  7. 확인을 클릭합니다.

    Studio 요청은 Integration Hub에서 테스트할 수 없습니다. 추적과 함께 스크립트를 실행하여 Studio에서 테스트해야 합니다.

  8. 저장을 클릭합니다.
  9. Studio을(를) 실행하여 로그인합니다.
  10. 기존 스크립트를 열거나 새 스크립트를 만듭니다.
  11. 스크립트에 Snippet 작업을 추가하고 두 번 클릭하여 Snippet 편집기 창을 엽니다.

  12. Snippet 편집기 창에서 동적 개체를 만들고 이를 JSON으로 변환합니다. 생성한 개체에는 요청에 필요한 헤더, 쿼리 매개변수 및 본문 콘텐츠가 있는 멤버가 포함되어야 합니다.

    개체를 생성할 때는 이전 단계에서 Integration Hub에서 복사한 예제 페이로드를 가이드로 사용하세요. 예제 페이로드는 다음과 같습니다.

    {
 "URL": "[[INSTANCEURI]]/INCONTACTAPI/SERBICES/V26.0/AGENTS",
 "HTTPMETHOD": "POST",
 "HEADERS": {
	"CONTENT-TYPE": "APPLICATION/JSON",
	"AUTHORIZATION": "BEARER[[BEARERTOKEN]]"
	},
 "QUERYPARAMETERS": {
	"ANI": "[[ANI]]",
	"ACCOUNTID": "123456"
	},
 "BODY": {
	"ANI": "[[ANI]]",
	"ACCOUNTID": "123456",
	"ACCOUNTNAME": "TESTACCOUNT"
	}
}

    예제 페이로드를 가이드로 사용하여 생성된 동적 개체:

    DYNAMIC requestPayload 
ASSIGN requestPayload.URL = "[[INSTANCEURI]]/INCONTACTAPI/SERBICES/V26.0/AGENTS"
ASSIGN requestPayload.HTTPMETHOD = "POST"
ASSIGN requestPayload.HEADERS.CONTENTHYPHENPLACEHOLDERTYPE = "APPLICATION/JSON"
ASSIGN requestPayload.HEADERS.AUTHORIZATION = "BEARER[[BEARERTOKEN]]"
ASSIGN requestPayload.QUERYPARAMETERS.ANI = "[[ANI]]"
ASSIGN requestPayload.QUERYPARAMETERS.ACCOUNTID = "123456"
ASSIGN requestPayload.BODY.ANI = "[[ANI]]"
ASSIGN requestPayload.BODY.ACCOUNTID = "123456"
ASSIGN requestPayload.BODY.ACCOUNTNAME = "TESTACCOUNT"
ASSIGN requestPayloadJSON = "{requestPayload.asjson()}"
ASSIGN requestPayloadJSON = "{requestPayloadJSON.replace("HYPHENPLACEHOLDER", "-")}"

    앞의 예제의 마지막 줄에서는 replace() 함수를 사용하여 CONTENT-TYPE 키 이름에 하이픈( - ) 문자를 삽입합니다. Studio에서는 변수 이름에 하이픈과 같은 특수 문자를 포함할 수 없으므로 이 접근 방식이 해결책으로 사용됩니다.

  13. 요청을 사용하도록 스크립트를 구성합니다.

요청 상태 변경

각 Integration Hub 연결에는 최대 50개의 요청이 있을 수 있습니다. 한 번에 활성이 될 수 있는 요청 수에는 제한이 없습니다. 요청은 기본적으로 활성입니다.

  1. CXone에서 앱 선택기 를 클릭하고 선택합니다.자동화 및 AI > Integration Hub.

  2. 페이지 왼쪽의 '내 연결'에서 작업하려는 연결을 클릭합니다.

  3. 요청 탭에서 작업할 요청을 클릭합니다.

  4. 상태를 변경하려면 페이지 상단에서 비활성 또는 활성을 클릭합니다.