Salesforceのイベント

詳細については、以下を参照してください。 購読タイプごとのイベント (Genesys Cloud Developer Center)を参照してください。

管理者は、統合が起動してイベントを待機するようにコールセンター設定を構成します。

1. Salesforceで、をクリックします セットアップ。
2. 検索する インストール済みパッケージ。
3. 下 造るクリック インストール済みパッケージ。
4. の インストール済みパッケージ ページをクリックし、 設定 [Genesys Cloud for Salesforce]パッケージの隣に表示されます。
5. 下 クライアントイベント設定、次の項目を構成します クライアントイベントメッセージ：
6. にとって クライアントイベントメッセージタイプ、 選択する Window.postMessage API。

   この設定により、クライアントがロードするたびに統合によってハンドシェイクイベントが発生します。 

7. （オプション） クライアントイベントタイプ、購読する他のイベント（Interaction、Notification、およびUserAction）を選択します。 クリック 矢印  下に追加するには 選択.
8. （オプション）選択 チャット通知を展開 チャット通知イベント用の拡張ペイロードを受信します。
9. 保存するをクリックします。

詳細については、以下を参照してください。 新しいチケットを設定する.

Salesforceクライアント用Genesys Cloudは、postMessage Web APIを通じて生成された次のアクションを公開します。

• アドアソシエーション
• Interaction.addCustomAttributes
• Interaction.createConference
• Interaction.updateState
• User.updateStatus
• subscribe

アドアソシエーション

インタラクションログに新しい連絡先または関係の関連付けを追加します。

パラメーター

データオブジェクト

アクションを定義します。

パラメーター

例

この例では、統合により、ID1234と表示名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"
        }
    }
}

Interaction.createConference

複数のインタラクションから会議を作成します。

パラメーター

データオブジェクト

アクションを定義します。

パラメーター

例

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

Interaction.updateState

インタラクションの状態を更新します。

パラメーター

データオブジェクト

アクションを定義します。

パラメーター

見る participantContextオブジェクト.

転送を受信するエンティティを定義します。

パラメーター

secureSessionContext オブジェクトsecureSessionContext object

転送を受信するエンティティを定義します。

パラメーター

例

次の例は、エージェントまたはキューにコンサルテーションなしで転送されたインタラクションを示しています。

{
    "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,
        }
    }
}

User.updateStatus

アップデートユーザー ステータス 。

パラメーター

データオブジェクト

アクションを定義します。

パラメーター

例

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

subscribe

クライアントイベントをサブスクライブします。

パラメーター

データオブジェクト

アクションを定義します。

パラメーター

サブスクリプションタイプごとのイベント

例

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

Salesforceがコールセンター設定で選択されたイベントをリッスンして起動できるように照明コンポーネントを作成します。 

1. AZZ、コンポーネント、およびJavaScriptファイルをSalesforceの開発者コンソールに追加します。

   サンプルファイルは、次のサイトからダウンロードできます。 PureCloud for Salesforceアインシュタインの例 GitHubのリポジトリ。

   詳細については、 開発者コンソールのファイルメニュー Salesforceドキュメントにあります。

2. をセットする タイプ そして id JavaScriptファイルのソース用。

   この設定により、クライアントのステータスを変更できます。

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

3. 管理者がInteraction、Notification、またはUserActionsイベントを発生させるように統合を設定した場合は、JavaScriptファイルでこれらのイベントを購読します。

   詳細については、 購読 メソッドを Genesysクラウド組み込み可能フレームワーク ドキュメンテーション(Genesys Cloud Developer Center)。

詳細については、以下を参照してください。 購読タイプごとのイベント (Genesys Cloud Developer Center)を参照してください。

管理者は、統合が起動してイベントを待機するようにコールセンター設定を構成します。

1. Salesforceで、をクリックします セットアップ。
2. 検索する インストール済みパッケージ。
3. 下 造るクリック インストール済みパッケージ。
4. の インストール済みパッケージ ページをクリックし、 設定 [Genesys Cloud for Salesforce]パッケージの隣に表示されます。
5. 下 クライアントイベント設定、次の項目を構成します クライアントイベントメッセージ：
6. にとって クライアントイベントメッセージタイプ、 選択する ライトニングメッセージチャネル。 
   

   この設定により、統合はメッセージチャネルでメッセージを送信します。 

7. （オプション）下 クライアントイベントタイプ、サブスクライブする他のイベント（Interaction、Notification、およびUserAction）を選択します。 クリック 矢印  下に追加するには 選択.
8. （オプション）選択 チャット通知を展開 チャット通知イベント用の拡張ペイロードを受信します。
9. 保存するをクリックします。

詳細については、以下を参照してください。 新しいチケットを設定する.

Salesforceクライアント用Genesys Cloudは、Lightning Message Serviceから提起された次のアクションを公開します。

• アドアソシエーション
• Interaction.addCustomAttributes
• Interaction.createConference
• Interaction.updateState
• User.updateStatus
• subscribe

アドアソシエーション

インタラクションログに新しい連絡先または関係の関連付けを追加します。

パラメーター

データオブジェクト

アクションを定義します。

パラメーター

例

この例では、統合により、ID1234と表示名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"
        }
    }
}

Interaction.createConference

複数のインタラクションから会議を作成します。

パラメーター

データオブジェクト

アクションを定義します。

パラメーター

例

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

Interaction.updateState

インタラクションの状態を更新します。

パラメーター

データオブジェクト

アクションを定義します。

パラメーター

見る participantContextオブジェクト.

転送を受信するエンティティを定義します。

パラメーター

secureSessionContext オブジェクトsecureSessionContext object

転送を受信するエンティティを定義します。

パラメーター

例

次の例は、エージェントまたはキューにコンサルテーションなしで転送されたインタラクションを示しています。

{
    "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,
        }
    }
}

User.updateStatus

アップデートユーザー ステータス 。

パラメーター

データオブジェクト

アクションを定義します。

パラメーター

例

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

subscribe

クライアントイベントをサブスクライブします。

パラメーター

データオブジェクト

アクションを定義します。

パラメーター

サブスクリプションタイプごとのイベント

例

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

メッセージチャネルをサブスクライブするには、 PureCloud for Salesforce管理パッケージのバージョンX以降をインストールします。 管理パッケージのこれらのバージョンには、 purecloud__ClientEvent__c すべてのメッセージを受信するチャネル。 購読した後 purecloud__ClientEvent__c、 Salesforceはコールセンターの設定で選択されたイベントをリッスンしてSalesforceできます。 

実装方法は、使用するコンポーネントによって異なります。 次のコード例は、Lightning AuraコンポーネントでLMSを使用する方法を示しています。

でLightningメッセージを購読する purecloud__ClientEvent__c Auraコンポーネントのチャネル。

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

Lightningメッセージを受信するには、 onClientEvent.

({
    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メッセージを送信するには、Salesforceクライアント用Genesys Cloudがリッスンするイベントを公開します。 イベントのリストについては、 Salesforce向けGenesys Cloudとの通信 セクション。

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

他の例については、 Lightningメッセージサービス[開発者プレビュー] Salesforce Developers Blogをご覧ください。