Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Conéctese a servicios de terceros
**Topics**
+ [Conector OpenAPI frente a conector API](#add-connector-third-party-openapi-vs-api)
+ [Conéctese a servicios de terceros y APIs (genérico)](connectors-api.md)
+ [Conéctese a los servicios con OpenAPI](connectors-openapi.md)
+ [Conéctese a Salesforce](connectors-salesforce.md)
## Conector OpenAPI frente a conector API
Para enviar solicitudes de API a servicios de terceros desde aplicaciones de App Studio, debes crear y configurar un conector que la aplicación utilice para autenticarse en el servicio y configurar las llamadas a la API. App Studio proporciona los tipos de `OpenAPI Connector` conector `API Connector` y los tipos de conectores necesarios, que se describen a continuación:
+ **Conector de API:** se utiliza para configurar la autenticación y solicitar información para cualquier tipo de API REST.
+ **Conector OpenAPI:** se utiliza para configurar la autenticación y solicitar información para aquellos APIs que han adoptado la Especificación OpenAPI (OAS). APIs Los que cumplen con la OEA ofrecen varios beneficios, como la estandarización, la seguridad, la gobernanza y la documentación.
App Studio recomienda usar el `OpenAPI Connector` para cualquiera APIs que cumpla con la OEA y proporcionar un archivo de especificaciones de OpenAPI. Para obtener más información sobre OpenAPI, consulte [¿Qué es OpenAPI](https://swagger.io/docs/specification/v3_0/about/)? en la documentación de Swagger.
# Conéctese a servicios de terceros y APIs (genérico)
Usa el siguiente procedimiento para crear un **conector de API** genérico en App Studio. El **conector de API** se utiliza para proporcionar a las aplicaciones de App Studio acceso a servicios, recursos u operaciones de terceros.
**Para conectarse a servicios de terceros con el **conector de API****
1. En el panel de navegación de la izquierda, selecciona **los conectores** en la sección **Administrar**. Se abrirá una página que muestra una lista de los conectores existentes con algunos detalles sobre cada uno.
1. Seleccione **\$1 Crear conector**.
1. Elija **API Connector**. Ahora, configure su conector rellenando los siguientes campos.
1. **Nombre del conector:** proporcione un nombre para el conector.
1. **Descripción del conector:** proporcione una descripción del conector.
1. **URL base:** el sitio web o el host de la conexión de terceros. Por ejemplo, `www.slack.com`.
1. **Método de autenticación:** elija el método de autenticación con el servicio de destino.
+ **Ninguno:** acceda al servicio de destino sin autenticación.
+ **Básico:** acceda al servicio de destino con un **nombre de usuario** y una **contraseña** obtenidos del servicio al que se está conectando.
+ **Token de portador:** acceda al servicio de destino utilizando el **valor de token** de un token de autenticación obtenido de la cuenta de usuario o de la configuración de la API del servicio.
+ **OAuth 2.0:** accede al servicio de destino mediante el protocolo OAuth 2.0, que permite a App Studio acceder al servicio y a los recursos sin compartir ninguna credencial o identidad. Para usar el método de autenticación OAuth 2.0, primero debes crear una aplicación desde el servicio al que estás conectado que represente a App Studio para obtener la información necesaria. Con esa información, rellena los siguientes campos:
1. **Flujo de credenciales del cliente:** ideal para system-to-system interacciones en las que la aplicación actúa por sí misma sin la interacción del usuario. Por ejemplo, una aplicación de CRM que actualiza los registros de Salesforce automáticamente en función de los nuevos registros agregados por los usuarios, o una aplicación que recupera y muestra los datos de las transacciones en los informes.
1. En **ID de cliente**, introduzca el ID obtenido de la OAuth aplicación creada en el servicio de destino.
1. En **Secreto de cliente**, introduzca el secreto obtenido de la OAuth aplicación creada en el servicio de destino.
1. En **URL del token de acceso**, introduzca la URL del token obtenida de la OAuth aplicación creada en el servicio de destino.
1. Si lo desea, en **Ámbitos**, introduzca los ámbitos de la aplicación. Los ámbitos son los permisos o niveles de acceso que requiere la aplicación. Consulta la documentación de la API del servicio de destino para entender sus ámbitos y configurar solo aquellos que tu aplicación de App Studio necesite.
Selecciona **Verificar la conexión** para probar la autenticación y la conexión.
1. **Flujo de códigos de autorización:** ideal para aplicaciones que requieren actuar en nombre de un usuario. Por ejemplo, una aplicación de atención al cliente en la que los usuarios inician sesión y ven y actualizan los tickets de asistencia, o una aplicación de ventas en la que cada miembro del equipo inicia sesión para ver y gestionar sus datos de ventas.
1. En el **ID de cliente**, introduce el ID obtenido de la OAuth aplicación creada en el servicio de destino.
1. En **Secreto de cliente**, introduzca el secreto obtenido de la OAuth aplicación creada en el servicio de destino.
1. En **URL de autorización**, introduzca la URL de autorización del servicio de destino.
1. En la **URL del token de acceso**, introduzca la URL del token obtenida de la OAuth aplicación creada en el servicio de destino.
1. Si lo desea, en **Ámbitos**, introduzca los ámbitos de la aplicación. Los ámbitos son los permisos o niveles de acceso que requiere la aplicación. Consulta la documentación de la API del servicio de destino para entender sus ámbitos y configurar solo aquellos que tu aplicación de App Studio necesite.
1. **Encabezados:** agrega encabezados HTTP que se utilizan para proporcionar metadatos sobre la solicitud o la respuesta. Puede agregar claves y valores, o solo proporcionar una clave a la que el generador pueda proporcionar un valor en la aplicación.
1. **Parámetros de consulta:** añada parámetros de consulta que se utilizan para transferir opciones, filtros o datos como parte de la URL de la solicitud. Al igual que los encabezados, puedes proporcionar tanto una clave como un valor, o solo puedes proporcionar una clave a la que el generador pueda proporcionar un valor en la aplicación.
1. Seleccione **Crear**. El conector recién creado aparecerá en la lista de **conectores**.
Ahora que se ha creado el conector, los desarrolladores pueden usarlo en sus aplicaciones.
# Conéctese a los servicios con OpenAPI
Para conectar App Studio con los servicios mediante OpenAPI para que los desarrolladores puedan crear aplicaciones que envíen solicitudes y reciban respuestas de los servicios, lleve a cabo los siguientes pasos:
1. [Obtenga el archivo de especificaciones de OpenAPI y recopile la información del servicio](#connectors-openapi-create-resources)
1. [Crear un conector OpenAPI](#connectors-openapi-create-connector)
## Obtenga el archivo de especificaciones de OpenAPI y recopile la información del servicio
Para conectar un servicio a App Studio con OpenAPI, lleve a cabo los siguientes pasos:
1. Ve al servicio que deseas conectar a App Studio y busca un archivo JSON de especificación OpenAPI.
**nota**
App Studio admite archivos de especificación de OpenAPI que se ajusten a la versión 3.0.0 o superior de la Especificación de OpenAPI.
1. Recopile los datos necesarios para configurar el conector OpenAPI, incluidos los siguientes:
+ La URL base para conectarse al servicio.
+ Credenciales de autenticación, como un token o un nombre de usuario o contraseña.
+ Si corresponde, cualquier encabezado.
+ Si corresponde, cualquier parámetro de consulta.
## Crear un conector OpenAPI
**Para crear un conector para OpenAPI**
1. Ve a App Studio.
1. En el panel de navegación de la izquierda, selecciona **Connectors** en la sección **Administrar**. Se abrirá una página que muestra una lista de los conectores existentes con algunos detalles sobre cada uno.
1. Seleccione **\$1 Crear conector**.
1. Elija el **conector OpenAPI** de la lista de tipos de conectores. Ahora, configure su conector rellenando los siguientes campos.
1. **Nombre:** introduzca un nombre para el conector de OpenAPI.
1. **Descripción:** introduzca una descripción para su conector OpenAPI.
1. **URL base:** introduzca la URL base para conectarse al servicio.
1. **Método de autenticación:** elija el método de autenticación con el servicio de destino.
+ **Ninguno:** acceda al servicio de destino sin autenticación.
+ **Básico:** acceda al servicio de destino con un **nombre de usuario** y una **contraseña** obtenidos del servicio al que se está conectando.
+ **Token de portador:** acceda al servicio de destino utilizando el **valor de token** de un token de autenticación obtenido de la cuenta de usuario o de la configuración de la API del servicio.
+ **OAuth 2.0:** accede al servicio de destino mediante el protocolo OAuth 2.0, que permite a App Studio acceder al servicio y a los recursos sin compartir ninguna credencial o identidad. Para usar el método de autenticación OAuth 2.0, primero debes crear una aplicación desde el servicio al que estás conectado que represente a App Studio para obtener la información necesaria. Con esa información, rellena los siguientes campos:
1. **Flujo de credenciales de cliente:**
1. En el **ID de cliente**, introduzca el ID del servicio de destino.
1. En **Secreto de cliente**, introduzca el secreto del servicio de destino.
1. En la **URL del token de acceso**, introduzca la URL del token del servicio de destino.
1. Si lo desea, en **Ámbitos**, introduzca los ámbitos de la aplicación. Los ámbitos son los permisos o niveles de acceso que requiere la aplicación. Consulta la documentación de la API del servicio de destino para entender sus ámbitos y configurar solo aquellos que tu aplicación de App Studio necesite.
Agrega **las variables** que quieras enviar con el servicio en cada llamada y selecciona **Verificar conexión** para probar la autenticación y la conexión.
1. **Flujo de códigos de autorización:**
1. En **ID de cliente**, introduzca el ID del servicio de destino.
1. En **Secreto de cliente**, introduzca el secreto del servicio de destino.
1. En **URL de autorización**, introduzca la URL de autorización del servicio de destino.
1. En **URL del token de acceso**, introduzca la URL del token del servicio de destino.
1. Si lo desea, en **Ámbitos**, introduzca los ámbitos de la aplicación. Los ámbitos son los permisos o niveles de acceso que requiere la aplicación. Consulta la documentación de la API del servicio de destino para entender sus ámbitos y configurar solo aquellos que tu aplicación de App Studio necesite.
1. **Variables:** agrega variables para enviarlas al servicio con cada llamada. Las variables agregadas durante la configuración se almacenan de forma segura y solo se accede a ellas durante el tiempo de ejecución de las aplicaciones que utilizan la conexión.
1. **Encabezados:** agregue encabezados HTTP que se utilizan para proporcionar metadatos sobre la solicitud o la respuesta. Puede agregar claves y valores, o solo proporcionar una clave a la que el generador pueda proporcionar un valor en la aplicación.
1. **Parámetros de consulta:** añada parámetros de consulta que se utilizan para transferir opciones, filtros o datos como parte de la URL de la solicitud. Al igual que los encabezados, puedes proporcionar tanto una clave como un valor, o solo puedes proporcionar una clave a la que el generador pueda proporcionar un valor en la aplicación.
1. Archivo de **especificaciones de OpenAPI: cargue un archivo** JSON de especificación OpenAPI arrastrándolo y soltándolo, o seleccionando **Seleccionar un archivo** para navegar por su sistema de archivos local y elegir el archivo que desea cargar.
Una vez agregado, el archivo se procesa y se muestra una lista de las opciones disponibles. Seleccione las operaciones necesarias para el conector.
1. Seleccione **Crear**. El conector recién creado aparecerá en la lista de **conectores**.
Ahora que se ha creado el conector, los desarrolladores pueden usarlo en sus aplicaciones.
# Conéctese a Salesforce
Para conectar App Studio con Salesforce y permitir a los desarrolladores acceder a los recursos de Salesforce y usarlos en las aplicaciones, debe crear y configurar una aplicación conectada en Salesforce y crear un conector de Salesforce en App Studio.
**Para conectar Salesforce con App Studio**
1. En App Studio, en el panel de navegación, selecciona **Connectors** en la sección **Administrar**. Se abrirá una página que muestra una lista de los conectores existentes con algunos detalles sobre cada uno.
1. Seleccione **\$1 Crear conector**.
1. Elija **Salesforce** de la lista de tipos de conectores para abrir la página de creación de conectores.
1. Tome nota de la **URL de redireccionamiento**, que utilizará para configurar Salesforce en los siguientes pasos.
1. El siguiente paso es crear una aplicación conectada en Salesforce. En otra pestaña o ventana, navegue hasta su instancia de Salesforce.
1. En el cuadro Búsqueda rápida, busque **App Manager** y, a continuación, seleccione **App Manager**.
1. Selecciona **Nueva aplicación conectada**.
1. En Nombre de **la aplicación conectada y Nombre** **de la API**, introduce un nombre para la aplicación. No tiene que coincidir con el nombre de la aplicación de App Studio.
1. Proporciona la información de contacto según sea necesario.
1. En la sección **API (Habilitar OAuth configuración)**, habilita **Habilitar OAuth configuración**.
1. En **Callback URL**, introduce la **URL de redireccionamiento** que indicaste anteriormente en App Studio.
1. En ** OAuth Ámbitos seleccionados, agrega los ámbitos** de permisos necesarios de la lista. App Studio puede interactuar con Salesforce REST APIs para realizar operaciones CRUD en cinco objetos: cuentas, casos, contactos, clientes potenciales y oportunidades. Se recomienda añadir el **acceso total (completo)** para garantizar que la aplicación de App Studio tenga todos los permisos o ámbitos pertinentes.
1. Desactiva la opción **Solicitar clave de prueba para el intercambio de códigos (PKCE) para los flujos de autorización compatibles**. App Studio no admite PKCE.
1. Activa **Require Secret para Web Server Flow** y **Require Secret for Refresh Token Flow** para seguir las mejores prácticas de seguridad.
1. App Studio admite los dos flujos de autenticación siguientes:
+ **Flujo de credenciales de cliente**: ideal para server-to-server interacciones en las que la aplicación actúa por sí misma sin la interacción del usuario. Por ejemplo, incluir toda la información sobre los clientes potenciales de un equipo de empleados temporales que no tienen acceso a Salesforce.
+ **Flujo de códigos de autorización**: adecuado para aplicaciones que actúan en nombre de un usuario, como el acceso a datos personales o las acciones que realizan. Por ejemplo, enumerar los clientes potenciales de cada gerente de ventas que hayan obtenido o sean de su propiedad para realizar otras tareas a través de esta aplicación.
+ Para el flujo de credenciales de los clientes:
1. **Habilite la activación del flujo de credenciales de cliente**. Revise y confirme el mensaje.
1. Guarda la aplicación.
1. Debe seleccionar un usuario de ejecución, aunque no haya ninguna interacción del usuario en el flujo. Al seleccionar un usuario de ejecución, Salesforce devuelve los tokens de acceso en nombre del usuario.
1. En el **Administrador de aplicaciones**, en la lista de aplicaciones, elija la flecha de la aplicación App Studio y elija **Administrar**.
1. Selecciona **Editar políticas**
1. En el **flujo de credenciales del cliente**, agregue el usuario correspondiente.
+ Para el flujo de códigos de autorización, habilite **Habilitar el flujo de códigos de autorización y credenciales**
1. Salesforce proporciona un ID de cliente y un secreto de cliente, que se deben usar para configurar el conector en App Studio en los siguientes pasos.
1. En el **Gestor de aplicaciones**, selecciona la flecha de la aplicación App Studio y selecciona **Ver**.
1. En la sección **API (Habilitar OAuth la configuración)**, selecciona **Administrar los detalles del consumidor**. Esto puede enviar un correo electrónico con una clave de verificación, que tendrás que introducir para confirmarla.
1. Anote la **clave del consumidor** (ID de cliente) y el **secreto del consumidor** (secreto del cliente).
1. De vuelta en App Studio, configura y crea tu conector rellenando los siguientes campos.
1. En **Nombre**, introduce un nombre para tu conector de Salesforce.
1. En **Descripción**, introduzca una descripción para su conector de Salesforce.
1. En **URL base**, introduzca la URL base de su instancia de Salesforce. Debería tener este aspecto:`https://hostname.salesforce.com/services/data/v60.0`, sustituyéndolo por el nombre *hostname* de su instancia de Salesforce.
1. En **Método de autenticación**, asegúrese de que esté seleccionada la **OAuth versión 2.0**.
1. En **OAuth 2.0 Flow**, seleccione el método de OAuth autenticación y complete los campos relacionados:
+ Seleccione el **flujo de credenciales del cliente** para usarlo en aplicaciones que actúan en su propio nombre, para system-to-system las integraciones.
1. En el **ID de cliente**, introduzca la **clave de consumidor** obtenida previamente de Salesforce.
1. En **Secreto de cliente**, introduzca el **secreto del consumidor**, obtenido previamente de Salesforce.
1. En la **URL del token de acceso**, introduzca el punto final del token OAuth 2.0. Debería tener este aspecto:`https://hostname/services/oauth2/token`, sustituyéndolo por el nombre *hostname* de su instancia de Salesforce. Para obtener más información, consulte la documentación de [Salesforce OAuth Endpoints](https://help.salesforce.com/s/articleView?id=sf.remoteaccess_oauth_endpoints.htm&type=5).
1. Elija **Verificar la conexión** para probar la autenticación y la conexión.
+ Seleccione el **flujo de códigos de autorización** para usarlo en aplicaciones que actúen en nombre del usuario.
1. En el **ID de cliente**, introduzca la **clave de consumidor** obtenida previamente de Salesforce.
1. En **Secreto de cliente**, introduzca el **secreto del consumidor**, obtenido previamente de Salesforce.
1. En la **URL de autorización**, introduzca el punto final de autorización. Debería tener este aspecto:`https://hostname/services/oauth2/authorize`, sustituyéndolo por el nombre *hostname* de su instancia de Salesforce. Para obtener más información, consulte la documentación de [Salesforce OAuth Endpoints](https://help.salesforce.com/s/articleView?id=sf.remoteaccess_oauth_endpoints.htm&type=5).
1. En la **URL del token de acceso**, introduzca el punto final del token OAuth 2.0. Debería tener este aspecto:`https://hostname/services/oauth2/token`, sustituyéndolo por el nombre *hostname* de su instancia de Salesforce. Para obtener más información, consulte la documentación de [Salesforce OAuth Endpoints](https://help.salesforce.com/s/articleView?id=sf.remoteaccess_oauth_endpoints.htm&type=5).
1. En **Operaciones**, seleccione las operaciones de Salesforce que admitirá su conector. Las operaciones de esta lista están predefinidas y representan tareas comunes en Salesforce, como crear, recuperar, actualizar o eliminar registros de objetos comunes.
1. Seleccione **Crear**. El conector recién creado aparecerá en la lista de **conectores**.