Integrar Salesforce Einstein

El contenido de esta página corresponde a un producto o función que forma parte de un programa de vista previa pública. Si no forma parte de la vista previa y desea obtener más información, comuníquese con su representante de cuenta.

Prerrequisitos

To usar Salesforce Einstein agentes virtualesClosed A software application that handles customer interactions in place of a live human agent. con NiCE CXone, necesita:

  • Una cuenta de Salesforce con privilegios administrativos.
  • Un agente virtual de Salesforce Einstein configurado y capacitado para ofrecer respuestas que cumplan con las solicitudes de sus contactos.
  • API Postman (opcional).

Crear un script

Permisos requeridos: Studio, Ver script, Crear/Editar

Necesita al menos un script de Studio para dirigir las interacciones hacia su agente virtual. Siga las pautas del script. La acción de agente virtual admitida para este proveedor es Intercambio de textbot y su script debe tener el tipo DE soporte DE mediosClosed A medium, such as voice, email, and chat, through which a contact connects with an intended recipient. digital.

Puede obtener más información sobre la creación de scripts de Studio en las secciones Fundamentals y Referencia Técnico Guide de la ayuda en línea.

Genere un certificado JWT y Claves

Usará el certificado y las claves durante el proceso de configuración de la integración. Para completar esta tarea, debe tener instalado OpenSSL.

  1. Usando una utilidad de línea de comandos, desplácese hasta el directorio donde desea crear los archivos.
  2. Escriba el comando openssl y presione Intro.
  3. Type the following commands one by one. Press Enter after each one: 
    • openssl genrsa -out private-key.pem 3072
    • openssl rsa -in private-key.pem -pubout -out public-key.pem
    • openssl req -new -x509 -key private-key.pem -out cert.der -days 360
  4. Check the specified directory to verify that you have the following files: 
    • cert.der
    • private-key-pem
    • public-key.pem

Crear y configurar una Aplicación conectada de Salesforce

Siga estos pasos para crear una aplicación conectada en Salesforce Lightning. Las aplicaciones conectadas permiten que Salesforce se integre con aplicaciones externas, como NiCE CXone.

En la primavera de 2026, Salesforce dejará de permitirle crear aplicaciones conectadas. Podrá seguir usando las aplicaciones conectadas existentes, pero deberá contactar a Salesforce Soporte para crear otras nuevas. Consulte el anuncio de Salesforce Icon of a square with an arrow pointing out from the top right corner para obtener más información.

  1. Inicie sesión en Salesforce usando una cuenta con privilegios administrativos.
  2. Create a connected app: 
    1. Vaya a configuración y busque App Manager en la barra de búsqueda rápida ubicada en el lado izquierdo de la página.
    2. En el App Manager, haga clic en Nueva Aplicación conectada.
    3. Complete la sección Información básica en la página Administrar aplicaciones conectadas.
    4. En API (Habilitar Configuración de OAuth), seleccione Habilitar Configuración de OAuth.
    5. Seleccione Habilitar firmas Digital, luego haga clic en Elegir archivo y cargue el certificado que se creó cuando generó el JWT.
    6. From the Selected OAuth Scopes list, add the following scopes: 
      • Acceder a recursos de API REST de Connect (chatter_API)
      • Acceder a servicios de Chatbot (chatbot_API)
      • Realizar solicitudes en cualquier momento (refresh_token, offline_access)
    7. Hacer clicGuardar.
  3. Configure OAuth policies and add an administrator profile for the app you just created: 
    1. En Herramientas de la plataforma, en el menú del lado izquierdo de la página, haga clic en Apps > Connected Apps > Manage Connected Apps.
    2. Seleccione la aplicación que creó.
    3. Haga clic en editar políticas.
    4. En OAuthPolíticas, seleccione Los usuarios aprobados por el administrador están preautorizados en la lista desplegable Usuarios permitidos.
    5. Desde el menú desplegable IP Relaxation, seleccione Relax IP restrictions.
    6. Guarde sus cambios.
    7. En la misma página, desplácese hacia abajo hasta Perfiles y agregue un perfil de Administrador del Sistema.
  4. Enable Manage Consume Details to get the keys: 
    1. En Herramientas de la plataforma, en el menú del lado izquierdo de la página, haga clic en Apps > Connected Apps > Manage Connected Apps.
    2. En la lista desplegable de la aplicación Gestionar autenticación, haga clic en Ver.
    3. En API (Habilitar Configuración de OAuth), haga clic en Administrar Detalles del consumidor. Salesforce envía un correo electrónico con un código de verificación a la dirección DE correo electrónico utilizada en su cuenta de Salesforce.
    4. Ingrese el código en la ventana Verifique su identidad.
    5. Copie las claves, que aparecen debajo de Consumer Details.

