SDKを使用してSalesforce Eメールをルーティングする


注意:この記事は、PureCloud for Salesforceに適用されます。

あなたはのルーティング設定した後Salesforceに電子メールをSalesforce 、ルートに管理パッケージで私たちのSDKを使用してSalesforceを介して電子メールPureCloudのためSalesforce 。SDKはSalesforce Apexプログラミング言語を使用しています。スクリーンポップを設定したり、インタラクションの詳細を変更したり、 Salesforceアクティビティレコードにデータを追加したりできます。

以下のEmailクラスからSDKにアクセスします purecloud.SDK.Email およびpurecloud.Email名前空間。purecloud.Email名前空間を使用して、件名、fromName、およびfromAddressの情報を設定します。

注意:この記事は、Salesforceに精通している開発者を対象とした高度なカスタマイズのトピックです。

前提条件

  • 認証 構成されています。

メールクラス

PureCloud for Salesforce介してSalesforceメールをPureCloudする静的メソッドが含まれています。

名前空間

purecloud.SDK.Email 

使用法

これらのメソッドを使用して、 PureCloud for Salesforce介してSalesforceメールをルーティングするPureCloudメールオブジェクトを作成します。これらのオブジェクトには、スクリーンポップを設定したり、 インタラクション詳細を変更したり、 Salesforceアクティビティレコードにデータを追加したりするためのデータを含めることができます。

例1

この例は、次のアクションを実行する方法を示しています。

  • Salesforceメールを指定されたキューにルーティングします。
  • 指定したSalesforceページをスクリーンポップします。

Apexコードを使用したインタラクション詳細

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

例2

この例は、次のアクションを実行する方法を示しています。

  • 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);

メール方法

以下はメールの方法です。

  • create(queue, sfUrlPopValue)

    Salesforce電子メールを指定されたキューにルーティングし、指定されたSalesforceページを画面にポップします。

  • create(queue, skills, language, attributes)

    PureCloud組織内の指定されたスキルと言語が割り当てられている指定されたキュー内のエージェントにSalesforceメールをPureCloudし、attributesパラメーターを使用してアクションを実行します。

  • create()

    purecloud.Emailオブジェクトをインスタンス化します。purecloud.Emailを参照してくださいタブ 。

 

create(queue, sfUrlPopValue)

メールのやり取りを指定されたキューにルーティングし、指定されたSalesforceページを画面にポップします。

パラメーター

キュー

タイプ:文字列

キュー引数は、 PureCloud組織のキューです。このキューは、 Salesforceメールをルーティングするキューです。中Call.QueueNameにマップインタラクションの詳細。

sfUrlPopValue

タイプ:文字列

sfUrlPopValue引数は、のURLの値であるSalesforceあなたがしたいとページスクリーンポップアップアップ時にインタラクションのアラート。

 

create(queue, skills, language, attributes)

PureCloud組織内の指定されたスキルと言語が割り当てられている指定されたキュー内のエージェントにSalesforceメールをPureCloudし、attributesパラメーターを使用してアクションを実行します。

パラメーター

キュー

タイプ:文字列

キュー引数は、 PureCloud組織のキューです。このキューは、 Salesforceメールをルーティングするキューです。中Call.QueueNameにマップインタラクションの詳細。

スキル

タイプ:リスト<String>

スキルの引数は、 PureCloud組織のスキルのリストです。このスキルのリストは、 Salesforceメールを受信するエージェントに関連付けられています。

言語

タイプ:文字列

言語の引数は言語であるスキルあなたの中PureCloud組織。この言語スキルは、 Salesforceメールを受信するエージェントに関連付けられています。

属性

タイプ:地図<String, Object>

属性引数は、 Salesforceページまたは検索結果、またはSalesforceインタラクションの詳細またはアクティビティレコードに追加するデータを含むことができる属性のマップです。

キー 説明 タイプ 必須 メモ
SF_URLPop インタラクションがアラートをスクリーンポップアップときにスクリーンポップアップするSalesforceページのID ひも オプショナル SF_URLPopまたはSF_SearchValueのいずれかを使用してください。両方は使用できません。スクリーンポップの処理を高速化するには、SF_URLPopを使用します。
SF_SearchValue インタラクションがアラートをスクリーンポップアップときに検索たいSalesforce 検索結果のID ひも オプショナル SF_URLPopまたはSF_SearchValueのいずれかを使用してください。両方は使用できません。スクリーンポップの処理を高速化するには、SF_URLPopを使用します。
{カスタム属性 } インタラクションがアラートを発したときのインタラクションの詳細またはアクティビティレコードへのデータ 文字列、整数、ブール オプショナル

 

