CXone Agent for Microsoft Teams에 대한 HubSpot 워크플로 구성

HubSpot을(를) CXone Agent for Microsoft Teams과(와) 통합하기 위한 마지막 단계입니다.

HubSpotCXone Agent for Microsoft Teams에 대해 검색, 사용자 지정 생성 및 표준 생성 워크플로를 구성합니다. 이러한 워크플로는 HubSpot 레코드를 검색 또는 생성하며, 이는 엔터티 또는 개체라고도 합니다. 이는 동적 데이터 매핑의 백엔드 구성입니다.

사용자 지정 타임라인은 HubSpot에 대해 지원되지 않습니다.

워크플로 형식

설명

워크플로

검색 검색 워크플로는 상담원이 처리하는 인터랙션에 적용되는 레코드를 찾기 위해 HubSpot을(를) 검색합니다. ANI 검색
사용자 지정 검색
사용자 지정 생성 사용자 지정 생성 워크플로에서는 표준 필드와 사용자 지정 필드를 모두 사용하여 아무 레코드 유형이나 생성합니다. 사용자 지정 생성
표준 생성

표준 생성 워크플로에서는 표준 데이터 필드로 표준 HubSpot 레코드를 생성합니다. 이러한 워크플로의 SNIPPET 페이로드는 표준 필드를 포함해야 하며, 이러한 필드 포함해야 합니다.

회사 생성
컨택 생성
티켓 생성
연결을 포함한 티켓 생성

검색 워크플로 구성

검색 워크플로로는 두 가지가 있으며, ANI 검색사용자 지정 검색입니다.

ANI 검색 워크플로 구성

전화 통화 또는 이메일에 대해 ANI 검색 작업 흐름을 구성할 수 있습니다.

  1. Studio에서, ANI 검색 작업 흐름을 구성할 스크립트를 엽니다.

  2. 이미 추가하지 않은 경우, BEGIN 다음 Workflow Execute 작업 앞에 SNIPPET 작업을 추가합니다.

  3. 스크립트 캔버스에서 SNIPPET 작업을 두 번 클릭합니다.

  4. 전화 통화에 대해 ANI 검색 작업 흐름을 구성하려면, 다음 각 코드 줄을 복사하여 편집기 창의 텍스트 보기 탭에 붙여넣습니다.

    
    ASSIGN phoneNumber = "{ANI}"
    ASSIGN email = ""
    DYNAMIC searchInput
    searchInput.phoneNumber = "{phoneNumber}"
    DYNAMIC searchFlowPayload
    searchFlowPayload.workflowInput = searchInput
    		
  5. 이메일에 대해 ANI 검색 작업 흐름을 구성하려면, 다음 각 코드 줄을 복사하여 편집기 창의 텍스트 보기 탭에 붙여넣습니다.

    
    ASSIGN phoneNumber = ""
    ASSIGN email = "{ANI}"
    DYNAMIC searchInput
    searchInput.email = "{email}"
    DYNAMIC searchFlowPayload
    searchFlowPayload.workflowInput = searchInput
    		
  6. 스크립트를 저장합니다.

  7. Studio에서 인터랙션을 시뮬레이션하여 스크립트를 테스트할 수 있습니다.

사용자 지정 검색 워크플로 구성

사용자 지정 검색 워크플로를 사용하면 한 개 이상의 HubSpot 레코드를 검색할 수 있습니다. 또한 지정된 레코드 내에서 여러 필드와 변수를 검색할 수 있습니다. HubSpot 연산자를 사용하여 여러 검색 요구사항을 연결할 수 있습니다.

