Salesforce에서 편집

자세한 내용은 구독 유형별 이벤트 (Genesys Cloud Developer Center) Genesys Cloud Embeddable Framework 설명서.

관리자는 통합이 실행되고 이벤트를 수신하도록 콜 센터 설정을 구성합니다.

1. Salesforce에서 설정.
2. 검색 설치된 패키지.
3. 아래에 짓다, 클릭 설치된 패키지.
4. 에 설치된 패키지 페이지, 클릭 구성 Genesys Cloud for Salesforce 패키지 옆에 있습니다.
5. 아래에 클라이언트 이벤트 설정, 다음 항목을 구성하십시오. 클라이언트 이벤트 메시지:
6. 을위한 클라이언트 이벤트 메시지 유형, 선택하다 창.postMessage API.

   이 설정을 사용하면 클라이언트가 로드될 때마다 통합에서 핸드셰이크 이벤트가 발생합니다. 

7. (선택 사항) 클라이언트 이벤트 유형, 구독할 다른 이벤트(상호작용, 알림 및 UserAction)를 선택합니다. 딸깍 하는 소리 화살 아래에 추가하려면 선택됨.
8. (선택 사항) 선택 채팅 알림 확장 채팅 알림 이벤트에 대한 확장된 페이로드를 수신합니다.
9. 딸깍 하는 소리 구하다.

자세한 내용은 클라이언트 이벤트 구성.

Genesys Cloud for Salesforce 클라이언트는 postMessage 웹 API를 통해 발생하는 다음 작업을 노출합니다.

• 추가 연결
• Interaction.addCustomAttributes
• 상호작용.createConference
• 상호 작용.업데이트 상태
• 사용자.업데이트 상태
• 구독

추가 연결

상호 작용 로그에 새 연락처 또는 관계 연결을 추가합니다.

매개 변수

데이터 개체

동작을 정의합니다.

매개 변수

예

이 예에서 통합은 ID가 1234이고 표시 이름이 John Smith인 새 연락처 연결을 상호 작용에 추가합니다.

{ 
  "type": "PureCloud.addAssociation",  
  "data": { 
      "type": "contact", 
      "id": "1234", 
      "text": "John Smith"
   } 
}

Interaction.addCustomAttributes

상호 작용에 사용자 정의 속성을 추가합니다.

매개 변수

데이터 개체

동작을 정의합니다.

매개 변수

예

{
    "type": "PureCloud.Interaction.addCustomAttributes", 
    "data": {
        "id": "1234-1234-1234-1234",
        "attributes": {
            "record_url": "/0000413456"
        }
    }
}

상호작용.createConference

여러 상호 작용에서 회의를 만듭니다.

매개 변수

데이터 개체

동작을 정의합니다.

매개 변수

예

{
    "type": "PureCloud.Interaction.createConference", 
    "data": {
        "interactionIds": [
            "9641cedc-4cc2-48e1-84f7-fc4xxxx513e8",
            "5eafbfc4-6ff4-40e4-a2d7-dxxxxxxxx809", 
            "363ba2ca-xxxx-405e-bebe-fc59b1ae517b"
         ]
    }
}

상호 작용.업데이트 상태

상호작용의 상태를 업데이트합니다.

매개 변수

데이터 개체

동작을 정의합니다.

매개 변수

참가자 컨텍스트 개체

전송을 받는 엔터티를 정의합니다.

매개 변수

secureSessionContext 객체

전송을 받는 엔터티를 정의합니다.

매개 변수

예

다음 예는 상담 없이 상담원이나 대기열로 전달된 대화를 보여줍니다.

{
    "type": "PureCloud.Interaction.updateState", 
    "data": {
        "action": "blindTransfer",
        "id": "1234-1234-1234-1234",
        "participantContext": {
            "transferTarget": "3175550123",
            "transferTargetType": "address"
        }
    }
}

다음 예는 보안 IVR 흐름으로 전송된 상호 작용을 보여줍니다.

{
    "type": "PureCloud.Interaction.updateState", 
    "data": {
        "action": "secureSession",
        "id": "1234-1234-1234-1234",
        "secureSessionContext": {
            "flowId": "741f4f39-7a94-470d-a1dd-dd68d01e0dd8",
            "userData": "hello",
            "disconnect": false,
        }
    }
}

