Recuperar elementos de sus aplicaciones

Considere este ejemplo en el que puede utilizar una acción de recuperación en un flujo para recuperar un único registro. Imagina que organizas un evento en Eventbrite. Cuando uno de sus clientes actuales se inscriba en el evento, querrá que su departamento de Ventas se ponga en contacto con él para ofrecerle ofertas personalizadas. Entonces, elige el evento Nuevo asistente para comenzar su flujo. A continuación, añada la acción Salesforce Recuperar contactos. Asigne los campos adecuados para recuperar los datos de contacto y cualquier otra información destacada de Salesforce del cliente inscrito en el evento de Eventbrite. A continuación, puede añadir la acción Crear mensaje de Gmail al flujo para enviar por correo electrónico estos importantes datos a su equipo de ventas.

En algunas circunstancias, es posible que desee recuperar varios registros. Tal vez estés organizando una serie de eventos en Eventbrite. Esta vez, cada vez que se crea un nuevo evento, quiere recuperar los datos de todos sus clientes que viven en las proximidades. Así podrá dirigir su campaña de marketing a las personas adecuadas. Entonces, comienza tu flujo con el activador de nuevo evento de Eventbrite. A continuación, añada la acción Salesforce Recuperar clientes potenciales, que recuperará todos los clientes potenciales cuya dirección coincida con la ciudad del evento. A continuación, puede añadir un nodo For each para procesar todos los registros recuperados mediante la acción Mailchimp Add subscriber to a list. Esta acción añade cada cliente potencial a la lista de correo apropiada para su campaña.

• Un App Connect suscripción.
• Las credenciales de las cuentas a las que desea acceder (si App Connect aún no está conectado a sus cuentas).
  • Puede conectarse a sus cuentas ahora desde la página Aplicaciones y API, o puede conectarse a medida que añade cada aplicación a su flujo.
  • Algunas aplicaciones necesitan información adicional para poder conectarse a App Connect; si necesitas ayuda para encontrar esta información, consulta las guías "Cómo" de las aplicaciones.
• Una aplicación que contiene algunos datos que puedes recuperar.

  Para ver qué aplicaciones admiten acciones de recuperación en App Connect vaya a la página Aplicaciones y API y escriba retrieve en el campo de búsqueda.

Utilizando App Connect Designer, puede crear su flujo desde cero.

Para crear su flujo, siga los siguientes pasos.

1. En el panel de control de App Connect Designer, haga clic en Crear > Flujo controlado por eventos.

   A medida que avanzas, App Connect guarda automáticamente los cambios. Si se aleja del flujo en cualquier fase, éste se guarda como borrador que podrá completar en otro momento.

2. Introduzca un nombre que identifique el propósito de su flujo.
3. Seleccione su primera aplicación (fuente) y, a continuación, el evento que desencadenará las acciones en el resto de su flujo.

   Para algunos eventos desencadenantes, es posible que tenga que proporcionar alguna información, como el nombre de un evento o una lista que espera que se actualice.

4. Haga clic en Añadir nodo (+) y seleccione una aplicación de destino y una acción de recuperación adecuada.
5. Para recuperar registros que cumplan determinados criterios, defina uno o varios filtros.
   • Por ejemplo, para recuperar un único elemento, configure el filtro para que coincida con campos que probablemente sean únicos, como una dirección de correo electrónico.
   • Para filtrar más de un campo, haga clic en Añadir condición y defina otro filtro. Por ejemplo, para recuperar los empleados de una sucursal concreta de una empresa, añada una condición que coincida con el nombre de la empresa y una segunda condición que coincida con la ciudad.
   • Alternativamente, para recuperar todos los artículos de un tipo determinado, elimine la condición.
6. Especifique el número máximo de elementos que desea recuperar y qué ocurre si el flujo encuentra más de ese número.

   Para fijar el límite en el valor máximo permitido, puede hacer clic en el icono .

   Si App Connect encuentra más elementos que el límite máximo especificado, puede salir del flujo en ese punto y emitir un error. O puede seguir procesando el número máximo de elementos encontrados. La aplicación desde la que recuperas elementos decide qué elementos recuperas.

7. Defina qué ocurre si el flujo no encuentra ningún artículo que se ajuste a sus criterios.

   Puede elegir salir del flujo en ese punto y emitir un error, o puede continuar a través del flujo, pero emitir un código de respuesta de204: No content. Puede utilizar ese código de respuesta más adelante en el flujo. Por ejemplo, puede añadir un nodo If al flujo que diga que si una acción anterior en el flujo da como resultado un código de respuesta 204, tome una acción determinada. Tal vez quieras enviar un mensaje a alguien para poner de relieve el problema.

   En el siguiente ejemplo, desea recuperar un cliente potencial de Insightly que tenga la misma dirección de correo electrónico que una persona que se inscribió en un evento en Eventbrite. Las direcciones de correo electrónico son únicas, por lo que se espera recuperar un solo lead. Por lo tanto, establezca el número máximo de elementos a recuperar en 1. El ejemplo también muestra que si se encuentra más de un cliente potencial con la misma dirección de correo electrónico, se detiene el procesamiento y se emite un error. Si no se encuentra ningún cliente potencial con la dirección de correo electrónico, no querrá realizar ninguna otra acción, por lo que querrá salir del flujo y emitir un error.

   

   En el siguiente ejemplo, se espera recuperar más de un elemento. Esta vez, desea recuperar todos los Salesforce clientes potenciales que trabajan para una empresa determinada en una ciudad determinada. Se fija en 20 el número máximo de elementos a recuperar. Si se encuentran más de 20 clientes potenciales para esta empresa y ciudad, deberá procesar los 20 primeros que reciba. Y si no encuentra ningún cliente potencial que cumpla los criterios, debe hacer algo al respecto. Así, puede continuar el flujo con un mensaje apropiado. A continuación, puede añadir un nodo If más adelante en el flujo para gestionar este código de respuesta.

   