이 워크플로는 다음과 같은 HubSpot 레코드를 지원합니다.

  • 회사
  • 컨택
  • 티켓(연결된 레코드 포함 또는 불포함)
  1. Studio에서 사용자 지정 검색 워크플로를 구성할 스크립트를 엽니다.

  2. 이미 추가하지 않은 경우, BEGIN 다음 Workflow Execute 작업 앞에 SNIPPET 작업을 추가합니다.

  3. 스크립트 캔버스에서 SNIPPET 작업을 두 번 클릭합니다.

  4. 다음 각 코드 줄을 복사하여 편집기 창의 텍스트 보기 탭에 붙여넣습니다.

    
    DYNAMIC filterGroups
    	
    DYNAMIC filters1
    filters1.propertyName = "[fieldName]"
    filters1.operator = "[operator]"
    filters1.value = "[value]"
    
    DYNAMIC filters2
    filters2.propertyName = "[fieldName]"		
    filters2.operator = "[operator]"
    filters2.value = "[value]"
    
    filterGroups.filters[1] = filters1
    filterGroups.filters[2] = filters2
    
    DYNAMIC sorts
    DYNAMIC sort1
    sort1.propertyName = "[fieldName]"
    sort1.direction = "[ASCENDING or DESCENDING]"
    sorts[1] = sort1
    
    DYNAMIC searchArray
    searchArray[1].entity = "[API name]"
    searchArray[1].filter.filterGroups[1] = filterGroups
    
    DYNAMIC searchFlowPayload
    searchFlowPayload.workflowInput.entities = searchArray
    		
  5. filters1filters2 속성의 값을 변경합니다.

    1. filters1.propertyNamefilters2.propertyName 속성의 값을 검색하는 데 사용할 필드의 이름으로 변경합니다. 예를 들면 filters1.propertyName = "subject"입니다.

      필드 이름의 전체 목록에서 통화한 속성 및 엔드포인트는 레코드에 대한 HubSpot 문서에서 찾을 수 있습니다.

    2. filters1.operatorfilters2.operator 속성의 값을 사용할 HubSpot 오퍼레이터로 변경합니다. HubSpot 오퍼레이터 전체 목록을 HubSpot 문서 외부 사이트로의 이동을 나타내는 화살표가 있는 상자입니다.에서 찾을 수 있습니다. 이는 대소문자를 구분합니다.

    3. filters1.valuefilters2.value 속성의 값을 사용할 필드에 배정할 값으로 변경합니다. 예를 들면 filters1.value = "Account invalid Login"입니다.

  6. sort1 속성의 값을 변경합니다.

    1. sort1.propertyName 속성의 값을 결과를 정렬하는 데 사용할 필드로 변경합니다. 예를 들면 sort1.propertyName = "createdate"입니다.

    2. sort1.direction 속성의 값을 ASCENDING 또는 DESCENDING(으)로 변경합니다.

  7. searchArray[1].entity 속성의 값을 검색할 레코드에 대한 API 이름으로 변경합니다. 예를 들면 searchArray[1].entity = "companies"입니다. 이는 대소문자를 구분합니다.

  8. 스크립트를 저장합니다.

  9. Studio에서 인터랙션을 시뮬레이션하여 스크립트를 테스트할 수 있습니다.

사용자 지정 생성 워크플로 구성

사용자 지정 생성 워크플로를 사용하면 표준 또는 사용자 지정 등 모든 유형의 HubSpot 레코드를 생성하도록 SNIPPET 페이로드를 구성할 수 있습니다. 또한 표준 또는 사용자 지정 필드 유형에 관계없이 모든 필드 유형을 채울 수 있습니다. 예를 들어 해당 레코드 유형의 일부 표준 필드와 사용자 지정 필드를 사용하여 회사 레코드를 만들 수 있습니다.

HubSpot 레코드 생성 방식을 권장합니다.

사용자 지정 생성 워크플로 구성

