In Salesforce bearbeiten

Weitere Informationen finden Sie unter Ereignisse pro Abonnementtyp (Genesys Cloud Developer Center) in der Genesys Cloud Embeddable Framework Dokumentation

Administratoren konfigurieren die Callcenter-Einstellungen so, dass die Integration Ereignisse auslöst und abhört.

1. Klicken Sie in Salesforce auf Setup.
2. Suche nach Installierte Pakete.
3. Klicken Sie unter Buildauf Installierte Pakete.
4. Klicken Sie auf der Seite Installed Packages auf Configure neben dem Paket Genesys Cloud for Salesforce.
5. Unter Client-Ereigniseinstellungenkonfigurieren Sie die folgenden Elemente für Client-Ereignisnachrichten:
6. Für Client Event Message Type, wählen Sie Window.postMessage API.

   Diese Einstellung bewirkt, dass die Integration ein Handshake-Ereignis auslöst, sobald der Client geladen wird. 

7. (Optional) Wählen Sie unter Client Event Typesandere Ereignisse (Interaction, Notification und UserAction) aus, die Sie abonnieren möchten. Klicken Sie auf Pfeil , um sie unter Ausgewähltehinzuzufügen.
8. (Optional) Wählen Sie Chat-Benachrichtigung erweitern , um eine erweiterte Nutzlast für Chat-Benachrichtigungsereignisse zu erhalten
9. Klicken Sie auf Speichern.

Weitere Informationen finden Sie unter Konfigurieren von Client-Ereignissen.

Der Genesys Cloud for Salesforce-Client stellt die folgenden Aktionen zur Verfügung, die durch die postMessage Web APIs ausgelöst werden.

• addAssociation
• Interaction.addCustomAttributes
• Interaktion.createConference
• Interaktion.updateState
• User.updateStatus
• Abonnieren

addAssociation

Fügt eine neue Kontakt- oder Beziehungsassoziation zu Interaktionsprotokollen hinzu.

Parameter

datenobjekt

Definiert die Aktion.

Parameter

Beispiele

In diesem Beispiel fügt die Integration eine neue Kontaktzuordnung mit der ID 1234 und dem angezeigten Namen John Smith zu einer Interaktion hinzu.

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

Interaction.addCustomAttributes

Fügt benutzerdefinierte Attribute zu Interaktionen hinzu.

Parameter

datenobjekt

Definiert die Aktion.

Parameter

Beispiel

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

Interaktion.createConference

Erzeugt eine Konferenz aus mehreren Interaktionen.

Parameter

datenobjekt

Definiert die Aktion.

Parameter

Beispiel

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

Interaktion.updateState

Aktualisiert den Status einer Interaktion.

Parameter

datenobjekt

Definiert die Aktion.

Parameter

participantContext-Objekt

Legt die Entität fest, die die Übertragung erhält.

Parameter

secureSessionContext-Objekt

Legt die Entität fest, die die Übertragung erhält.

Parameter

Beispiele

Das folgende Beispiel zeigt eine Interaktion, die ohne Rückfrage an einen Agenten oder eine Warteschlange übertragen wurde.

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

Das folgende Beispiel zeigt eine Interaktion, die in einen sicheren IVR-Flow übertragen wird.

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

Aktualisiert den Benutzerstatus.

Parameter

datenobjekt

Definiert die Aktion.

Parameter

Beispiel

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

Abonnieren

Meldet sich für Kundenveranstaltungen an.

Parameter

datenobjekt

Definiert die Aktion.

Parameter

Ereignisse pro Abonnementtyp

Beispiel

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

Erstellen Sie eine Beleuchtungskomponente, damit Salesforce auf die in den Callcenter-Einstellungen ausgewählten Ereignisse warten und diese auslösen kann. 

1. Fügen Sie Apex-, Komponenten- und JavaScript-Dateien zur Entwicklerkonsole in Salesforce hinzu.

   Sie können Beispieldateien aus dem PureCloud für Salesforce Einstein Example Repository auf GitHub herunterladen

   Weitere Informationen finden Sie unter Developer Console File Menu in der Salesforce-Dokumentation

2. Legen Sie den Typ und id für die Quelle in der JavaScript-Datei fest.

   Mit dieser Einstellung können Sie den Status im Client ändern.

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

3. Wenn Ihr Administrator die Integration so konfiguriert hat, dass Interaktions-, Benachrichtigungs- oder UserActions-Ereignisse ausgelöst werden, abonnieren Sie diese Ereignisse in der JavaScript-Datei.

   Weitere Informationen finden Sie unter der Methode subscribe in der Dokumentation Genesys Cloud Embeddable Framework (Genesys Cloud Developer Center).