Conectar Salesforce Einstein con la Aplicación conectada

Después de crear la Aplicación conectada en Salesforce, debe conectarla a Salesforce Einstein.

  1. En Salesforce Einstein, seleccione Perspectiva general en el menú desplegable de la esquina superior izquierda de la página.
  2. En Conexiones, haga clic en Agregar.
  3. En la ventana Agregar conexiones, seleccione API en el menú desplegable Conexión.
  4. Escriba un Nombre de la integración.
  5. Seleccione el nombre de la Aplicación conectada que creó en la tarea anterior.
  6. Tome nota de la URL indicada debajo de la URL base de tiempo de ejecución.Necesitará esta información para una tarea posterior.
  7. Hacer clicGuardar.

Generar un Token de portador JWT

Debe generar un token web JSON (JWT) para usar con su integración. Estos pasos describen un método para generar el token. Si tiene un método distinto de su preferencia, úselo con los parámetros que se detallan en los próximos pasos.

  1. Abra su navegador web y vaya al sitio web jwt.io Un cuadrado con una flecha que apunta desde el centro hacia la esquina superior derecha..
  2. En el menú desplegable Algoritmo, seleccione RS256.
  3. In the Payload field, add the following details in JSON: 
    • iss: Ingrese el OAuth client_id para la aplicación conectada para la cual creó el certificado.
    • aud: The authorization server is the intended audience. Use one of the following URLs: 
      • https://login.salesforce.com

      • https://test.salesforce.com

      • https://site.force.com/customers (si está implementando para un sitio Experience Cloud)

    • sub: El nombre DE usuario del usuario Salesforce Agent que genera el token, si se implementa un sitio de Experience Cloud. Para lograr la compatibilidad con versiones anteriores, puede usar principal (prn) en su lugar. Si tanto sub como prn están incluidas, se usa prn.

    • exp: La hora de expiración del JWT. Ingrese la hora como la cantidad de segundos desde 1970-01-01T00:00:00Z UTC. El tiempo utilizado puede ser preciso dentro de un margen de tres minutos respecto a la hora real de vencimiento.

  4. Pegue el contenido de los archivos public-key.pem y private-key.pem en los campos debajo de Verify Signature. Estos SOn DOs de los archivos que descargó cuando creó el certificado.
  5. Haga clic en Compartir JWT para copiar el JWT a su portapapeles.

Prueba con Postman

Después de generar su token, puede usar Postman Un cuadrado con una flecha que apunta desde el centro hacia la esquina superior derecha. para probar la funcionalidad de autorización, si lo desea. Si elige hacer esto, use la información siguiente en su solicitud:

  • Verbo: POST
  • URL: https://login.salesforce.com/services/oauth2/token
  • Body: Add the following key-value pairs: 
    • "grant_type" : "urn:ietf:params:oauth:grant-type:jwt-bearer"

    • "assertion" : "{your bearer token}"

Cuando recibe el token de autorización, envíe una solicitud POST al agente virtual de Einstein para probar su capacidad para responder. Use la URL para su instancia de Salesforce. En la siguiente imagen se observa un ejemplo de la solicitud.

Agregar una aplicación a Virtual Agent Hub

Permisos requeridos: Connections Hub > Iniciar Connections Hub