사용자 지정 생성 워크플로는 표준 또는 사용자 지정 등 모든 유형의 HubSpot 레코드를 생성합니다. 이 레코드는 표준 데이터 필드와 사용자 지정 데이터 필드를 표시할 수 있습니다. 필드는 텍스트, 숫자 또는 변수를 포함해야 합니다.

  1. Sales Hub Enterprise 도구가 HubSpot에 활성화되었는지 확인하십시오. 사용자 지정 HubSpot 레코드를 생성하려면 이 도구가 필요합니다.

  2. HubSpot 문서 외부 사이트로의 이동을 나타내는 화살표가 있는 상자입니다.를 사용하여 HubSpot에서 사용자 지정 레코드 또는 개체를 생성합니다.

  3. Studio에서 사용자 지정 생성 워크플로를 구성할 스크립트를 엽니다.

  4. 이미 추가하지 않은 경우, BEGIN 다음 Workflow Execute 작업 앞에 SNIPPET 작업을 추가합니다.

  5. 스크립트 캔버스에서 SNIPPET 작업을 두 번 클릭합니다.

  6. 다음 각 코드 줄을 복사하여 편집기 창의 텍스트 보기 탭에 붙여넣습니다.

    
    DYNAMIC createPayload
    createPayload.entities.name = "[custom record API]"
    createPayload.entities.properties.[fieldName]= "[field value]"
    createPayload.entities.properties.[fieldName]= "[field value]"
    createPayload.entities.properties.[fieldName]= "[field value]"
    createPayload.entities.properties.[fieldName]= "[field value]"
    						
    createPayload.pinnedRecord = "[true or false]"
    
    DYNAMIC create[ObjectName]Payload
    create[ObjectName]Payload.workflowInput = createPayload
    
    ASSIGN create[ObjectName]Json = "{create[RecordName]Payload.asjson()}"
    		
  7. createPayload.entities.name 속성의 값을 생성한 사용자 지정 레코드에 대한 API로 변경합니다. 예를 들면 createPayload.entities.name = "companies"입니다. 이는 대소문자를 구분합니다.

  8. createPayload.entities.properties 속성에서 [fieldname]을(를) 사용자 지정 레코드에 추가할 필드의 이름으로 변경합니다. 예를 들면 createPayload.entities.properties.accountNumber입니다.

  9. createPayload.entities.properties 속성의 값을 필드에 배정할 값으로 변경합니다. 예를 들면 createPayload.entities.properties.accountNumber = "12345"입니다.

  10. createPayload.pinnedRecord 속성의 값을 true 또는 false(으)로 변경합니다. true(으)로 설정되면, 생성된 레코드가 고객 카드의 현재 인터랙션 섹션의 상담원에게 표시됩니다. false(으)로 설정되면 고객 카드의 최신 인터랙션 섹션에 표시됩니다. 페이로드에 이 속성을 포함하지 않으면 false인 것으로 간주됩니다.
  11. 코드의 마지막 세 줄에 있는 [ObjectName]의 모든 인스턴스를 생성한 레코드의 이름으로 변경합니다. 속성의 카멜 표기법과 일치하도록 이름을 대문자로 표기합니다. 예를 들어, 생성한 레코드의 이름이 account인 경우, 코드는 다음과 같습니다.

    
    DYNAMIC createAccountPayload
    createAccountPayload.workflowInput = createPayload
    						
    ASSIGN createAccountJson = "{createAccountPayload.asjson()}"
    		
  12. 스크립트를 저장합니다.

  13. Studio에서 인터랙션을 시뮬레이션하여 스크립트를 테스트할 수 있습니다.

표준 생성 워크플로 구성

사용자는 표준 생성 워크플로를 사용하여 HubSpot 내의 표준 HubSpot 레코드를 검색할 수 있습니다.

표준 생성 워크플로의 SNIPPET 페이로드에서는 필드를 추가 또는 삭제할 수 없습니다. 필드를 추가 또는 삭제하는 경우 레코드는 생성되지 않습니다. 원하는 필드를 사용하여 표준 또는 사용자 지정 레코드를 생성하려면 사용자 지정 생성 워크플로를 사용합니다.

회사 생성 워크플로 구성

  1. Studio에서, 회사 생성 작업 흐름을 구성할 스크립트를 엽니다.

  2. 이미 추가하지 않은 경우, BEGIN 다음 Workflow Execute 작업 앞에 SNIPPET 작업을 추가합니다.

  3. 스크립트 캔버스에서 SNIPPET 작업을 두 번 클릭합니다.

  4. 다음 각 코드 줄을 복사하여 편집기 창의 텍스트 보기 탭에 붙여넣습니다.

    
    DYNAMIC createPayload
    createPayload.entities.name = "company"
    createPayload.entities.properties.name = "[company name]"
    createPayload.entities.properties.domain = "[company website]"
    createPayload.entities.properties.city = "[company city]"
    createPayload.entities.properties.phone = "[company phone number]"
    						
    DYNAMIC createCompanyPayload
    createCompanyPayload.workflowInput = createPayload
    
    ASSIGN createCompanyJson = "{createCompanyPayload.asjson()}"
    		

    그러한 각 라인을 포함해야 합니다. 필드를 비워 두려는 경우, null 값("")을 사용할 수 있습니다. 예를 들면 createPayload.entities.properties.city = ""입니다.

  5. 속성의 값을 변경합니다. 이러한 값은 하드 코딩되거나 변수이거나 이들의 조합일 수 있습니다. 각 인터랙션에 대해 값을 업데이트하려면 변수를 사용합니다.

    1. createPayload.entities.properties.name 속성의 값을 회사의 이름으로 변경합니다. 예를 들면 createPayload.entities.properties.name = "Classics, Inc."입니다.

    2. createPayload.entities.properties.domain 속성의 값을 회사의 웹사이트로 변경합니다. 예를 들면 createPayload.entities.properties.domain = "classics.com"입니다.

    3. createPayload.entities.properties.city 속성의 값을 회사의 도시로 변경합니다. 예를 들면 createPayload.entities.properties.city = "London"입니다.

    4. createPayload.entities.properties.phone 속성의 값을 회사의 전화번호로 변경합니다. 예를 들면 createPayload.entities.properties.phone = "1234567890"입니다.

  6. 스크립트를 저장합니다.

  7. Studio에서 인터랙션을 시뮬레이션하여 스크립트를 테스트할 수 있습니다.

