SDK를 사용하여 Salesforce 이메일 라우팅

참고: 이 문서는 Salesforce용 Genesys Cloud에 적용됩니다.

Salesforce에서 Salesforce 이메일 라우팅을 구성한 후 관리 패키지의 SDK를 사용하여 Salesforce용 Genesys Cloud를 통해 Salesforce 이메일을 라우팅합니다. SDK는 Salesforce Apex 프로그래밍 언어를 사용합니다. 

참고: 이 고급 사용자 정의 문서는 Salesforce에 익숙한 개발자를 대상으로 합니다.

전제 조건

아래의 Email 클래스를 통해 SDK에 액세스합니다. purecloud.SDK.이메일 그리고 퓨어클라우드.이메일 네임스페이스. 사용 퓨어클라우드.이메일 제목, fromName 및 fromAddress에 대한 정보를 설정하는 네임스페이스입니다.

이메일 수업

Salesforce용 Genesys Cloud를 통해 Salesforce 이메일을 라우팅하는 정적 메서드가 포함되어 있습니다.

네임스페이스

purecloud.SDK.이메일

사용

이 방법을 사용하여 Salesforce용 Genesys Cloud를 통해 Salesforce 이메일을 라우팅하는 Genesys Cloud 이메일 개체를 생성합니다. 이러한 개체에는 화면 팝업을 설정하거나 상호 작용 세부 정보를 수정하거나 Salesforce의 활동 레코드에 데이터를 추가하기 위한 데이터가 포함될 수 있습니다.

이메일 방법

Email 클래스에는 다음 메서드를 사용할 수 있습니다.

이메일 상호 작용을 지정된 대기열로 라우팅하고 지정된 Salesforce 페이지를 화면에 표시합니다.

매개 변수

이름 데이터 유형 설명 설명
문자열 Salesforce 이메일을 라우팅할 Genesys Cloud 조직의 대기열입니다. 상호 작용 세부 정보에서 Call.QueueName에 매핑됩니다.
sfUrlPopValue 문자열 상호 작용 경고 시 화면에 표시할 Salesforce 페이지 URL의 값입니다.

다음 예는 이러한 작업을 수행하는 방법을 보여줍니다.

  • Salesforce 이메일을 지정된 대기열로 라우팅합니다.
  • 지정된 Salesforce 페이지를 화면에 표시합니다.

Apex 코드를 사용한 상호 작용 세부 정보

purecloud.SDK.Email.create('CustomerService', '500360000015OCJ');

Salesforce 이메일을 Genesys Cloud 조직에서 지정된 기술 및 언어가 할당된 지정된 대기열의 상담원에게 라우팅하고 특성 매개변수를 사용하여 작업을 수행합니다.

매개 변수

이름 데이터 유형 설명 설명
문자열 Salesforce 이메일을 라우팅할 통합을 원하는 Genesys Cloud 조직의 대기열입니다. 상호 작용 세부 정보에서 Call.QueueName에 매핑됩니다.
기술 목록<String> Genesys Cloud 조직의 기술 목록입니다.  Salesforce 이메일을 수신하려는 상담원과 연결됩니다.
언어 문자열 Genesys Cloud 조직의 언어 능력.  Salesforce 이메일을 수신하려는 상담원과 연결됩니다.
속성 지도<String, Object=""> 보다 속성 맵.

속성 맵

Salesforce 페이지 또는 검색 결과 또는 Salesforce의 상호 작용 세부 정보 또는 활동 레코드에 추가할 데이터를 포함할 수 있는 속성의 맵입니다.

매개 변수

유형 필수 또는 선택 설명 설명
SF_URL팝 문자열 선택 사항 상호 작용 알림이 표시될 때 화면에 표시할 Salesforce 페이지의 ID SF_URLPop 또는 SF_SearchValue 중 하나만 사용하세요. 스크린 팝을 더 빠르게 처리하려면 SF_URLPop을 사용하십시오.
SF_검색값 문자열 선택 사항 상호 작용 경고 시 화면에 표시할 Salesforce 검색 결과의 ID SF_URLPop 또는 SF_SearchValue 중 하나만 사용하세요. 스크린 팝을 더 빠르게 처리하려면 SF_URLPop을 사용하십시오.
사용자 지정 속성 문자열, 정수, 부울 선택 사항 상호 작용 경고 시 상호 작용 세부 정보 또는 활동 레코드에 추가할 데이터입니다.