8. Ahora, defina cómo procesar los datos recuperados.
   Puede manejar los elementos recuperados de dos maneras.

   • Completar una única acción para su lista de elementos recuperados, como enviar por correo electrónico una lista de clientes potenciales a su departamento de Ventas
   • Completar una acción para cada uno de los elementos recuperados, como crear una fila en una hoja de cálculo para los detalles de cada cliente potencial
   Para completar una única acción para todos los elementos recuperados, añada una acción a su flujo después de la acción de recuperación. Los siguientes pasos describen cómo completar una acción para cada elemento recuperado.

   1. Para procesar cada elemento recuperado, haga clic en el signo más (+) después de la acción de recuperación, seleccione la pestaña Caja de herramientas y, a continuación, añada un nodo Para cada al flujo.
   2. En el cuadro de diálogo "Para cada uno", especifique los elementos que desea procesar haciendo clic en el campo Seleccione la colección de elementos que desea procesar y, a continuación, haga clic en el icono Insertar asignación . Seleccione el objeto adecuado para procesar, como clientes potenciales o contactos.
   3. Edite el nombre para mostrar si lo desea. Este nombre aparece en el nodo "Para cada uno" del flujo.
   4. Defina si desea procesar los registros recuperados secuencialmente o en paralelo.

      Si procesa elementos secuencialmente, se procesan en el orden en que la aplicación los proporciona. El flujo espera hasta que se procesa el primer elemento antes de empezar a procesar el siguiente. Si procesa elementos en paralelo, el flujo empieza a procesarlos en el orden en que se reciben. El flujo no espera a que termine el primer elemento para empezar a procesar el siguiente. Por lo tanto, los artículos podrían terminar de procesarse en momentos diferentes. Si no le importa el orden en que se procesan los registros, el procesamiento paralelo suele ser más rápido. Pero si opta por el procesamiento en paralelo, compruebe que las aplicaciones que se utilizan en el nodo "Para cada uno" pueden gestionar muchas llamadas a la API en poco tiempo.

   5. Especifique qué desea hacer si se produce un error mientras el flujo está procesando uno de los elementos.

      Si no desea que un error impida que se procesen los demás registros, seleccione Procesar todos los demás elementos y continúe con el flujo.

      Si es importante que se procesen todos los registros, seleccione Salir del flujo con un error. Al seleccionar esta opción, el flujo se detiene en ese punto y no se completa ninguna acción futura del flujo.

   6. En el nodo "Para cada" del flujo, haga clic en el signo más (+) y seleccione la acción que desea completar para cada elemento recuperado.
   7. Configure la acción de la forma habitual, asignando los campos relevantes de las aplicaciones anteriores en el flujo. Además de asignar campos de datos de las aplicaciones anteriores en el flujo, también puede asignar el código de estado de la acción de recuperación. Por ejemplo, puede añadir una acción "Crear mensaje" de Slack a su nodo "Para cada uno" que publique en Slack los códigos de estado de cada uno de los elementos recuperados. A continuación, su equipo informático puede hacer un seguimiento de los registros que no se puedan recuperar. Si lo desea, puede añadir más acciones al nodo "Para cada uno".

      En el siguiente ejemplo, usted procesa algunos clientes potenciales que ha recuperado de Salesforce. Si no te importa el orden en que se procesan, procésalos en paralelo para optimizar el rendimiento. A Para cada nodo contiene un Google Hojas "Crear fila" acción. Así, para cada cliente potencial que recupere de Salesforce la acción crea una fila en una hoja de cálculo de Google Sheets con la información que se ha asignado desde el evento y las acciones anteriores en el flujo. Por lo tanto, si ha recuperado 20 clientes potenciales, espera ver 20 filas en la hoja de cálculo cuando finalice el flujo.

      

9. Puede añadir más acciones a su flujo después de su nodo "Para cada uno".
10. Para probar su flujo, haga clic en Probar flujo y, a continuación, seleccione la opción de utilizar datos de muestra o datos reales. Para más información, consulte Probar los flujos durante el desarrollo.
    Advertencia: Asegúrese de que las aplicaciones conectadas son apropiadas para realizar pruebas. Sus aplicaciones se actualizan con los datos reales o de muestra cuando se activa el flujo.