Weitere Informationen finden Sie unter Ereignisse pro Abonnementtyp (Genesys Cloud Developer Center) in der Genesys Cloud Embeddable Framework Dokumentation

Administratoren konfigurieren die Callcenter-Einstellungen so, dass die Integration Ereignisse auslöst und abhört.

1. Klicken Sie in Salesforce auf Setup.
2. Suche nach Installierte Pakete.
3. Klicken Sie unter Buildauf Installierte Pakete.
4. Klicken Sie auf der Seite Installed Packages auf Configure neben dem Paket Genesys Cloud for Salesforce.
5. Unter Client-Ereigniseinstellungenkonfigurieren Sie die folgenden Elemente für Client-Ereignisnachrichten:
6. Für Client Event Message Type, wählen Sie Lightning Message Channel. 
   

   Diese Einstellung veranlasst die Integration, Nachrichten auf dem Nachrichtenkanal zu senden. 

7. (Optional) Wählen Sie unter Client Event Typesandere Ereignisse (Interaction, Notification und UserAction) aus, die Sie abonnieren möchten. Klicken Sie auf Pfeil , um sie unter Ausgewähltehinzuzufügen.
8. (Optional) Wählen Sie Chat-Benachrichtigung erweitern , um eine erweiterte Nutzlast für Chat-Benachrichtigungsereignisse zu erhalten
9. Klicken Sie auf Speichern.

Weitere Informationen finden Sie unter Konfigurieren von Client-Ereignissen.

Der Genesys Cloud for Salesforce-Client stellt die folgenden Aktionen zur Verfügung, die durch den Lightning Message Service ausgelöst werden.

• addAssociation
• Interaction.addCustomAttributes
• Interaktion.createConference
• Interaktion.updateState
• User.updateStatus
• Abonnieren

addAssociation

Fügt eine neue Kontakt- oder Beziehungsassoziation zu Interaktionsprotokollen hinzu.

Parameter

datenobjekt

Definiert die Aktion.

Parameter

Beispiele

In diesem Beispiel fügt die Integration eine neue Kontaktzuordnung mit der ID 1234 und dem angezeigten Namen John Smith zu einer Interaktion hinzu.

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

Interaction.addCustomAttributes

Fügt benutzerdefinierte Attribute zu Interaktionen hinzu.

Parameter

datenobjekt

Definiert die Aktion.

Parameter

Beispiel

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

Interaktion.createConference

Erzeugt eine Konferenz aus mehreren Interaktionen.

Parameter

datenobjekt

Definiert die Aktion.

Parameter

Beispiel

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

Interaktion.updateState

Aktualisiert den Status einer Interaktion.

Parameter

datenobjekt

Definiert die Aktion.

Parameter

participantContext-Objekt

Legt die Entität fest, die die Übertragung erhält.

Parameter

secureSessionContext-Objekt

Legt die Entität fest, die die Übertragung erhält.

Parameter

Beispiele

Das folgende Beispiel zeigt eine Interaktion, die ohne Rückfrage an einen Agenten oder eine Warteschlange übertragen wurde.

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

Das folgende Beispiel zeigt eine Interaktion, die in einen sicheren IVR-Flow übertragen wird.

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

Aktualisiert den Benutzerstatus.

Parameter

datenobjekt

Definiert die Aktion.

Parameter

Beispiel

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

Abonnieren

Meldet sich für Kundenveranstaltungen an.

Parameter

datenobjekt

Definiert die Aktion.

Parameter

Ereignisse pro Abonnementtyp

Beispiel

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

Um den Nachrichtenkanal zu abonnieren, installieren Sie Version 3.12 oder höher des verwalteten Pakets von PureCloud für Salesforce Diese Versionen von des verwalteten Pakets enthalten den purecloud__ClientEvent__c Kanal, der alle Nachrichten empfängt Nachdem Sie purecloud__ClientEvent__cabonniert haben, kann Salesforce auf die in den Call Center-Einstellungen ausgewählten Ereignisse warten und diese auslösen. 

Die Implementierungsmethode variiert je nach den von Ihnen verwendeten Komponenten. Der folgende Beispielcode zeigt, wie Sie LMS mit einer Lightning Aura-Komponente verwenden.

Abonnieren Sie Lightning-Nachrichten auf dem Kanal purecloud__ClientEvent__c für eine Aura-Komponente

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

Um Lightning-Nachrichten zu empfangen, erstellen Sie ein 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);
            }
        }
    }
})

Um Lightning-Nachrichten zu senden, veröffentlichen Sie die Ereignisse, auf die der Genesys Cloud for Salesforce-Client wartet. Eine Liste der Ereignisse finden Sie im Abschnitt Kommunikation mit Genesys Cloud für Salesforce

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

Weitere Beispiele finden Sie unter Lightning Message Service [Developer Preview] im Salesforce Developers Blog