컨택 생성 작업 흐름 구성

  1. Studio에서, 컨택 생성 작업 흐름을 구성할 스크립트를 엽니다.

  2. 이미 추가하지 않은 경우, BEGIN 다음 Workflow Execute 작업 앞에 SNIPPET 작업을 추가합니다.

  3. 스크립트 캔버스에서 SNIPPET 작업을 두 번 클릭합니다.

  4. 다음 각 코드 줄을 복사하여 편집기 창의 텍스트 보기 탭에 붙여넣습니다.

    
    DYNAMIC createPayload
    createPayload.entities.name = "contact"
    createPayload.entities.properties.firstName = "[first name]"
    createPayload.entities.properties.email = "[email address]"
    createPayload.entities.properties.lastName = "[last name]"
    createPayload.entities.properties.phone = "[phone number]"
    
    DYNAMIC createContactPayload
    createContactPayload.workflowInput = createPayload
    
    ASSIGN createContactJson = "{createContactPayload.asjson()}"
    		

    그러한 각 라인을 포함해야 합니다. 필드를 비워 두려는 경우, null 값("")을 사용할 수 있습니다. 예를 들면 createPayload.entities.properties.email = ""입니다.

  5. 속성의 값을 변경합니다. 이러한 값은 하드 코딩되거나 변수이거나 이들의 조합일 수 있습니다. 각 인터랙션에 대해 값을 업데이트하려면 변수를 사용합니다.

    1. createPayload.entities.properties.firstName 속성의 값을 컨택의 이름으로 변경합니다. 예를 들면 createPayload.entities.properties.firstName = "Elinor"입니다.

    2. createPayload.entities.properties.email 속성의 값을 컨택의 이메일 주소로 변경합니다. 예를 들면 createPayload.entities.properties.email = "elinor.dashwood@classics.com"입니다.

    3. createPayload.entities.properties.lastName 속성의 값을 컨택의 성으로 변경합니다. 예를 들면 createPayload.entities.properties.lastName = "Dashwood"입니다.

    4. createPayload.entities.properties.phone 속성의 값을 컨택의 전화번호로 변경합니다. 예를 들면 createPayload.entities.properties.phone = "1234567890"입니다.

  6. 스크립트를 저장합니다.

  7. Studio에서 인터랙션을 시뮬레이션하여 스크립트를 테스트할 수 있습니다.

티켓 생성 작업 흐름 구성

  1. Studio에서, 티켓 생성 작업 흐름을 구성할 스크립트를 엽니다.

  2. 이미 추가하지 않은 경우, BEGIN 다음 Workflow Execute 작업 앞에 SNIPPET 작업을 추가합니다.

  3. 스크립트 캔버스에서 SNIPPET 작업을 두 번 클릭합니다.

  4. 다음 각 코드 줄을 복사하여 편집기 창의 텍스트 보기 탭에 붙여넣습니다.

    
    DYNAMIC createPayload
    createPayload.entities.name = "ticket"
    createPayload.entities.properties.subject = "[ticket subject]"
    createPayload.entities.properties.hs_pipeline = "[#]"
    createPayload.entities.properties.hs_pipeline_stage = "[#]"
    createPayload.entities.properties.hs_ticket_priority = "[LOW, MEDIUM, or HIGH]"
    
    DYNAMIC createTicketPayload
    createTicketPayload.workflowInput = createPayload
    
    ASSIGN createTicketJson = "{createTicketPayload.asjson()}"
    		

    그러한 각 라인을 포함해야 합니다. 필드를 비워 두려는 경우, null 값("")을 사용할 수 있습니다. 예를 들면 createPayload.entities.properties.hs_ticket_priority = ""입니다.

  5. 속성의 값을 변경합니다.

    1. createPayload.entities.properties.subject 속성의 값을 티켓의 주제로 변경합니다: 티켓이 생성된 이유. 예를 들면 createPayload.entities.properties.subject = "Query about large book orders"입니다. 이 값은 하드 코딩되거나 변수이거나 이들의 조합일 수 있습니다. 각 인터랙션에 대해 값을 업데이트하려면 변수를 사용합니다.

    2. createPayload.entities.properties.hs_pipeline 속성의 값을 티켓의 파이프라인 번호로 변경합니다. 예를 들면 createPayload.entities.properties.hs_pipeline = "0"입니다.

    3. createPayload.entities.properties.hs_pipeline_stage 속성의 값을 파이프라인에서 티켓의 상태를 나타내는 번호로 변경합니다. 예를 들면 createPayload.entities.properties.hs_pipeline_stage = "3"입니다.

    4. createPayload.entities.properties.hs_ticket_priority 속성의 값을 LOW, MEDIUM 또는 HIGH(으)로 변경합니다.

  6. 스크립트를 저장합니다.

  7. Studio에서 인터랙션을 시뮬레이션하여 스크립트를 테스트할 수 있습니다.