사용자.업데이트 상태

사용자 상태를 업데이트합니다.

매개 변수

데이터 개체

동작을 정의합니다.

매개 변수

예

{
    "type": "PureCloud.User.updateStatus", 
    "data": {
        "id": "1234-1234-1234-1234"
    }
} 

구독

클라이언트 이벤트를 구독합니다.

매개 변수

데이터 개체

동작을 정의합니다.

매개 변수

구독 유형별 이벤트

예

{
 "type": "PureCloud.subscribe",
 "data": {
     "type": "Notification",
     "categories": ["interactionSelection", "chatUpdate", "interactionWindow", "conversationTranscription"]
  }
}

Salesforce가 콜 센터 설정에서 선택한 이벤트를 수신하고 실행할 수 있도록 조명 구성 요소를 만듭니다. 

1. Salesforce의 개발자 콘솔에 Apex, 구성 요소 및 JavaScript 파일을 추가합니다.

   에서 샘플 파일을 다운로드할 수 있습니다. Salesforce Einstein용 PureCloud 예 GitHub의 저장소.

   자세한 내용은 개발자 콘솔 파일 메뉴 Salesforce 문서에서.

2. 설정 유형 그리고 ID JavaScript 파일의 소스용.

   이 설정을 사용하면 클라이언트에서 상태를 변경할 수 있습니다.

   source.postMessage({
       type: 'PureCloud.User.updateStatus',
       data: { id: status },
   }

3. 관리자가 Interaction, Notification 또는 UserActions 이벤트를 실행하도록 통합을 구성한 경우 JavaScript 파일에서 이러한 이벤트를 구독하십시오.

   자세한 내용은 구독하다 방법 Genesys Cloud 내장형 프레임워크 문서(Genesys Cloud Developer Center).

자세한 내용은 구독 유형별 이벤트 (Genesys Cloud Developer Center) Genesys Cloud Embeddable Framework 설명서.

관리자는 통합이 실행되고 이벤트를 수신하도록 콜 센터 설정을 구성합니다.

1. Salesforce에서 설정.
2. 검색 설치된 패키지.
3. 아래에 짓다, 클릭 설치된 패키지.
4. 에 설치된 패키지 페이지, 클릭 구성 Genesys Cloud for Salesforce 패키지 옆에 있습니다.
5. 아래에 클라이언트 이벤트 설정, 다음 항목을 구성하십시오. 클라이언트 이벤트 메시지:
6. 을위한 클라이언트 이벤트 메시지 유형, 선택하다 번개 메시지 채널. 
   

   이 설정은 통합이 메시지 채널에서 메시지를 보내도록 합니다. 

7. (선택 사항) 클라이언트 이벤트 유형, 구독할 다른 이벤트(상호작용, 알림 및 UserAction)를 선택합니다. 딸깍 하는 소리 화살 아래에 추가하려면 선택됨.
8. (선택 사항) 선택 채팅 알림 확장 채팅 알림 이벤트에 대한 확장된 페이로드를 수신합니다.
9. 딸깍 하는 소리 구하다.

자세한 내용은 클라이언트 이벤트 구성.

Genesys Cloud for Salesforce 클라이언트는 Lightning Message Service를 통해 발생하는 다음 작업을 노출합니다.

• 추가 연결
• Interaction.addCustomAttributes
• 상호작용.createConference
• 상호 작용.업데이트 상태
• 사용자.업데이트 상태
• 구독

추가 연결

상호 작용 로그에 새 연락처 또는 관계 연결을 추가합니다.

매개 변수

데이터 개체

동작을 정의합니다.

매개 변수

예

이 예에서 통합은 ID가 1234이고 표시 이름이 John Smith인 새 연락처 연결을 상호 작용에 추가합니다.

{ 
  "type": "PureCloud.addAssociation",  
  "data": { 
      "type": "contact", 
      "id": "1234", 
      "text": "John Smith"
   } 
}

Interaction.addCustomAttributes

상호 작용에 사용자 정의 속성을 추가합니다.

매개 변수

데이터 개체

동작을 정의합니다.

매개 변수

예

{
    "type": "PureCloud.Interaction.addCustomAttributes",
    "data": {
        "id": "1234-1234-1234-1234",
        "attributes": {
            "record_url": "/0000413456"
        }
    }
}

상호작용.createConference

여러 상호 작용에서 회의를 만듭니다.

매개 변수

데이터 개체

동작을 정의합니다.

매개 변수

예

{
    "type": "PureCloud.Interaction.createConference", 
    "data": {
        "interactionIds": [
            "9641xxxx-4bb2-xxxx-84f7-xxxxxx8513e8",
            "5eafbfc4-6ff4-xxxx-a2d7-d23c1abbd809", 
            "363ba2ca-xxxx-405e-bebe-fc59xxxxx17b"
         ]
    }
}

상호 작용.업데이트 상태

상호작용의 상태를 업데이트합니다.

매개 변수

데이터 개체

동작을 정의합니다.

매개 변수

참가자 컨텍스트 개체

전송을 받는 엔터티를 정의합니다.

매개 변수

secureSessionContext 객체

전송을 받는 엔터티를 정의합니다.

매개 변수

예

다음 예는 상담 없이 상담원이나 대기열로 전달된 대화를 보여줍니다.

{
    "type": "PureCloud.Interaction.updateState", 
    "data": {
        "action": "blindTransfer",
        "id": "1234-1234-1234-1234",
        "participantContext": {
            "transferTarget": "3175550123",
            "transferTargetType": "address"
        }
    }
}

다음 예는 보안 IVR 흐름으로 전송된 상호 작용을 보여줍니다.

{
    "type": "PureCloud.interaction.updateState", 
    "data": {
        "action": "secureSession",
        "id": "1234-1234-1234-1234",
        "secureSessionContext": {
            "flowId": "741f4f39-7a94-470d-a1dd-dd68d01e0dd8",
            "userData": "hello",
            "disconnect": false,
        }
    }
}

사용자.업데이트 상태

사용자 상태를 업데이트합니다.

매개 변수

데이터 개체

동작을 정의합니다.

매개 변수

예

{
    "type": "PureCloud.User.updateStatus",
    "data": {
        "id": "1234-1234-1234-1234"
    }
} 

구독

클라이언트 이벤트를 구독합니다.

매개 변수

데이터 개체

동작을 정의합니다.

매개 변수

구독 유형별 이벤트

예

{
 "type": "PureCloud.subscribe",
 "data": {
     "type": "Notification",
     "categories": ["interactionSelection", "chatUpdate", "interactionWindow", "conversationTranscription"]
  }
}

메시지 채널을 구독하려면 버전 3.12를 설치하십시오. Salesforce용 PureCloud 관리 패키지 이상. 이러한 버전의 관리 패키지에는 다음이 포함됩니다. 퓨어클라우드__클라이언트 이벤트__c 모든 메시지를 수신하는 채널. 구독 후 퓨어클라우드__클라이언트 이벤트__c, Salesforce는 콜 센터 설정에서 선택한 이벤트를 수신하고 실행할 수 있습니다. 

구현 방법은 사용하는 구성 요소에 따라 다릅니다. 다음 예제 코드는 Lightning Aura 구성 요소와 함께 LMS를 사용하는 방법을 보여줍니다.

에서 Lightning 메시지를 구독하십시오. 퓨어클라우드__클라이언트 이벤트__c Aura 구성 요소에 대한 채널입니다.

<lightning:messageChannel type="purecloud__ClientEvent__c" aura:id="clientEventMessageChannel" onMessage="{!c.onClientEvent}" scope="APPLICATION"/>

Lightning 메시지를 수신하려면 클라이언트 이벤트.

({
    onClientEvent: function (component, message, helper) {
        var eventData = message.getParams();
        if (eventData) {
            if(eventData.type === 'Interaction' && eventData.data.id) {
		console.log(‘Interaction ID: ‘ + eventData.data.id);
            }
        }
    }
})

Lightning 메시지를 보내려면 Genesys Cloud for Salesforce 클라이언트가 수신하는 이벤트를 게시하십시오. 이벤트 목록은 다음을 참조하십시오. Salesforce용 Genesys Cloud와 통신 부분.

component.find('clientEventMessageChannel').publish({
    type: 'PureCloud.User.updateStatus',
    data: { id: status }
});

다른 예는 다음을 참조하십시오. 번개 메시지 서비스 [개발자 미리보기] Salesforce 개발자 블로그에서.