Agregar una aplicación de configuración a Virtual Agent Hub establece la conexión entre NiCE CXone y su proveedor de agentes virtuales.

  1. En NiCE CXone, haga clic en el selector de aplicaciones Icon of three-by-three grid of white squares on a blue background y seleccione Otro > Connection Hub y luego haga clic en Virtual Agent Hub. También puede hacer doble clic en la acción de agente virtual en su script de Studio para iniciar Virtual Agent Hub.
  2. Haga clic en Añadir bot.
  3. Ingrese un nombre DE agente virtual (bot) y haga clic en Salesforce Einstein Bot en la lista de proveedores de agentes virtuales.

  4. Hacer clicpróximo.

  5. Complete los campos del formulario de configuración y haga clic en Siguiente. Puede encontrar detalles sobre este formulario en la sección Detalles de la Página de configuración de esta página.

  6. Hacer clicpróximo.

  7. En la página Voice, seleccione Text Only (No Voice Support) en la página Voice.

  8. En la página Transcript, seleccione la opción correspondiente si desea que se capturen la transcripción de la conversación y la información de intención. Si esta pestaña no está disponible, la función no está habilitada para su abonadoClosed High-level organizational grouping used to manage technical support, billing, and global settings for your NiCE CXone system.. Comuníquese con su representante de cuenta de NiCE CXone para obtener más información sobre esta función.

  9. Hacer clicpróximo.

  10. En la página Test + Add, puede probar la conexión de su bot enviando avisos de voz o de texto. Si sus mensajes de Prueba no funcionan, haga clic en Back para volver a la página Configuration y verificar la configuración.

  11. Hacer clicAgregar.

Salesforce Einstein Detalles de la Página de configuración

Use la información de la siguiente tabla al completar la página configuración. Esta página se muestra al agregar una aplicación en Virtual Agent Hub

Campo

Detalles

Versión DE integración ```

versión de Virtual Agent Hub que desea utilizar. Esta opción le permite usar una versión anterior de Virtual Agent Hub hasta que esté listo para cambiar a una versión reciente. Las versiones disponibles SOn:

  • Versión 1.0.0: Esta versión no está disponible para este proveedor.
  • Versión 2.0.0: Esta versión no está disponible para este proveedor.
  • Versión 3.0.0: Esta versión introdujo StandardBot, que estandariza la forma en que NiCE CXone se comunica con los proveedores de agentes virtuales. El objeto customPayload se devuelve como una matriz, como customPayloadscriptPayloads[n].xxxx. Esta versión está disponible para todos los proveedores.
```
Afirmación El token de portador JWT que generó.
URL base

La URL base de su instancia de Salesforce Einstein.

Debe haber anotado esto al crear la aplicación conectada en Salesforce. Si no copió la URL cuando completó la tarea, puede seguir los pasos ahora, deteniéndose antes del paso donde se hace clic en Guardar.

ID de la org

Su ID de organización en Salesforce.

Puede encontrar esta información en Salesforce buscando Información de la empresa en el cuadro de búsqueda rápida ubicado en la parte superior izquierda de la página principal. En la página Información de la empresa, copie la Información del campo Salesforce.com Organization ID.

Id bot

El nombre DE bot para el agente virtual de Einstein que desea usar con NiCE CXone.

Puede encontrar esta información en Salesforce dirigiéndose a la página principal y seleccionando su bot. La barra de direcciones de su navegador contiene una URL con un parámetro de consulta botId. Copie el ID de la URL. Por ejemplo, en la siguiente URL, debería copiar el texto en negrita:

http://[baseURL]/dialogs/detail?botID=0Xx5e00000IPWHCA2&versionId=0X9500000....[truncado]

Tiempo límite del proveedor externo ```

Especifique la cantidad de segundos que desea que el script espere una respuesta de Salesforce Einstein. Cuando se alcanza el tiempo límite, el control regresa al script, que toma la rama de error.

```

Asignar la aplicación de Salesforce Einstein a una Acción

Permisos requeridos: Studio, Ver script, Crear/Editar

