Primeros pasos con Servicios externos
Objetivos de aprendizaje
Después de completar esta unidad, podrá:
- Explicar la función Servicios externos y los servicios externos.
- Describir el flujo de trabajo de alto nivel de un servicio externo.
¿Por qué utilizar Servicios externos?
Visualice el vídeo de introducción para ver cómo puede transformar de forma declarativa especificaciones de API en acciones invocables.
En el mundo actual, los clientes esperan una experiencia del cliente sin problemas, sin importar si esa experiencia está compuesta de soluciones empresariales en segundo plano y servicios que residen en una sola plataforma o en hosts de diversas plataformas. Es en esta interacción entre Salesforce y servicios externos donde Servicios externos destaca.
Servicios externos facilita este intercambio permitiéndole integrar de forma declarativa (sin código) con servicios alojados de forma externa que realizan acciones empresariales o cálculos para su uso en su organización de Salesforce. Entonces, ¿qué tipo de servicios externos valiosos se pueden integrar en una organización de Salesforce? A continuación se muestran algunos ejemplos:
- Función de servicio de calificación de crédito para su página de detalles Cuenta de Salesforce
- Un servicio de verificación de idoneidad para descuentos
- Servicios de pago digital flexibles
- Servicios de asignación con herramientas de visualización
- Notificaciones de pedidos en tiempo real en Slack
- Identificación: servicio de prevención de fraudes
- Integración de servicios de distribución minorista de OmniCanal separados
- Servicios de Google
- Servicios de instituciones internacionales y gubernamentales
- Índice de calidad del aire (AirNow)
- Servicios al ciudadano
- Centros para el Control y la Prevención de Enfermedades (CDC)
- El banco mundial
Vamos a ver con detalle en qué consiste Servicios externos y cómo funciona. Pero primero, vamos a ver unos cuantos ejemplos que muestran el flujo de trabajo y resaltan cómo Servicios externos está cambiando el panorama de integración para todos los tipos de servicios web.
Convierta a sus nuevos usuarios de la organización de Salesforce en colaboradores automáticos para las aplicaciones externas relacionadas con la organización. Supongamos que desea que los usuarios tengan acceso a una aplicación de información de nóminas externa de modo que puedan buscar datos de sus propias hojas de horas y pagos. Registra su servicio externo (la aplicación de nóminas), y Servicios externos convierte el servicio en acciones para utilizar con Flow Builder. A continuación, crea un flujo con desencadenadores que actúan en la entrada (por ejemplo, Id. de usuario) desde su aplicación de nóminas. Ahora, cada vez que crea un nuevo usuario en Salesforce, se desencadena un flujo iniciado automáticamente que agrega el usuario como un colaborador con acceso al servicio de aplicación de nóminas fuera de Salesforce que contiene su salario y hoja de horarios.
Acceda a servicios de Salesforce fuera para realizar una tarea. Supongamos que desea conectarse con un servicio de crédito que determine si se puede ampliar un crédito para un registro de cuenta almacenado en su organización de Salesforce. Así es como funciona: Registra su servicio externo (el servicio de validación de crédito). Servicios externos convierte el servicio en acciones en acciones invocables (ver definición) para utilizar con una herramienta de plataforma como Flow Builder. Luego, utiliza Flow Builder para crear un flujo que incluye las acciones de este servicio externo en entradas como importe de pedido y condiciones de crédito. Cuando el flujo se ejecuta, actualiza los plazos del crédito para el pedido asociado con la cuenta.
Una vez que conoce los fundamentos, podrá utilizar el flujo de trabajo de Servicios externos para aprovechar los servicios fuera de Salesforce que mejor se ajusten a su modelo empresarial, caso de uso y, lo más importante, sus clientes.
A qué nos referimos cuando hablamos de Servicios externos
¿Conoce su servicio web externo de su instancia de Servicios externos? Comencemos con algunas definiciones.
Servicios externos: producto de integración de Salesforce que abarca (1) registrar un servicio web externo que usted envía como una especificación que cumple con OpenAPI y define el servicio web e (2) integrar, casi por arte de magia, las operaciones de su servicio web externo en la plataforma de Salesforce (ver acciones invocables) para utilizarlas con herramientas interactivas, como Flow Builder. En pocas palabras, conecta de forma declarativa las API de REST externas utilizando estándares de OpenAPI.
Servicio web externo: también conocido como servicios externos (minúsculas). Cualquier tipo de función, acción o proceso desarrollado y alojado fuera de la plataforma de Salesforce. Para que un servicio web externo sea consumible por Servicios externos, debe ser una API basada en REST que utilice habitualmente el protocolo HTTPS para navegar en la web (si no sabe qué es REST, no hay ningún problema).
Especificación de la API: es un archivo que contiene el esquema descriptivo que define lo que una API puede hacer. Servicios externos cumple con un formato de especificación OpenAPI basado en JSON. Una especificación de la API es legible tanto para el ser humano como para las máquinas. Define los fundamentos para la nomenclatura, el orden y los contenidos de objetos, y garantiza interacciones claras con una API de REST. Consulte Especificación de OpenAPI.
Acciones invocables (en el contexto de Servicios externos): representan los componentes fundamentales declarativos disponibles en un número creciente de herramientas de la plataforma Salesforce, como Flow Builder o Bots de Einstein. Las acciones invocables asisten a administradores y desarrolladores proporcionando una forma de implementar y utilizar cualquier tipo de acción de una forma coherente. En el ecosistema de Servicios externos, una vez que registre las operaciones de su servicio web externo con Servicios externos, podrá acceder a las acciones invocables resultantes, por ejemplo, desde la herramienta Flow Builder.
Flow Builder: una herramienta interactiva para la creación de flujos.
Flujo: un flujo es la parte de Salesforce Flow que recopila datos y realiza acciones en su organización de Salesforce o en un sistema externo. Salesforce Flow incluye flujos (creados con Flow Builder) y procesos (creados con el Generador de procesos).
Si bien estos términos (especificación OpenAPI, especificación de la API y esquema) están dirigidos a desarrolladores, Servicios externos ayuda a acortar la distancia entre la codificación de servicios web y la automatización para acceder a ellos.
Perspectiva global
Es tiempo de dar un paso atrás y echar un vistazo a la imagen completa para comprender las partes integrantes interconectadas de Servicios externos. Observe que gran parte del trabajo de registro de un servicio web externo propio se realiza de forma declarativa mediante la página de registro de Servicios externos. Una vez registrado, puede utilizar herramientas como Flow Builder para crear un flujo con las acciones invocables de su servicio web.
Esta es una descripción general de lo que está sucediendo. Observe que aunque existen seis pasos, los que son clave para Servicios externos son los pasos 3, 4 y 5.
- Un proveedor de servicios web externos, como un banco, aloja su API basada en REST. En este escenario, piense en una API basada en REST al especificar un tipo de contrato entre el banco (proveedor) y usted (consumidor).
- El proveedor del servicio web (como en nuestro ejemplo del servicio web de un banco) o un desarrollador (o incluso usted) comparten una especificación de la API basada en JSON que describe la API.
- Un administrador de Salesforce o un desarrollador crean de forma declarativa una credencial con nombre para autenticar el extremo del servicio web mediante el uso de la URL de la API basada en REST proporcionada por el proveedor del servicio web externo. El extremo es simplemente lo que expone los recursos de servicios para la interacción con Servicios externos.
- Un administrador de Salesforce registra de forma declarativa el servicio web y utiliza tanto la credencial con nombre como la especificación de la API durante el proceso de registro. Servicios externos importa las operaciones de la especificación de la API en su organización y hace que estén disponibles como acciones invocables.
- Un administrador de Salesforce utiliza Flow Builder para acceder a las acciones de flujo invocables que se registraron en el paso 4.
- Durante el tiempo de ejecución, el flujo envía una llamada al extremo del servicio web. El servicio web muestra un resultado según la especificación de la API. Los datos se recuperan, se crean, se actualizan o se eliminan en el servicio web externo. Salesforce puede capturar estas respuestas desde el servicio web externo para su uso con una herramienta como Flow Builder.
Si quien produjo la API no ha compartido la especificación con usted, la creación de una especificación de la API como se describe en el paso 2 no es un proceso declarativo. Puede crear la especificación de la API por su cuenta (dependiendo de su experiencia), recurrir a su desarrollador o utilizar una herramienta de generación de esquemas como el editor de Swagger para hacerlo.
En la siguiente unidad, examinaremos los detalles (más precisamente, las entradas y salidas) de una especificación de la API y explicaremos en qué consiste. Una vez que cuente con su especificación de la API, puede utilizar las herramientas declarativas que ya se encuentran en Salesforce para agregar las acciones empresariales que necesita en su organización.