Utilice el SDK para enrutar los correos electrónicos de Salesforce

Nota: Este artículo se aplica a Genesys Cloud para Salesforce.

Después de configurar el enrutamiento de los correos electrónicos de Salesforce en Salesforce, use nuestro SDK en el paquete administrado para enrutar los correos electrónicos de Salesforce a través de Genesys Cloud para Salesforce. El SDK utiliza el lenguaje de programación Salesforce Apex. 

Nota: Este artículo de personalización avanzada está destinado a desarrolladores que estén familiarizados con Salesforce.

Prerrequisitos

Acceda a nuestro SDK a través de la clase Correo electrónico en el purecloud.SDK.Email y purecloud. espacios de nombres. Utilizar el purecloud. espacio de nombres para establecer información para el asunto, fromName y fromAddress.

Clase de correo electrónico

Contiene métodos estáticos para enrutar los correos electrónicos de Salesforce a través de Genesys Cloud para Salesforce.

Espacio de nombres

purecloud.SDK.Email

Uso

Utilice estos métodos para crear objetos de correo electrónico de Genesys Cloud que enruten los correos electrónicos de Salesforce a través de Genesys Cloud para Salesforce. Estos objetos pueden contener datos para configurar pantallas emergentes, modificar detalles de interacción o agregar datos a los registros de actividad en Salesforce.

Métodos de correo electrónico

Los siguientes métodos están disponibles para la clase de correo electrónico.

Dirige una interacción de correo electrónico a una cola específica y la pantalla muestra una página específica de Salesforce.

Parámetros

Nombre Tipo de datos Descripción Notas
cola Cuerda Ponga en cola en su organización Genesys Cloud a la que desea que se envíen los correos electrónicos de Salesforce. Mapas a Call.QueueName en los detalles de la interacción.
sfUrlPopValue Cuerda Valor en la URL de la página de Salesforce que desea que aparezca en pantalla cuando se alerta una interacción.

Ejemplo

El siguiente ejemplo muestra cómo realizar estas acciones:

  • Enrute los correos electrónicos de Salesforce a una cola específica.
  • Pantalla emergente de una página específica de Salesforce.

Detalles de la interacción mediante el código Apex

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

Enruta los correos electrónicos de Salesforce a los agentes en una cola específica a quienes se les asignan habilidades e idiomas específicos en su organización de Genesys Cloud, y utiliza el parámetro de atributos para realizar acciones.

Parámetros

Nombre Tipo de datos Descripción Notas
cola Cuerda Ponga en cola en su organización Genesys Cloud a la que desea que la integración enrute los correos electrónicos de Salesforce. Mapas a Call.QueueName en los detalles de la interacción.
habilidades Lista<String> Lista de habilidades en su organización Genesys Cloud.  Asociado con agentes que desea recibir correos electrónicos de Salesforce.
idioma Cuerda Habilidad lingüística en su organización Genesys Cloud.  Asociado con agentes que desea recibir correos electrónicos de Salesforce.
atributos Mapa<String, Object=""> Ver Mapa de atributos.

Mapa de atributos

Un mapa de atributos que puede incluir una página de Salesforce o un resultado de búsqueda, o datos para agregar a los detalles de interacción o registros de actividad en Salesforce.

Parámetros

Llave Escribe Obligatorio u opcional Descripción Notas
SF_URLPop Cuerda Opcional ID de la página de Salesforce que desea que aparezca en la pantalla cuando una alerta de interacción Utilice SF_URLPop o SF_SearchValue, no ambos. Para un procesamiento más rápido de las ventanas emergentes, use SF_URLPop.
SF_SearchValue Cuerda Opcional ID del resultado de búsqueda de Salesforce que desea que aparezca en la pantalla cuando una alerta de interacción Utilice SF_URLPop o SF_SearchValue, no ambos. Para un procesamiento más rápido de las ventanas emergentes, use SF_URLPop.
{atributo personalizado} Cadena, entero, booleano Opcional Datos para agregar a los detalles de la interacción o a los registros de actividad cuando se genera una alerta de interacción.

Ejemplo

El siguiente ejemplo muestra cómo realizar estas acciones:

  • Enrute los correos electrónicos de Salesforce a los agentes en una cola específica a quienes se les asignan habilidades e idiomas específicos.
  • Pantalla emergente de una página específica de Salesforce.
  • Agregue un número de caso a los detalles de la interacción.
  • Agregue una dirección de correo electrónico remota a los registros de actividad en Salesforce.

Nota: Debido a que CaseNumber y contactEmailAddress son atributos personalizados, primero debe agregar Participant.{CustomFieldName} a las secciones Personalizar detalles de interacción y Asignación de campos de actividad en Configuración del cliente. Para obtener más información sobre la configuración del cliente, consulte Configuración de paquete administrado