다음 예는 이러한 작업을 수행하는 방법을 보여줍니다.

  • 지정된 기술 및 언어가 할당된 지정된 대기열의 상담원에게 Salesforce 이메일을 라우팅합니다.
  • 지정된 Salesforce 페이지를 화면에 표시합니다.
  • 상호 작용 세부 정보에 사례 번호를 추가합니다.
  • Salesforce의 활동 레코드에 원격 이메일 주소를 추가합니다.

참고: CaseNumber 및 contactEmailAddress는 사용자 정의 속성이므로 먼저 참가자를 추가해야 합니다.{CustomFieldName}을(를) 클라이언트 설정 아래의 상호 작용 세부 정보 사용자 지정 및 활동 필드 매핑 섹션으로 이동합니다. 클라이언트 설정에 대한 자세한 내용은 다음을 참조하십시오. 관리되는 패키지 설정

Apex 코드를 사용한 상호 작용 세부 정보

String[] skills = new List<String>();
skills.add('Warranties');
skills.add('Cellphone repair');

String language = 'English - Spoken';

Map<String, Object> attributes = new Map<String, Object>();
attributes.put('SF_URLPop', '500360000015OCJ');
attributes.put('CaseNumber', 'Case: 000149');
attributes.put('contactEmailAddress', 'john.smith@customer.com');

purecloud.SDK.Email.create('CustomerService', skills, language, attributes);

인스턴스화 퓨어클라우드.이메일 사물. 참조 퓨어클라우드.이메일 탭. 

이메일 수업

Genesys Cloud 이메일 상호 작용을 나타냅니다. Salesforce용 Genesys Cloud를 통해 Salesforce 이메일을 라우팅하는 방법이 포함되어 있습니다.

네임스페이스

퓨어클라우드.이메일

사용

이 방법을 사용하여 Genesys Cloud 이메일 객체를 생성합니다. 이러한 개체에는 화면 팝업을 설정하거나 상호 작용 세부 정보를 수정하거나 Salesforce의 활동 레코드에 데이터를 추가하기 위한 데이터가 포함될 수 있습니다. 이러한 개체는 주제, fromName 및 fromAddress에 대한 정보도 설정할 수 있습니다.

이메일 방법

Email 클래스에는 다음 메서드를 사용할 수 있습니다.

정의된 인스턴스 속성과 Genesys Cloud 상호작용을 생성합니다. 

등록정보

이름 데이터 유형 설명 설명
문자열 Salesforce 이메일을 라우팅할 통합을 원하는 Genesys Cloud 조직의 대기열입니다. 상호 작용 세부 정보에서 Call.QueueName에 매핑됩니다.
기술 목록<String> Genesys Cloud 조직의 기술 목록입니다.  Salesforce 이메일을 수신하려는 상담원과 연결됩니다.
언어 문자열 Genesys Cloud 조직의 언어 능력.  Salesforce 이메일을 수신하려는 상담원과 연결됩니다.
속성 지도<String, Object=""> 보다 속성 맵.
제목 문자열 활성 상호 작용에 대한 이메일 제목 줄입니다. 상호 작용 경고 시 상호 작용 세부 정보에 추가되었습니다. 상호 작용 세부 정보의 Email.Subject에 매핑됩니다.
보낸 사람 이름 문자열 활성 상호 작용의 원격 이름입니다. 상호 작용 경고 시 상호 작용 세부 정보에 추가되었습니다. 상호 작용 세부 정보에서 Call.RemoteName에 매핑됩니다.
발신 주소 문자열 활성 상호 작용을 위한 원격 이메일 주소입니다. 상호 작용 경고 시 상호 작용 세부 정보에 추가되었습니다. 상호 작용 세부 정보에서 Salesforce.DisplayAddress에 매핑됩니다.

