Si desea añadir una Knowledge Base de Salesforce, usando Talkdesk Knowledge Management™, lea las siguientes instrucciones para saber cómo conseguir los datos y autorizaciones necesarios en Salesforce.
Concesión de autorización para acceder a los datos de Salesforce
Se necesitan dos elementos para que Knowledge Management pueda acceder a los datos de una instancia específica de Salesforce:
- Una Connected App;
- Un usuario con un perfil con permisos para leer los datos y para usar la aplicación creada.
Creación de una Connected App
Para poder conectar Knowledge Management a una Knowledge Base de Salesforce, debe facilitar una clave y un secreto de cliente para poder conseguir un token de OAuth.
Para conseguir estos elementos, primero debe crear una aplicación conectada con la información necesaria:
- Vaya a su instancia de Salesforce, por ejemplo, https:/<your_domain>/.lightning.force.com/lightning/setup/</your_domain>
- Luego, vaya a Apps > App Manager.
- En la parte superior derecha, haga clic en New Connected App.
- Asigne un nombre a la aplicación (por ejemplo, Knowledge Management) e introduzca su dirección de correo electrónico.
- Marque la casilla "Enable OAuth Settings" (en la sección API) y complete toda la información requerida:
-
- La "Callback URL" no es necesaria, pero como el campo no se puede dejar vacío, introduzca https://login.salesforce.com/services/oauth2/callback
- En "Selected OAuth scopes", seleccione Access and manage your data (API). Nota importante: Es obligatorio que conceda su permiso en este paso para que el proceso se lleve a cabo correctamente.
-
6. Haga clic en Save cuando haya terminado.
- Una vez creada la aplicación conectada, deberían aparecer la Consumer Key y el Consumer Secret.
- Para verificar esta información más tarde, vaya a Apps > App Manager.
- Luego, haga clic en la flecha de la aplicación conectada que desea verificar y haga clic en View.
Notas:
- La Consumer Key corresponde al campo Client ID y el Consumer Secret corresponde al campo Client Secret, los cuales son necesarios para la configuración de Knowledge Management.
- Asegúrese de guardar ambas claves en un lugar seguro.
Creación de un perfil de usuario autorizado
Después de crear la aplicación conectada, se debe crear un perfil de usuario para Knowledge Management. Para ello, siga estos pasos:
- Vaya a Administration > Users > Profiles y haga clic en New Profile.
- En el menú desplegable "Existing Profile" , seleccione Read-Only y elija el "Profile Name" que desea usar.
- Al crear el nuevo perfil, el objetivo es otorgarle solo los permisos necesarios para usar la API REST y leer las Knowledge Bases:
- En "Connected App Access", marque la casilla junto al nombre de la aplicación creada para la Knowledge Management.
- En "Administrative Permissions", desmarque todas las casillas excepto la que está junto a "API Enabled" (tenga en cuenta que es posible que algunas casillas no se puedan desmarcar; deje las que no se puedan desmarcar tal como están).
- En "General User Permissions", desmarque todas las opciones que no se pueden marcar.
- En "Standard Object Permissions", desmarque todas las opciones que no se puedan marcar.
- En "Knowledge Base Permissions", marque la casilla de la columna "Read".
- Seleccione el perfil creado anteriormente como el usuario de Knowledge Management siguiendo estos pasos:
Nota: Si no existe ningún usuario para Knowledge Management, cree uno.
- Haga clic en Edit junto al usuario Knowledge Management.
- En "Profile", seleccione el perfil creado.
- Vaya a Apps > App Manager.
- Luego, haga clic en la flecha junto a la Copilot App y haga clic en Manage.
- En la página de gestión de la aplicación, haga clic en Edit Policies.
- En "OAuth Policies", cambie el valor de "Permitted Users" a Admin approved users are pre-authorized.
- Haga clic en Save.
Adición de los datos requeridos
En la sección "Connection Settings" de la Knowledge Base de Salesforce, rellene los campos obligatorios siguiendo estas instrucciones:
-
URL: La URL corresponde a la URL de la instancia de Salesforce desde la que desea extraer datos. Por lo general, tiene este formato: https://<company-domain>.salesforce.com; https://<company-domain>.my.salesforce.com
- Username: El nombre de usuario de una cuenta autorizada para acceder tanto a los artículos como a la API de Salesforce. Puede encontrar más información sobre cómo hacerlo en la sección "Creación de un perfil de usuario autorizado".
-
Token de seguridad:
- Introduzca una combinación de la contraseña del usuario y su token de seguridad con el formato <password><security token> (por ejemplo, si la contraseña es "abc" y el token de seguridad es "123", introduzca "abc123" en el campo).
- El token de seguridad es necesario para acceder a la API de Salesforce. Para conseguir un token de seguridad de Salesforce, si aún no tiene uno guardado, siga estos pasos:
- Vaya a Settings.
- En "My Personal Information", seleccione Reset My Security Token y haga clic en Reset Security Token. Debería recibir el token por correo electrónico.
- Login URL: Esta es la URL de Salesforce que se usa para conseguir el token de inicio de sesión. Es https://login.salesforce.com/ en las instancias de producción y https://test.salesforce.com en las instancias de prueba.
- Client ID: Esto corresponde a la clave de consumidor de la Connected App de Salesforce. Puede encontrar más información en la sección "Creación de una Connected App".
- Client Secret: Aquí tiene que introducir el secreto de consumidor de la Connected App de Salesforce. Puede encontrar más información en la sección "Creación de una Connected App".
- Grant Type: Este es el tipo de autorización que se usa para conseguir los Access Tokens. Actualmente, el único valor permitido es "password".