create()

purecloud.Emailオブジェクトをインスタンス化します。purecloud.Email参照タブ 。

メールクラス

PureCloud電子メールインタラクションをPureCloudます。PureCloud for Salesforce介してSalesforceメールをルーティングするメソッドが含まれています。

名前空間

purecloud.Email 

使用法

これらのメソッドを使用して、 PureCloudメールオブジェクトを作成します。これらのオブジェクトには、スクリーンポップを設定したり、 インタラクション詳細を変更したり、 Salesforceアクティビティレコードにデータを追加したりするためのデータを含めることができます。これらのオブジェクトは、件名、fromName、およびfromAddressの情報も設定できます。

これらの例は、電子メールオブジェクトを作成し、プロパティを使用して次のアクションを実行する方法を示しています。

  • ルートSalesforceスキルや言語、またはルートに割り当てられている指定されたキュー内のエージェントへの電子メールSalesforce使用してエージェントに電子メールをArchitect割り当てスキルと言語のインバウンド電子メールの流れを。
  • 指定した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();

メール方法

以下はメールの方法です。

  • create()

    作成しPureCloud インタラクション定義されているインスタンスの属性を持ちます。

 

create()

作成しPureCloud インタラクション定義されているインスタンスの属性を持ちます。

プロパティ

キュー

タイプ:文字列

キュープロパティは、 PureCloud組織のキューです。このキューは、 Salesforceメールをルーティングするキューです。中Call.QueueNameにマップインタラクションの詳細。

スキル

タイプ:リスト<String>

スキルプロパティは、 PureCloud組織のスキルのリストです。このスキルのリストは、 Salesforceメールを受信するエージェントに関連付けられています。

言語

タイプ:文字列

言語プロパティは言語であるスキルあなたの中PureCloud組織。この言語スキルは、 Salesforceメールを受信するエージェントに関連付けられています。

属性

タイプ:地図<String, Object>

属性プロパティは、 Salesforceページまたは検索結果、またはSalesforceインタラクションの詳細またはアクティビティレコードに追加するデータを含むことができる属性のマップです。

キー 説明 タイプ 必須 メモ
SF_URLPop インタラクションがアラートをスクリーンポップアップときにスクリーンポップアップするSalesforceページのID ひも オプショナル SF_URLPopまたはSF_SearchValueのいずれかを使用してください。両方は使用できません。スクリーンポップの処理を高速化するには、SF_URLPopを使用します。
SF_SearchValue インタラクションがアラートをスクリーンポップアップときに検索たいSalesforce 検索結果のID ひも オプショナル SF_URLPopまたはSF_SearchValueのいずれかを使用してください。両方は使用できません。スクリーンポップの処理を高速化するには、SF_URLPopを使用します。
{カスタム属性 } インタラクションがアラートを発したときにインタラクションの詳細またはアクティビティレコードに追加されるデータ 文字列、整数、ブール オプショナル

件名

タイプ:文字列

件名プロパティは、アクティブなインタラクションのメール件名回線です。このメールの件名回線は、インタラクションがアラートを回線とインタラクションの詳細に追加されます。インタラクションの詳細でEmail.Subjectにマップします。

名前から

タイプ:文字列

fromNameプロパティは、アクティブな対話のリモート名です。このリモート名は、インタラクションがアラートを出すと、インタラクションの詳細に追加されます。へのマップ Call.RemoteName インタラクションの詳細。

fromAddress

タイプ:文字列

fromAddressプロパティは、アクティブな対話のリモート電子メールアドレスです。このリモート電子メールアドレスは、インタラクションがアラートを発したときにインタラクションの詳細に追加されます。インタラクションの詳細でSalesforce.DisplayAddressにマップします。

詳細については、 Salesforceメールのルーティングを構成するプロセスビルダーを使用してSalesforceメールをルーティングする、そして Salesforceメールのルーティングについて

統合について詳しくは、以下を参照してください。 SalesforceのPureCloudについて