Detalles de la interacción mediante el código 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);

Instancia purecloud. objetos. Ver el purecloud. pestaña. 

Clase de correo electrónico

Representa una interacción de correo electrónico de Genesys Cloud. Contiene métodos para enrutar los correos electrónicos de Salesforce a través de Genesys Cloud para Salesforce.

Espacio de nombres

purecloud.

Uso

Utilice estos métodos para crear objetos de correo electrónico de Genesys Cloud. Estos objetos pueden contener datos para configurar pantallas emergentes, modificar detalles de interacción o agregar datos a los registros de actividad en Salesforce. Estos objetos también pueden establecer información para sujeto, fromName y fromAddress.

Métodos de correo electrónico

Los siguientes métodos están disponibles para la clase de correo electrónico.

Crea la interacción de Genesys Cloud con atributos de instancia definidos. 

Propiedades

Nombre Tipo de datos Descripción Notas
cola Cuerda Ponga en cola en su organización Genesys Cloud a la que desea que la integración enrute los correos electrónicos de Salesforce. Mapas a Call.QueueName en los detalles de la interacción.
habilidades Lista<String> Lista de habilidades en su organización Genesys Cloud.  Asociado con agentes que desea recibir correos electrónicos de Salesforce.
idioma Cuerda Habilidad lingüística en su organización Genesys Cloud.  Asociado con agentes que desea recibir correos electrónicos de Salesforce.
atributos Mapa<String, Object=""> Ver Mapa de atributos.
tema Cuerda Línea de asunto del correo electrónico para la interacción activa. Agregado a los detalles de la interacción cuando se alerta una interacción. Mapas a correo electrónico Sujeto a los detalles de la interacción.
fromName Cuerda Nombre remoto para la interacción activa. Agregado a los detalles de la interacción cuando se alerta una interacción. Mapas a Call.RemoteName en los detalles de la interacción.
de la Dirección Cuerda La dirección de correo electrónico remota para la interacción activa. Agregado a los detalles de la interacción cuando se alerta una interacción. Se asigna a Salesforce.DisplayAddress en los detalles de la interacción.

Mapa de atributos

Un mapa de atributos que puede incluir una página de Salesforce o un resultado de búsqueda, o datos para agregar a los detalles de interacción o registros de actividad en Salesforce.

Parámetros

Llave Escribe Obligatorio u opcional Descripción Notas
SF_URLPop Cuerda Opcional ID de la página de Salesforce que desea que aparezca en la pantalla cuando se alerta una interacción. Utilice SF_URLPop o SF_SearchValue, no ambos. Para un procesamiento más rápido de las ventanas emergentes, use SF_URLPop.
SF_SearchValue Cuerda Opcional ID del resultado de búsqueda de Salesforce que desea que aparezca en la pantalla cuando una alerta de interacción. Utilice SF_URLPop o SF_SearchValue, no ambos. Para un procesamiento más rápido de las ventanas emergentes, use SF_URLPop.
{atributo personalizado} Cadena, entero, booleano Opcional Datos para agregar a los detalles de la interacción o a los registros de actividad cuando las alertas de interacción

Ejemplos de

Los siguientes ejemplos muestran cómo crear un objeto de correo electrónico y utilizar propiedades para realizar estas acciones:

  • Enrute los correos electrónicos de Salesforce a los agentes en una cola específica a los que se les asignan habilidades e idiomas, o enrute los correos electrónicos de Salesforce a los agentes mediante un flujo de correo electrónico entrante de Architect con habilidades e idiomas asignados.
  • Pantalla emergente de una página específica de Salesforce.
  • Agregue un número de caso a los detalles de la interacción.
  • Agregue una dirección de correo electrónico remota a los registros de actividad en Salesforce.
  • Agregue las propiedades subject, fromName y fromAddress a los detalles de la interacción.

Nota: Debido a que CaseNumber y contactEmailAddress son atributos personalizados, primero debe agregar Participant.{CustomFieldName} a las secciones Personalizar detalles de interacción y Asignación de campos de actividad en Configuración del cliente. Para obtener más información sobre la configuración del cliente, consulte Configuración de paquete administrado

Detalles de la interacción mediante el código Apex

Ejemplo de uso de la cola para enrutar correos electrónicos de 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();

Ejemplo de uso de un flujo de correo electrónico entrante para enrutar correos electrónicos de 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();

Para obtener más información, consulte Configurar el enrutamiento de correos electrónicos de Salesforce, Utilizar Flow Builder para enrutar correos electrónicos de Salesforce, y Acerca del enrutamiento de correos electrónicos de Salesforce

Para obtener más información sobre la integración, consulte Acerca de Genesys Cloud para Salesforce.