Loading
Automatizar sus procesos comerciales con Salesforce Flow
Configurar una acción de llamada HTTP

Usted está aquí:

  1. Ayuda de Salesforce
  2. Documentos
  3. Automatizar sus procesos comerciales

Configurar una acción de llamada HTTP

Llamada HTTP le guía por la introducción de los detalles acerca del servicio basado en web HTTP o extremo de API de REST al que se está conectando. Tras completar la configuración, invoca la acción en un flujo. Llamada HTTP asume que está familiarizado con la API a la que desea llamar.

Ediciones necesarias

Disponible en: Lightning Experience
Ver ediciones compatibles.
Permisos de usuario necesarios
Para abrir, modificar, crear, activar o desactivar un flujo utilizando todos los tipos de flujo, elementos y funciones disponibles en Flow Builder, incluyendo Einstein y Agentforce for Flow: Gestionar flujo
Para crear una credencial externa, una credencial nombrada y una acción de llamada HTTP: Personalizar aplicaciones

Antes de configurar una acción de llamada HTTP:

  • Cree una credencial externa y una credencial nombrada de modo que el servicio externo pueda conectarse a la API. Consulte Directrices para autenticar acciones de llamadas HTTP.
  • Prepare una respuesta de API de muestra en formato JSON. Si una muestra no existe en la documentación de la API, puede utilizar una plataforma de API externa para recuperar una respuesta.
  • Comience con una API bien documentada. Si los detalles como los requisitos de campo o las definiciones son imprecisos o desfasados, puede tardar tiempo en depurarse.
  1. Abra la vista de lista Flujos.
    • En Configuración, en el cuadro Búsqueda rápida, introduzca Flujos y luego seleccione Flujos.
    • Desde la aplicación Automatización, seleccione la ficha Flujos.
    • Desde la ficha Flujos en cualquier aplicación Lightning, haga clic en el menú de acciones y seleccione Abrir flujo.
  2. Abra un flujo existente en el que desee utilizar la llamada o cree uno nuevo.
  3. Agregue un elemento Acción al flujo y haga clic en Crear llamada HTTP.
  4. Configure el servicio externo que conecta Salesforce con la API basada en HTTP.
    1. Introduzca un nombre para el servicio externo, como ConnectToMaps. El nombre debe comenzar por una letra y utilizar solo caracteres alfanuméricos y guiones bajos.
    2. Para referencia, introduzca una descripción de a qué se está conectando el servicio externo.
    3. Seleccione la credencial nombrada que creó para este servicio externo.
      La URL asociada con la credencial se rellena automáticamente.
    4. Haga clic en Siguiente.
  5. Configure la acción invocable que puede utilizar en Flow Builder o en Salesforce.
    1. Para Etiqueta, introduzca la acción que realiza la llamada, por ejemplo, Conectar con mapas.
    2. Seleccione la operación o el método requeridos por la API a la que está llamando.
      Generalmente, GET aporta datos externos. El resto de los métodos modifican los datos en un sistema externo. La función depende del API.
    3. Introduzca una descripción de la API que realiza la operación, e incluya un vínculo al documento de la API de modo que pueda hacer referencia a él si cambia la llamada.
  6. Agregue el extremo de URL para la solicitud.
    La URL base muestra la URL de credencial nombrada para el servicio externo. Si no puede ver la URL completa, haga clic en el campo.
    1. Introduzca la ruta de URL para el extremo que comienza por una barra diagonal (/) y no contiene un signo de interrogación (?).
      Los caracteres compatibles para una ruta de URL incluyen caracteres alfanuméricos, guiones bajos, barra y corchetes.
    2. Si tiene variables de ruta, colóquelas entre paréntesis y seleccione el tipo de datos de la variable. Las variables de ruta solo pueden contener caracteres alfanuméricos y guiones bajos.
    3. Introduzca la descripción de la variable, incluyendo los detalles de uso.
  7. Agregue claves de parámetros de consulta si la API que está llamando las tiene. Cuando utiliza esta acción en un flujo, introduce valores para las claves definidas.
    1. Haga clic en + Agregar clave.
    2. Introduzca el valor clave y seleccione el tipo de datos.
    3. Para requerir un valor cuando se invoca la acción en un flujo, seleccione Obligatorio.
    4. Introduzca la descripción de la clave del parámetro de consulta, incluyendo los detalles de uso.
  8. Para POST, PUT, PATCH y DELETE, proporcione un cuerpo de solicitud de API de ejemplo. Salesforce genera una estructura de datos desde la solicitud de muestra.
    1. Haga clic en Nuevo.
    2. Pegue una solicitud JSON de muestra.
    3. Haga clic en Revisar y confirme que la estructura de datos de Apex es correcta.
    4. Para realizar cambios, modifique el texto en Solicitud JSON de muestra o seleccione tipos de datos desde la estructura de datos.
    5. Haga clic en Revisar.
    6. Haga clic en Listo.
  9. Proporcione un cuerpo de respuesta de API de ejemplo. Salesforce genera una estructura de datos desde la respuesta de muestra.
    1. Haga clic en Nuevo.
    2. Pegue una respuesta JSON de muestra.
    3. Haga clic en Revisar y confirme que la estructura de datos de Apex es correcta.
    4. Para realizar cambios, modifique el texto en Respuesta JSON de muestra o seleccione tipos de datos desde la estructura de datos.
    5. Haga clic en Revisar.
    6. Haga clic en Listo.
  10. Haga clic en Guardar.
    Flow Builder crea la acción y el servicio externo. La acción está disponible en la ventana Acciones en el flujo.
  11. Para POST, PUT, PATCH y DELETE, establezca el cuerpo para el flujo creando un recurso y seleccionando la clase Apex para el cuerpo del servidor externo.
    1. Para el cuerpo, seleccione Nuevo recurso.
    2. Introduzca un nombre de API para el nuevo recurso.
    3. Introduzca una descripción que describa la variable y cómo se utiliza.
      El tipo de datos y la clase de Apex se establecen para usted. La clase de Apex para la acción de llamada HTTP utiliza esta convención de nomenclatura: NombreServicioExterno__Etiqueta de llamada HTTP_IN_body. Por ejemplo, si el nombre del servicio externo es MyCustomES y la etiqueta para la nueva llamada HTTP es Obtener cuentas, la clase de Apex es MyCustomES_Getx20Accounts_IN_body, donde x20 representa un espacio en la etiqueta.
    4. Haga clic en Listo.
    5. Para el cuerpo, seleccione la variable definida por Apex que creó.
    6. Haga clic en Listo.

Para transformar los datos entre Salesforce y el sistema externo en el flujo, utilice el elemento Transformación. Para los métodos POST, PUT, PATCH y DELETE, a continuación agrega un elemento Asignación antes de la acción de llamada HTTP. En el elemento Asignación, asigne valores para cada uno de los campos en la variable definida por Apex. La acción de llamada HTTP hace referencia a la variable definida por Apex como la entrada para crear los datos en el servidor externo.

Flow Builder crea clases Apex automáticamente desde las estructuras de datos inferidas para almacenar datos transferidos entre Salesforce y el servidor externo. La convención de nomenclatura de clase de Apex para acciones de llamada HTTP que utilizan el método GET es NombreServicioExterno__Etiqueta de llamada HTTP_OUT_2XX. Por ejemplo, si el nombre del servicio externo es MyCustomES y la etiqueta para la nueva llamada HTTP es Obtener cuentas, la clase de Apex es MyCustomES_Getx20Accounts_OUT_2XX. Para eliminar una clase Apex, elimine el servicio externo asociado con la clase Apex. Para obtener más información, consulte Eliminar un servicio externo.

Consulte también:

 
Cargando
Salesforce Help | Article