Presentación
Conecte Salesforce para que el asistente de IA y los agentes puedan buscar en objetos de Salesforce seleccionados en el momento en que un usuario hace una pregunta.
Este es un conector en tiempo real. No se copia, indexa ni almacena nada de Salesforce en Docebo. Cuando un usuario hace una pregunta, Docebo busca en los objetos de Salesforce que usted ha puesto a disposición en ese momento, utilizando la propia cuenta de Salesforce del usuario.
Cómo funcionan los permisos de Salesforce: cada compañero conecta su propia cuenta de Salesforce la primera vez que hace una pregunta. Después, cada búsqueda se ejecuta como ese usuario, por lo que Salesforce aplica sus propias reglas de acceso y los usuarios solo ven los registros que Salesforce les permite ver. La cuenta de Salesforce de cada usuario debe tener el permiso API habilitada (consulte Configuración necesaria).
1. Requisitos previos en el sistema de origen
Rol necesario
Necesita un administrador de Salesforce que pueda crear una aplicación cliente externa.
Configuración necesaria
Toda persona que haga preguntas sobre datos de Salesforce necesita un usuario de Salesforce con el permiso API habilitada. El perfil de administrador del sistema y la mayoría de los perfiles estándar lo tienen.
Para comprobarlo, abra Perfiles en Salesforce, haga clic en el perfil del usuario y busque API habilitada entre sus permisos. Un conjunto de permisos también puede concederlo.
2. Preparación en el sistema de origen
Cree una aplicación cliente externa en Salesforce y copie su clave de consumidor y secreto de consumidor en Docebo.
¿Ya tiene una aplicación? Reutilícela. Ábrala en el Administrador de aplicaciones clientes externas y compruebe la configuración de Activar OAuth y añadir la URL de devolución de llamada, Solicitar el secreto y crear la aplicación y Permitir que los usuarios se conecten: la URL de devolución de llamada, los cuatro ámbitos, Solicitar secreto para el flujo de servidor web y Relajar las restricciones de IP. Después, continúe con Copiar la clave de consumidor y el secreto de consumidor.
Abrir la página Nueva aplicación cliente externa
- En Docebo, en la pestaña Autorizar, haga clic en Abrir la página Nueva aplicación cliente externa. Salesforce se abre en una pestaña nueva.
- Inicie sesión con una cuenta de administrador de Salesforce si Salesforce se lo solicita.
- Verá el formulario Nueva aplicación cliente externa. Mantenga esta ventana abierta.
Si el enlace no abre el formulario: en Salesforce, haga clic en el icono de engranaje en la esquina superior derecha y, después, en Configuración. Escriba Administrador de aplicaciones clientes externas en Búsqueda rápida, ábralo y haga clic en Nueva aplicación cliente externa.
Asignar un nombre a la aplicación
En Información básica:
- Nombre de la aplicación cliente externa: escriba un nombre, por ejemplo, «Conocimientos de IA de Docebo».
- Nombre de la API: Salesforce lo completa automáticamente.
- Correo electrónico de contacto: escriba su dirección de correo electrónico.
- Estado de distribución: deje Local.
No haga clic en Crear todavía.
Activar OAuth y añadir la URL de devolución de llamada
- Desplácese hacia abajo y haga clic en API (Activar configuración de OAuth) para abrirla.
- Marque Activar OAuth.
- Pegue la URL de devolución de llamada en URL de devolución de llamada. Debe coincidir exactamente. Siga este patrón: https://[YOUR-DOCEBO-PLATFORM-URL]/knowledge/v1/integrations/connections/callback, por ejemplo, https://demo.docebosaas.com/knowledge/v1/integrations/connections/callback.
- En Ámbitos de OAuth, seleccione cada uno de los cuatro ámbitos siguientes en Ámbitos de OAuth disponibles y muévalo a Ámbitos de OAuth seleccionados con el botón de flecha.
| Ámbito | Código |
|---|---|
| Administrar datos de usuario mediante API | api |
| Realizar solicitudes en cualquier momento | refresh_token, offline_access |
| Acceder a identificadores de usuario únicos | openid |
| Acceder al servicio de URL de identidad | id, profile, email, address, phone |
Solicitar el secreto y crear la aplicación
- Desplácese hacia abajo hasta Seguridad.
- Marque Solicitar secreto para el flujo de servidor web y Solicitar secreto para el flujo de token de actualización.
- Deje todo lo demás como está. Las casillas atenuadas están configuradas por Salesforce y no se pueden cambiar.
- Haga clic en Crear en la parte inferior de la página.
Permitir que sus usuarios se conecten
Salesforce muestra ahora la página de su nueva aplicación.
- En la pestaña Políticas, haga clic en Editar.
- Haga clic en Políticas de OAuth para abrirla.
- En Autorización de la aplicación, establezca Relajación de IP en Relajar las restricciones de IP.
- Deje Usuarios permitidos en Todos los usuarios pueden autorizarse automáticamente y la política de tokens de actualización en 30 días.
- Haga clic en Guardar.
Copiar la clave de consumidor y el secreto de consumidor
- Abra la pestaña Configuración de la aplicación y haga clic en Configuración de OAuth para abrirla.
- Haga clic en Clave y secreto de consumidor. Salesforce abre una pestaña nueva.
- Salesforce le envía por correo electrónico un código de verificación. Escríbalo y haga clic en Verificar.
- Haga clic en Copiar junto a Clave de consumidor y péguela en Clave de consumidor en Docebo.
- Haga clic en Copiar junto a Secreto de consumidor y péguelo en Secreto de consumidor en Docebo.
3. Acciones necesarias en Docebo
| Información a introducir | Dónde encontrarla |
|---|---|
| Clave de consumidor | Salesforce → su aplicación → Configuración → Configuración de OAuth → Clave y secreto de consumidor |
| Secreto de consumidor | Salesforce → su aplicación → Configuración → Configuración de OAuth → Clave y secreto de consumidor |
Autorizar el conector
- Vaya a Complementos e integraciones → Conectores de conocimientos → Crear → Salesforce. Este menú solo es visible para Superadministradores. En la pestaña Descripción general, revise qué se buscará y seleccione Comenzar.
En la pestaña Configuración, indique a Docebo qué organización de Salesforce debe utilizar. Abra Salesforce en otra pestaña del navegador e inicie sesión, copie la dirección completa de la barra de direcciones y péguela en Pegue su dirección de Salesforce (recomendado). Cualquier página de Salesforce funciona, por ejemplo, la página de inicio. Esto funciona para cualquier organización, incluidas las que bloquean la página de inicio de sesión estándar. Docebo mostrará entonces la dirección en la que sus usuarios iniciarán sesión. Como alternativa, seleccione Usar la página de inicio de sesión estándar (login.salesforce.com, para las ediciones de producción o Developer) o Usar la página de inicio de sesión del entorno sandbox (test.salesforce.com). Seleccione Continuar.
En la pestaña Autorizar, introduzca la clave de consumidor y el secreto de consumidor (consulte la tabla anterior) y seleccione Autenticar.
Inicie sesión en Salesforce en la ventana que se abre y haga clic en Permitir. ¿Salesforce indica que la aplicación es desconocida o no está aprobada? Una aplicación nueva puede tardar unos minutos en estar lista. Espere unos minutos y vuelva a hacer clic en Autenticar. ¿Está renovando la autenticación de un conector que ya funciona? Deje vacíos la clave de consumidor y el secreto de consumidor; se utilizarán los valores guardados.
En la pestaña Objetos, seleccione los objetos de Salesforce que contienen conocimientos relevantes, por ejemplo, Casos, Cuentas o artículos de Knowledge. Utilice el cuadro de búsqueda para encontrar un objeto y seleccione Borrar selección para empezar de nuevo. Después, seleccione Guardar. No se copia ni se indexa nada. Esto solo define qué objetos se pueden añadir a las colecciones de conocimientos.