Cuando la app de agente virtualClosed The meaning or purpose behind what a contact says/types; what the contact wants to communicate or accomplish. está configurada en Virtual Agent Hub, debe asignarla a la acción de agente virtual en su script. Esto conecta la acción y el script a su proveedor de agente virtual.

  1. En Studio, abra el script que desea modificar.
  2. Si no lo ha hecho todavía, haga clic en la pestaña Tools , expanda la categoría Automation and AI y agregue la acción de agente virtual que desea utilizar. Asegúrese de colocarlo en la ubicación correcta en su script. Si no ve la acción que espera, verifique que su tipo DE soporte DE medios de script es correcto.Por ejemplo, si está creando un script para un agente virtual de voz, el script debe ser un script de teléfono.

  3. Click Open Editor on the action to open Virtual Agent Hub.

  4. En la columna izquierda, ubique el perfil de agente virtual que desea asignar a la acción y haga clic en la marca de verificación Un ícono de un círculo con una marca de verificación adentro. que aparece junto a este.

    Una alternativa a usar la marca de verificación es crear una variable en su script de Studio. Utilice la variable para pasar el nombre de la aplicación del agente virtual a la propiedad ID de Agente virtual de la acción Virtual Agent Hub que está utilizando.

  5. Haga clic en Cerrar.

Pruebe su conexión del Agente virtual

Permisos requeridos: Connections Hub > Iniciar Connections Hub

Puede probar muchos aspectos de su agente virtual para asegurarse de que todo funcione según lo previsto. Puede ejecutar pruebas desde la página propiedades de la aplicación agente virtual en Virtual Agent Hub. Al realizar una prueba, puede:

  • Verificar que la aplicación del agente virtual está correctamente configurada para comunicarse con el proveedor del agente virtual.
  • Agregar JSON de carga útil personalizada para probar el manejo del agente virtual de los datos de carga útil personalizados.
  • Active un evento de intención DE bienvenida para probar cómo el agente virtual inicia una conversación.
  • Active un evento de intención personalizado para probar cualquier evento personalizado que haya creado para su agente virtual.
  • Activar un evento de tiempo DE espera para probar cómo responde el agente virtual cuando se agota el tiempo DE espera del contacto.

La siguiente imagen es un ejemplo de la página de propiedades de una aplicación de agente virtual en Virtual Agent Hub (no Salesforce Einstein). Muestra las pestañas configuración y Voz y el panel Prueba.

  1. En NiCE CXone, haga clic en el selector de aplicaciones Icon of three-by-three grid of white squares on a blue background y seleccione Otro > Connection Hub y luego haga clic en Virtual Agent Hub. También puede hacer doble clic en la acción de agente virtual en su script de Studio para iniciar Virtual Agent Hub.
  2. Haga clic para seleccionar la aplicación de configuración para el agente virtual que desea probar de la lista de la izquierda.
  3. En el panel Prueba, ingrese un mensaje de prueba en el campo Tipo de mensaje y presione intro para enviarlo.

  4. Haga clic en Comience con intención DE bienvenida para iniciar una conversación de prueba desde el principio. El agente virtual responde con su mensaje de bienvenida predeterminado. Puede ingresar mensajes de prueba.
  5. Haga clic en Más opcionesUn ícono con tres puntos verticales. para probar otros aspectos de su agente virtual.

  6. Haga clic en Restablecer para comenzar su prueba de nuevo.
  7. Si necesita realizar cambios en función de los resultados de su prueba, puede:

    • Modifique los scripts de Studio para el agente virtual.
    • Modifique la configuración de la aplicación del agente virtual en Virtual Agent Hub.
    • Modifique la configuración del agente virtual en la consola del proveedor. Haga clic en el botón cuadrado grande en la página de propiedades de la aplicación en Virtual Agent Hub. El ejemplo al comienzo de esta sección muestra la aplicación Google Dialogflow CX con el botón del proveedor. It has the Un icono que tiene un cuadrado con una flecha superpuesta encima. La flecha apunta desde el centro del cuadrado hasta la esquina superior derecha del cuadrado. ícono en él para indicar que el enlace abre un sitio externo.
  8. Pruebe exhaustivamente el agente virtual después de cada cambio en sus Scripts o en cualquier configuración.
  9. Cuando haya terminado la prueba, haga clic en Close.