Eventos en Salesforce

Para más información, ver Eventos por tipo de suscripción (Genesys Cloud Developer Center) en la documentación de Genesys Cloud Embeddable Framework.

Los administradores configuran la configuración del centro de llamadas para que la integración se active y escuche eventos.

1. En Salesforce, haga clic en Configuración.
2. Buscar Paquetes instalados.
3. Debajo Construir, haga clic en Paquetes instalados.
4. Sobre el Paquetes instalados página, haga clic en Configurar junto al paquete Genesys Cloud for Salesforce.
5. Debajo Configuración de eventos del cliente, configure los siguientes elementos para Mensajes de eventos del cliente:
6. Para Tipo de mensaje de evento del cliente, Seleccione API Window.postMessage.

   Esta configuración hace que la integración genere un evento de protocolo de enlace cada vez que se carga el cliente. 

7. (Opcional) Para Tipos de eventos del cliente, seleccione otros eventos (Interacción, Notificación y Acción del usuario) para suscribirse. Hacer clic Flecha para agregarlos debajo Elegido.
8. (Opcional) Seleccione Expandir notificación de chat para recibir una carga útil ampliada para eventos de notificación de chat.
9. Hacer clic Ahorrar.

Para más información, ver Configurar eventos de cliente.

El cliente Genesys Cloud for Salesforce expone las siguientes acciones planteadas a través de las API web postMessage.

• addAssociation
• Interaction.addCustomAttributes
• Interacción.createConference
• Interaction.updateState
• User.updateStatus
• Suscribir

addAssociation

Añade una nueva asociación de contacto o relación a los registros de interacción.

Parámetros

objeto de datos

Define la acción.

Parámetros

Ejemplos de

En este ejemplo, la integración añade una nueva asociación de contacto con el ID 1234 y el nombre mostrado John Smith a una interacción.

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

Interaction.addCustomAttributes

Agrega atributos personalizados a las interacciones.

Parámetros

objeto de datos

Define la acción.

Parámetros

Ejemplo

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

Interacción.createConference

Crea una conferencia a partir de múltiples interacciones.

Parámetros

objeto de datos

Define la acción.

Parámetros

Ejemplo

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

Interaction.updateState

Actualiza el estado de una interacción.

Parámetros

objeto de datos

Define la acción.

Parámetros

participantContext objeto

Define la entidad que recibe la transferencia.

Parámetros

objeto secureSessionContext

Define la entidad que recibe la transferencia.

Parámetros

Ejemplos de

El siguiente ejemplo muestra una interacción transferida a un agente o cola sin consulta.

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

El siguiente ejemplo muestra una interacción transferida a un flujo de IVR seguro.

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

Actualiza el estado del usuario.

Parámetros

objeto de datos

Define la acción.

Parámetros

Ejemplo

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

Suscribir

Se suscribe a eventos de clientes.

Parámetros

objeto de datos

Define la acción.

Parámetros

Eventos por tipo de suscripción

Ejemplo

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

Cree un componente de iluminación para que Salesforce pueda escuchar y activar los eventos seleccionados en la configuración del centro de llamadas. 

1. Agregue archivos Apex, componentes y JavaScript a Developer Console en Salesforce.

   Puede descargar archivos de muestra del Ejemplo de PureCloud para Salesforce Einstein repositorio en GitHub.

   Para más información, ver Menú de archivo de la consola del desarrollador en la documentación de Salesforce.

2. Selecciona el escribe y identificación para fuente en el archivo JavaScript.

   Esta configuración le permite cambiar los estados en el cliente.

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

3. Si su administrador configuró la integración para activar eventos de Interacción, Notificación o UserActions, suscríbase a estos eventos en el archivo JavaScript.

   Para obtener más información, consulte el suscribir método en el Marco integrable de Genesys Cloud documentación (Centro de desarrolladores de Genesys Cloud).

Para más información, ver Eventos por tipo de suscripción (Genesys Cloud Developer Center) en la documentación de Genesys Cloud Embeddable Framework.

