Conéctese a servicios y API de terceros (genéricos)

Para conectarse a servicios de terceros con el Conector API

1. En el panel de navegación de la izquierda, elija los conectores en la sección Administrar. Accederá a una página en la que se muestra una lista de los conectores existentes con algunos detalles sobre cada uno de ellos.

2. Seleccione + Crear conector.

3. Elige API Connector. Ahora, configura tu conector rellenando los siguientes campos.

4. Nombre del conector: proporcione un nombre para el conector.

5. Descripción del conector: proporcione una descripción para el conector.

6. URL base: el sitio web o el host de la conexión de terceros. Por ejemplo, www.slack.com.

7. Método de autenticación: elija el método para autenticarse 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 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 otorga a App Studio acceso 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 a partir del servicio al que te estás conectando 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: ideal para interacciones de sistema a sistema en las que la aplicación actúa en su propio nombre sin la interacción del usuario. Por ejemplo, una aplicación de CRM que actualiza automáticamente los registros de Salesforce 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 aplicación OAuth creada en el servicio de destino.

        2. En Secreto del cliente, introduce el secreto obtenido de la aplicación de OAuth creada en el servicio de destino.

        3. En URL del token de acceso, introduce la URL del token obtenida de la aplicación de OAuth creada en el servicio de destino.

        4. 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 conocer sus alcances y configurar solo aquellos que tu aplicación de App Studio necesite.

        Elige Verificar la conexión para probar la autenticación y la conexión.

     2. Flujo de código 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 soporte, o una aplicación de ventas en la que cada miembro del equipo inicia sesión para ver y administrar sus datos de ventas.

        1. En ID de cliente, introduce el ID obtenido de la aplicación OAuth creada en el servicio de destino.

        2. En Secreto del cliente, introduce el secreto obtenido de la aplicación de OAuth creada en el servicio de destino.

        3. En URL de autorización, introduce la URL de autorización del servicio de destino.

        4. En URL del token de acceso, introduce la URL del token obtenida de la aplicación OAuth creada en el servicio de destino.

        5. 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 conocer sus alcances y configurar solo aquellos que tu aplicación de App Studio necesite.

8. Encabezados: agrega encabezados HTTP que se utilizan para proporcionar metadatos sobre la solicitud o la respuesta. Puedes agregar tanto claves como valores, o solo proporcionar una clave a la que el generador pueda proporcionar un valor en la aplicación.

9. Parámetros de consulta: añada parámetros de consulta que se utilizan para pasar 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 una clave a la que el creador pueda proporcionar un valor en la aplicación.

10. Seleccione Crear. El conector recién creado aparecerá en la lista de conectores.