Saltar al contenido

Jitterbit Lead Ops Agent

Descripción General

Jitterbit proporciona el Lead Ops Agent a los clientes a través de Jitterbit Marketplace. Este agente automatiza el enriquecimiento de leads conectando los envíos de formularios de HubSpot con Salesforce y ZoomInfo, lo que ayuda a las organizaciones a mantener datos de leads precisos y completos sin esfuerzo manual.

El agente recupera los envíos de formularios de HubSpot, verifica si existen registros de leads coincidentes en Salesforce y aumenta esos registros con datos adicionales de contacto y empresa de ZoomInfo. Los datos actualizados se escriben nuevamente en Salesforce, y las notificaciones de Slack mantienen informado a tu equipo sobre el estado de ejecución y los errores.

El agente realiza las siguientes tareas:

  • Recupera formularios disponibles y datos de envíos de HubSpot.
  • Consulta Salesforce para verificar si existe un registro de lead coincidente usando la dirección de correo electrónico del envío.
  • Actualiza el registro de lead existente en Salesforce con datos del envío de HubSpot.
  • Se autentica con ZoomInfo para obtener un token JWT para las llamadas de API de enriquecimiento.
  • Aumenta el registro de lead de Salesforce con datos adicionales de contacto y empresa de ZoomInfo.
  • Escribe los datos de lead aumentados nuevamente en Salesforce.
  • Envía notificaciones de Slack después de la ejecución exitosa, incluyendo el nombre de la operación, la marca de tiempo de ejecución y el estado de integración.

Este documento explica cómo configurar y operar este agente de IA. Abarca la arquitectura y los requisitos previos, así como los pasos para instalar, configurar y operar el agente de IA.

Arquitectura del agente de IA

Este agente de IA conecta HubSpot, Salesforce y ZoomInfo para recopilar, actualizar y enriquecer registros de leads. Un flujo de trabajo típico sigue estos pasos:

  1. Las operaciones del agente se ejecutan cada hora según una programación. El agente recupera todos los formularios disponibles de HubSpot y luego obtiene registros de envíos para cada formulario.
  2. Para cada envío, el agente consulta Salesforce usando la dirección de correo electrónico del envío para verificar si existe un registro de lead coincidente.
  3. Si existe un lead coincidente, el agente asigna campos de envío de HubSpot a campos de lead de Salesforce y realiza una operación de upsert.
  4. El agente se autentica con ZoomInfo para obtener un token JWT y luego envía los datos de lead actualizados de Salesforce a la API de enriquecimiento de ZoomInfo para recuperar datos adicionales de contacto y empresa.
  5. El agente escribe los datos aumentados nuevamente en Salesforce, actualizando el registro de lead con información adicional de contacto y empresa de ZoomInfo.
  6. Después de la ejecución exitosa, el agente envía una notificación de Slack con el nombre de la operación, la marca de tiempo de ejecución y el estado de integración.
  7. Cada paso registra su carga útil de entrada y salida para apoyar la solución de problemas y auditoría.

Diagrama de flujo de trabajo

El siguiente diagrama muestra cómo el agente traslada datos de leads desde HubSpot a través de Salesforce y ZoomInfo.

Las dos llamadas de API secuenciales de HubSpot (recuperación de formularios y luego envíos) se muestran como un único intercambio para mayor claridad. Las llamadas de autenticación y enriquecimiento de ZoomInfo se muestran como nodos separados porque utilizan puntos finales de API distintos.

--- config: themeVariables: lineColor: '#6b7280' edgeLabelBackground: '#f5f5f5' flowchart: padding: 20 nodeSpacing: 100 --- flowchart LR classDef default fill:white, stroke:black, stroke-width:3px, rx:15px, ry:15px JSP@{ shape: hex, label: "
Jitterbit Lead Ops
Agent" } HS[fab:fa-hubspot
HubSpot] SF[fab:fa-salesforce
Salesforce] ZIA[ZoomInfo Auth REST call] ZIE@{ shape: hex, label: "ZoomInfo Enrichment API" } SLK[fab:fa-slack
Slack] JSP -->|1. Get form submissions| HS HS -->|2. Submission data| JSP JSP -->|3. Query lead by email| SF SF -->|4. Lead record| JSP JSP -->|5. Upsert lead| SF JSP -->|6. Auth request| ZIA ZIA -->|7. JWT token| JSP JSP -->|8. Enrichment request| ZIE ZIE -->|9. Augmented lead data| JSP JSP -->|10. Update lead| SF JSP -->|11. Success notification| SLK

Requisitos Previos

Necesitas los siguientes componentes para usar este agente de IA.

Componentes de Harmony

Debes tener una licencia de Jitterbit Harmony con acceso a los siguientes componentes:

Puntos finales compatibles

El agente de IA se conecta a los siguientes servicios externos. Puedes adaptarte a otros sistemas modificando las configuraciones de puntos finales y flujos de trabajo del proyecto.

HubSpot

El agente utiliza la API de HubSpot para recuperar definiciones de formularios y registros de envíos. Debes tener una cuenta de HubSpot con acceso a la API y una clave de API válida.

Salesforce

El agente utiliza la API REST de Salesforce para consultar y actualizar registros de clientes potenciales. Se requiere una cuenta de Salesforce con credenciales que tengan permiso para leer y escribir objetos Lead.

ZoomInfo

El agente utiliza la API de ZoomInfo para enriquecer datos de clientes potenciales. Se requiere una cuenta de ZoomInfo con un ID de cliente y secreto de cliente que tengan permiso para llamar a la API de enriquecimiento.

Servicio de notificaciones

El agente utiliza Slack para enviar notificaciones de éxito y error. Se requiere una URL de webhook de Slack configurada para el canal donde se deben enviar las notificaciones. Puedes reemplazar Slack con otro servicio de notificaciones modificando las configuraciones de punto de conexión del proyecto y adaptando los flujos de trabajo al esquema requerido por el servicio elegido.

Instalación, configuración y operación

Sigue estos pasos para instalar, configurar y operar este agente de IA:

  1. Descargar e instalar el proyecto
  2. Configurar variables del proyecto
  3. Probar conexiones
  4. Desplegar el proyecto
  5. Revisar flujos de trabajo del proyecto
  6. Activar flujos de trabajo del proyecto

Para obtener orientación sobre solución de problemas, consulta Solución de problemas.

Descargar e instalar el proyecto

Sigue estos pasos para descargar e instalar el proyecto de Studio para el agente de IA:

  1. Inicia sesión en el portal de Harmony en https://login.jitterbit.com y abre el Marketplace.

  2. Ubica el agente de IA llamado Jitterbit Lead Ops Agent. Para localizarlo, utiliza la barra de búsqueda o en el panel de Filtros bajo Tipo, selecciona AI Agent para limitar la visualización a agentes de IA.

  3. Haz clic en el enlace de Documentación del agente de IA para abrir su documentación en una pestaña nueva. Mantén la pestaña abierta para referencia.

  4. Haz clic en Start Project para abrir un diálogo de configuración de dos pasos e importar el agente de IA como un proyecto de Studio.

    Nota

    Si aún no has comprado el agente de IA, se mostrará Get agent en su lugar. Haz clic en él para abrir un diálogo informativo y luego haz clic en Submit para que un representante se comunique contigo acerca de la compra del agente de IA.

  5. En el paso de configuración 2, Create a New Project, selecciona un entorno donde se creará el proyecto de Studio y luego haz clic en Create Project.

  6. Se mostrará un diálogo de progreso. Una vez que indique que el proyecto se ha creado, utiliza el enlace del diálogo Go to Studio o abre el proyecto directamente desde la página de Proyectos de Studio.

Configurar variables del proyecto

En el proyecto de Studio instalado desde Marketplace, debes establecer valores para las siguientes variables de proyecto.

Para configurar variables de proyecto, utiliza el menú de acciones de la barra de herramientas del proyecto para seleccionar Project Variables y abre un panel en la parte inferior de la página donde puedes revisar y establecer valores.

HubSpot

Nombre de variable Descripción
Hubspot_API_Key Clave de API utilizada para autenticar llamadas a la API de HubSpot.

Salesforce

Nombre de variable Descripción
Salesforce_Username Nombre de usuario de la cuenta de Salesforce utilizada por la integración.
Salesforce_Password Contraseña de la cuenta de Salesforce utilizada por la integración.

ZoomInfo

Nombre de variable Descripción
ZoomInfo_Client_ID ID de cliente utilizado para autenticar llamadas a la API de ZoomInfo.
ZoomInfo_Client_Secret Secreto de cliente utilizado para autenticar llamadas a la API de ZoomInfo.

Slack

Nombre de variable Descripción
Slack_Webhook_URL URL de webhook del canal de Slack donde se envían las notificaciones.

Probar conexiones

Prueba las configuraciones del endpoint para verificar la conectividad usando los valores de variables de proyecto que configuraste.

Para probar conexiones, ve a la pestaña Project endpoints and connectors de la paleta de componentes de diseño, pasa el cursor sobre cada endpoint y haz clic en Test.

Implementar el proyecto

Implementa el proyecto de Studio.

Para implementar el proyecto, usa el menú acciones de la barra de herramientas del proyecto y selecciona Deploy.

Revisar los flujos de trabajo del proyecto