속성 맵

Salesforce 페이지 또는 검색 결과 또는 Salesforce의 상호 작용 세부 정보 또는 활동 레코드에 추가할 데이터를 포함할 수 있는 속성의 맵입니다.

매개 변수

유형 필수 또는 선택 설명 설명
SF_URL팝 문자열 선택 사항 상호 작용 경고가 표시될 때 화면에 표시할 Salesforce 페이지의 ID입니다. SF_URLPop 또는 SF_SearchValue 중 하나만 사용하세요. 스크린 팝을 더 빠르게 처리하려면 SF_URLPop을 사용하십시오.
SF_검색값 문자열 선택 사항 상호 작용 경고 시 화면에 표시할 Salesforce 검색 결과의 ID입니다. SF_URLPop 또는 SF_SearchValue 중 하나만 사용하세요. 스크린 팝을 더 빠르게 처리하려면 SF_URLPop을 사용하십시오.
사용자 지정 속성 문자열, 정수, 부울 선택 사항 상호 작용 알림 시 상호 작용 세부 정보 또는 활동 레코드에 추가할 데이터

다음 예에서는 전자 메일 개체를 만들고 속성을 사용하여 이러한 작업을 수행하는 방법을 보여줍니다.

  • 기술 및 언어가 할당된 지정된 대기열의 상담원에게 Salesforce 이메일을 라우팅하거나, 기술 및 언어가 할당된 설계자 인바운드 이메일 흐름을 사용하여 Salesforce 이메일을 상담원에게 라우팅합니다.
  • 지정된 Salesforce 페이지를 화면에 표시합니다.
  • 상호 작용 세부 정보에 사례 번호를 추가합니다.
  • Salesforce의 활동 레코드에 원격 이메일 주소를 추가합니다.
  • 주제, fromName 및 fromAddress 속성을 상호 작용 세부 정보에 추가합니다.

참고: CaseNumber 및 contactEmailAddress는 사용자 정의 속성이므로 먼저 참가자를 추가해야 합니다.{CustomFieldName}을(를) 클라이언트 설정 아래의 상호 작용 세부 정보 사용자 지정 및 활동 필드 매핑 섹션으로 이동합니다. 클라이언트 설정에 대한 자세한 내용은 다음을 참조하십시오. 관리되는 패키지 설정

Apex 코드를 사용한 상호 작용 세부 정보

대기열을 사용하여 Salesforce 이메일 라우팅의 예

String[] skills = new List<String>();
skills.add('Warranties');
skills.add('Cellphone repair');

Map<String, Object> attributes = new Map<String, Object>();
attributes.put('SF_URLPop', '500360000015OCJ');
attributes.put('CaseNumber', 'Case: 000149');
attributes.put('contactEmailAddress', 'john.smith@customer.com');

purecloud.Email email = purecloud.SDK.Email.create();
email.queue = 'CustomerService';
email.skills = skills;
email.language = 'English - Spoken';
email.attributes = attributes;
email.subject = 'Warranty Question'; 
email.fromName = 'John Smith'; 
email.fromAddress = 'john.smith@customer.com'; 
email.create();

Salesforce 이메일을 라우팅하기 위해 인바운드 이메일 흐름을 사용하는 예

Map<String, Object> attributes = new Map<String, Object>();
attributes.put('SF_URLPop', '500360000015OCJ');
attributes.put('CaseNumber', 'Case: 000149');
attributes.put('contactEmailAddress', 'john.smith@customer.com');

purecloud.Email email = purecloud.SDK.Email.create();
email.flow = 'RouteEmails';
email.attributes = attributes;
email.subject = 'Warranty Question'; 
email.fromName = 'John Smith'; 
email.fromAddress = 'john.smith@customer.com'; 
email.create();

자세한 내용은 Salesforce 이메일 라우팅 구성, Flow Builder를 사용하여 Salesforce 이메일 라우팅Salesforce 이메일 라우팅 정보를 참조하세요. 

통합에 대한 자세한 내용은 다음을 참조하십시오. Salesforce용 Genesys Cloud 정보.