연결을 포함한 티켓 생성 작업 흐름 구성

  1. Studio에서, 연결을 포함한 티켓 생성 작업 흐름을 구성할 스크립트를 엽니다.

  2. 이미 추가하지 않은 경우, BEGIN 다음 Workflow Execute 작업 앞에 SNIPPET 작업을 추가합니다.

  3. 스크립트 캔버스에서 SNIPPET 작업을 두 번 클릭합니다.

  4. 다음 각 코드 줄을 복사하여 편집기 창의 텍스트 보기 탭에 붙여넣습니다.

    
    DYNAMIC createPayload
    createPayload.entities.name = "ticket"
    createPayload.entities.properties.subject = "[ticket subject]"
    createPayload.entities.properties.hs_pipeline = "[#]"
    createPayload.entities.properties.hs_pipeline_stage = "[#]"
    createPayload.entities.properties.hs_ticket_priority = "[LOW, MEDIUM, or HIGH]"
    
    DYNAMIC Association
    DYNAMIC item1
    item1.relatedObjectType = "[record API]"
    item1.relatedObjectId = "[#]"
    createPayload.entities.association[1] = item1
    
    DYNAMIC createTicketPayload
    createTicketPayload.workflowInput = createPayload
    
    ASSIGN createTicketJson = "{createTicketPayload.asjson()}"
    		

    그러한 각 라인을 포함해야 합니다. 필드를 비워 두려는 경우, null 값("")을 사용할 수 있습니다. 예를 들면 createPayload.entities.properties.hs_ticket_priority = ""입니다.

  5. createPayload 속성의 값을 변경합니다.

    1. createPayload.entities.properties.subject 속성의 값을 티켓의 주제로 변경합니다: 티켓이 생성된 이유. 예를 들면 createPayload.entities.properties.subject = "Query about mass book orders"입니다. 이 값은 하드 코딩되거나 변수이거나 이들의 조합일 수 있습니다. 각 인터랙션에 대해 값을 업데이트하려면 변수를 사용합니다.

    2. createPayload.entities.properties.hs_pipeline 속성의 값을 티켓의 파이프라인 번호로 변경합니다. 예를 들면 createPayload.entities.properties.hs_pipeline = "0"입니다.

    3. createPayload.entities.properties.hs_pipeline_stage 속성의 값을 파이프라인에서 티켓의 상태를 나타내는 번호로 변경합니다. 예를 들면 createPayload.entities.properties.hs_pipeline_stage = "3"입니다.

    4. createPayload.entities.properties.hs_ticket_priority 속성의 값을 LOW, MEDIUM 또는 HIGH(으)로 변경합니다.

  6. item1 속성의 값을 변경합니다.

    1. item1.relatedObjectType 속성의 값을 이 워크플로에 연결할 엔터티에 대한 API로 변경합니다. 예를 들면 item1.relatedObjectType = "companies"입니다. 이는 대소문자를 구분합니다.

    2. item1.relatedObjectId 속성의 값을 이 워크플로에 연결할 엔터티에 대한 ID 번호로 변경합니다. 예를 들면 item1.relatedObjectId = "19019671367"입니다.

  7. 스크립트를 저장합니다.

  8. Studio에서 인터랙션을 시뮬레이션하여 스크립트를 테스트할 수 있습니다.

레코드 고정

고객 카드의 현재 인터랙션에 레코드를 고정할 수 있습니다.

  1. 고정하려는 레코드에 대해 워크플로가 포함된 SNIPPET을 엽니다.

  2. 이 코드 줄을 복사한 다음 DYNAMIC create[RecordType]Payload 앞에 붙여넣습니다.

    						
    createPayload.pinnedRecord = "true"					
    		
  3. 스크립트를 저장합니다.