Cada flujo de trabajo realiza una función específica en el flujo de datos entre HubSpot, ZoomInfo y Salesforce.

Flujo de trabajo Descripción
HubSpot Forms Data Extraction Recupera los formularios disponibles de HubSpot.
Form Submission Processing Obtiene y transforma los datos de envío de formulario.
Salesforce Lead Lookup Consulta Salesforce para encontrar un lead coincidente por dirección de correo electrónico.
Salesforce Lead Update Inserta o actualiza los datos de envío de HubSpot en el lead de Salesforce coincidente.
ZoomInfo Authentication Se autentica con ZoomInfo para recuperar un token JWT.
Token Extraction Extrae el token JWT de la respuesta de autenticación de ZoomInfo.
Data Enrichment via ZoomInfo Envía datos de lead a ZoomInfo y recupera información enriquecida.
Post-Enrichment Salesforce Update Escribe los datos enriquecidos de ZoomInfo de nuevo en Salesforce.
Success Slack Notification Envía una notificación de éxito al canal de Slack configurado.

HubSpot Forms Data Extraction

Este flujo de trabajo inicializa la integración y recupera todos los formularios disponibles de HubSpot. Las operaciones en el flujo de trabajo están configuradas para ejecutarse cada hora usando programas de operación. El flujo de trabajo filtra y prepara los datos del formulario para usarlos en el siguiente flujo de trabajo de procesamiento de envíos.

Form Submission Processing

Este flujo de trabajo recupera registros de envío para cada formulario obtenido en el flujo de trabajo anterior. El flujo de trabajo convierte los datos de envío de HubSpot al formato de integración requerido y almacena la carga útil transformada para usarla en el flujo de trabajo de búsqueda de lead de Salesforce.

Salesforce Lead Lookup

Este flujo de trabajo consulta el objeto Lead de Salesforce usando la dirección de correo electrónico del envío como clave principal para verificar si existe un registro de lead coincidente. El flujo de trabajo almacena los resultados de la consulta para usarlos en el siguiente flujo de trabajo de actualización de lead.

Salesforce Lead Update

Este flujo de trabajo asigna campos de envío de HubSpot a campos de lead de Salesforce y realiza una operación de inserción o actualización en el registro de lead coincidente. El flujo de trabajo almacena la respuesta de Salesforce para usarla en el flujo de trabajo de enriquecimiento de ZoomInfo.

ZoomInfo Authentication

Este flujo de trabajo se autentica con ZoomInfo para obtener un token JWT requerido para las llamadas de API de enriquecimiento. El flujo de trabajo envía una solicitud de autenticación a la API de autenticación de ZoomInfo y almacena la respuesta para usarla en el flujo de trabajo de extracción de token.

Token Extraction

Este flujo de trabajo lee la respuesta de autenticación de ZoomInfo y extrae el token JWT. El flujo de trabajo guarda el token en variables globales para usarlo en el flujo de trabajo de enriquecimiento de datos.

Enriquecimiento de datos a través de ZoomInfo

Este flujo de trabajo lee los datos de clientes potenciales de Salesforce actualizados y envía una solicitud de enriquecimiento a la API de enriquecimiento de ZoomInfo. El flujo de trabajo almacena la respuesta enriquecida para usarla en el flujo de trabajo de actualización de Salesforce posterior al enriquecimiento.

Actualización de Salesforce posterior al enriquecimiento

Este flujo de trabajo lee la respuesta de enriquecimiento de ZoomInfo, asigna los campos enriquecidos al objeto Lead de Salesforce y actualiza el registro de cliente potencial en Salesforce con los datos enriquecidos.

Notificación de Slack de éxito

Este flujo de trabajo envía una notificación de éxito al canal de Slack configurado después de que todos los flujos de trabajo se completen correctamente. La notificación incluye el nombre de la operación, la marca de tiempo de ejecución y el estado de la integración.

Activar los flujos de trabajo del proyecto

El agente se ejecuta automáticamente en un horario cada hora. También se pueden activar flujos de trabajo manualmente.

Para ejecutar una operación manualmente, pasa el cursor sobre el nombre de la operación en Studio y selecciona la opción Ejecutar.

Consejo

Para cambiar la frecuencia del horario, abre el menú acciones de la operación programada y selecciona Configuración > Horarios.

Notificaciones de Slack

Tras la ejecución exitosa, el agente envía una notificación de Slack al canal configurado en la variable de proyecto Slack_Webhook_URL.

Cada notificación incluye la siguiente información:

  • Nombre de la operación
  • Marca de tiempo de ejecución
  • Estado de la integración

Solución de problemas

Si se encuentran problemas, consulta los siguientes recursos para obtener información detallada sobre la solución de problemas:

Para obtener asistencia adicional, contacta con soporte de Jitterbit.