Los administradores configuran la configuración del centro de llamadas para que la integración se active y escuche eventos.

1. En Salesforce, haga clic en Configuración.
2. Buscar Paquetes instalados.
3. Debajo Construir, haga clic en Paquetes instalados.
4. Sobre el Paquetes instalados página, haga clic en Configurar junto al paquete Genesys Cloud for Salesforce.
5. Debajo Configuración de eventos del cliente, configure los siguientes elementos para Mensajes de eventos del cliente:
6. Para Tipo de mensaje de evento del cliente, Seleccione Canal de mensajes relámpago. 
   

   Esta configuración hace que la integración envíe mensajes en el canal de mensajes. 

7. (Opcional) Para Tipos de eventos del cliente, seleccione otros eventos (Interacción, Notificación y Acción del usuario) para suscribirse. Hacer clic Flecha para agregarlos debajo Elegido.
8. (Opcional) Seleccione Expandir notificación de chat para recibir una carga útil ampliada para eventos de notificación de chat.
9. Hacer clic Ahorrar.

Para más información, ver Configurar eventos de cliente.

El cliente Genesys Cloud for Salesforce expone las siguientes acciones planteadas a través del Servicio de mensajes Lightning.

• addAssociation
• Interaction.addCustomAttributes
• Interacción.createConference
• Interaction.updateState
• User.updateStatus
• Suscribir

addAssociation

Añade una nueva asociación de contacto o relación a los registros de interacción.

Parámetros

objeto de datos

Define la acción.

Parámetros

Ejemplos de

En este ejemplo, la integración añade una nueva asociación de contacto con el ID 1234 y el nombre mostrado John Smith a una interacción.

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

Interaction.addCustomAttributes

Agrega atributos personalizados a las interacciones.

Parámetros

objeto de datos

Define la acción.

Parámetros

Ejemplo

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

Interacción.createConference

Crea una conferencia a partir de múltiples interacciones.

Parámetros

objeto de datos

Define la acción.

Parámetros

Ejemplo

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

Interaction.updateState

Actualiza el estado de una interacción.

Parámetros

objeto de datos

Define la acción.

Parámetros

participantContext objeto

Define la entidad que recibe la transferencia.

Parámetros

objeto secureSessionContext

Define la entidad que recibe la transferencia.

Parámetros

Ejemplos de

El siguiente ejemplo muestra una interacción transferida a un agente o cola sin consulta.

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

El siguiente ejemplo muestra una interacción transferida a un flujo de IVR seguro.

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

Actualiza el estado del usuario.

Parámetros

objeto de datos

Define la acción.

Parámetros

Ejemplo

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

Suscribir

Se suscribe a eventos de clientes.

Parámetros

objeto de datos

Define la acción.

Parámetros

Eventos por tipo de suscripción

Ejemplo

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

Para suscribirse al canal de mensajes, instale la versión 3.12 o posterior del paquete administrado PureCloud for Salesforce. Estas versiones de el paquete gestionado incluye el purecloud__ClientEvent__c canal que recibe todos los mensajes. Después de suscribirse a purecloud__ClientEvent__c, Salesforce puede escuchar y disparar los eventos seleccionados en la configuración del centro de llamadas. 

El método de implementación varía según los componentes que utilice. El siguiente código de ejemplo muestra cómo usar LMS con un componente Lightning Aura.

Suscríbase a los mensajes Lightning en el purecloud__ClientEvent__c canal para un componente Aura.

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

Para recibir mensajes Lightning, cree un 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);
            }
        }
    }
})

Para enviar mensajes Lightning, publique los eventos que escucha el cliente de Genesys Cloud for Salesforce. Para obtener una lista de eventos, consulte la Comuníquese con Genesys Cloud para Salesforce sección.

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

Para ver otros ejemplos, consulte Servicio de mensajes Lightning [Vista previa para desarrolladores] en el Blog de desarrolladores de Salesforce.