Jitterbit Lead Ops Agent
Overview
Jitterbit proporciona el Lead Ops Agent a los clientes a través de Jitterbit Marketplace. Este agente automatiza el enriquecimiento de leads al conectar las presentaciones de formularios de HubSpot con Salesforce y ZoomInfo, ayudando a las organizaciones a mantener datos de leads precisos y completos sin esfuerzo manual.
El agente recupera las presentaciones de formularios de HubSpot, verifica si existen registros de leads coincidentes en Salesforce y enriquece esos registros con datos adicionales de contacto y empresa de ZoomInfo. Los datos actualizados se escriben de nuevo en Salesforce, y las notificaciones de Slack mantienen a su equipo informado sobre el estado de ejecución y errores.
El agente realiza las siguientes tareas:
- Recupera formularios disponibles y datos de presentación de HubSpot.
- Consulta Salesforce para verificar si existe un registro de lead coincidente utilizando la dirección de correo electrónico de la presentación.
- Actualiza el registro de lead existente en Salesforce con datos de la presentación de HubSpot.
- Se autentica con ZoomInfo para obtener un token JWT para llamadas a la API de enriquecimiento.
- Enriquece el registro de lead de Salesforce con datos adicionales de contacto y empresa de ZoomInfo.
- Escribe los datos de lead enriquecidos de nuevo en Salesforce.
- Envía notificaciones de Slack después de una 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. Cubre arquitectura y requisitos previos, y pasos para instalar, configurar y operar el agente de IA.
AI agent architecture
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:
- Las operaciones del agente se ejecutan cada hora según un horario. El agente recupera todos los formularios disponibles de HubSpot y luego obtiene los registros de presentación para cada formulario.
- Para cada presentación, el agente consulta Salesforce utilizando la dirección de correo electrónico de la presentación para verificar si existe un registro de lead coincidente.
- Si existe un lead coincidente, el agente mapea los campos de presentación de HubSpot a los campos de lead de Salesforce y realiza una operación de upsert.
- El agente se autentica con ZoomInfo para obtener un token JWT, 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.
- El agente escribe los datos enriquecidos de nuevo en Salesforce, actualizando el registro de lead con información adicional de contacto y empresa de ZoomInfo.
- Después de una 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.
- Cada paso registra su carga útil de entrada y salida para apoyar la solución de problemas y la auditoría.
Diagrama de flujo
El siguiente diagrama ilustra cómo el agente mueve los datos de leads de HubSpot a través de Salesforce y ZoomInfo.
Las dos llamadas API secuenciales de HubSpot (recuperando formularios y luego envíos) se muestran como un único intercambio por claridad. Las llamadas de autenticación y enriquecimiento de ZoomInfo se muestran como nodos separados porque utilizan puntos finales de API distintos.
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:
- Jitterbit Studio
- Jitterbit API Manager
- Agente Lead Ops adquirido como un complemento de licencia
Puntos finales soportados
El agente de IA se conecta a los siguientes servicios externos. Puedes acomodar 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 API válida.
Salesforce
El agente utiliza la API REST de Salesforce para consultar y actualizar registros de leads. Debes tener 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 los datos de leads. Debes tener una cuenta de ZoomInfo con un ID de cliente y un secreto de cliente que tengan permiso para llamar a la API de enriquecimiento.
Servicio de notificación
El agente utiliza Slack para enviar notificaciones de éxito y error. Debes tener una URL de webhook de Slack configurada para el canal donde se deben enviar las notificaciones. Puedes reemplazar Slack con otro servicio de notificación modificando las configuraciones de puntos finales del proyecto y adaptando los flujos de trabajo al esquema requerido por el servicio que elijas.
Instalación, configuración y operación
Sigue estos pasos para instalar, configurar y operar este agente de IA:
- Descargar e instalar el proyecto
- Configurar variables del proyecto
- Probar conexiones
- Desplegar el proyecto
- Revisar flujos de trabajo del proyecto
- Activar los 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 Studio para el agente de IA:
-
Inicia sesión en el portal Harmony en https://login.jitterbit.com y abre Marketplace.
-
Localiza el agente de IA llamado Jitterbit Lead Ops Agent. Para localizar el agente, utiliza la barra de búsqueda o, en el panel de Filtros bajo Tipo, selecciona Agente de IA para limitar la visualización a agentes de IA.
-
Haz clic en el enlace de Documentación del agente de IA para abrir su documentación en una pestaña separada. Mantén la pestaña abierta para referencia.
-
Haz clic en Iniciar Proyecto para abrir un diálogo de configuración de dos pasos para importar el agente de IA como un proyecto de Studio.
Nota
Si aún no has comprado el agente de IA, se mostrará Obtener este agente en su lugar. Haz clic en él para abrir un diálogo informativo, luego haz clic en Enviar para que un representante se comunique contigo sobre la compra del agente de IA.
-
En el paso de configuración 2, Crear un Nuevo Proyecto, selecciona un entorno donde se creará el proyecto de Studio, luego haz clic en Crear Proyecto.
-
Se muestra un diálogo de progreso. Una vez que indique que el proyecto ha sido creado, utiliza el enlace del diálogo Ir a 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 del proyecto.
Para configurar las variables del proyecto, utiliza el panel de herramientas del proyecto del menú de acciones para seleccionar Variables del Proyecto y abrir un panel en la parte inferior de la página donde puedes revisar y establecer valores.
HubSpot
| Nombre de la variable | Descripción |
|---|---|
Hubspot_API_Key |
Clave API utilizada para autenticar las llamadas a la API de HubSpot. |
Salesforce
| Nombre de la variable | Descripción |
|---|---|
Salesforce_Username |
Nombre de usuario para la cuenta de Salesforce utilizada por la integración. |
Salesforce_Password |
Contraseña para la cuenta de Salesforce utilizada por la integración. |
ZoomInfo
| Nombre de la variable | Descripción |
|---|---|
ZoomInfo_Client_ID |
ID de cliente utilizado para autenticar las llamadas a la API de ZoomInfo. |
ZoomInfo_Client_Secret |
Secreto de cliente utilizado para autenticar las llamadas a la API de ZoomInfo. |
Slack
| Nombre de la variable | Descripción |
|---|---|
Slack_Webhook_URL |
URL del Webhook para el canal de Slack donde se envían las notificaciones. |
Probar conexiones
Prueba las configuraciones de los endpoints para verificar la conectividad utilizando los valores de las variables del proyecto que configuraste.
Para probar conexiones, ve a la pestaña Endpoints y conectores del proyecto en la paleta de componentes de diseño, pasa el cursor sobre cada endpoint y haz clic en Probar.
Desplegar el proyecto
Desplegar el proyecto de Studio.
Para desplegar el proyecto, utiliza el panel de herramientas del proyecto del menú de acciones para seleccionar Desplegar.
Revisar flujos de trabajo del proyecto
Cada flujo de trabajo realiza una función específica en el flujo de datos a través de HubSpot, ZoomInfo y Salesforce.
| Flujo de trabajo | Descripción |
|---|---|
| Extracción de Datos de Formularios de HubSpot | Recupera los formularios disponibles de HubSpot. |
| Procesamiento de Envíos de Formularios | Obtiene y transforma los datos de envío de formularios. |
| Búsqueda de Leads en Salesforce | Consulta Salesforce para encontrar un lead coincidente por dirección de correo electrónico. |
| Actualización de Leads en Salesforce | Inserta o actualiza los datos de envío de HubSpot en el lead coincidente de Salesforce. |
| Autenticación de ZoomInfo | Se autentica con ZoomInfo para recuperar un token JWT. |
| Extracción de Token | Extrae el token JWT de la respuesta de autenticación de ZoomInfo. |
| Enriquecimiento de Datos a través de ZoomInfo | Envía datos de leads a ZoomInfo y recupera información enriquecida. |
| Actualización de Salesforce Post-Enriquecimiento | Escribe los datos enriquecidos de ZoomInfo de vuelta en Salesforce. |
| Notificación de Éxito en Slack | Envía una notificación de éxito al canal de Slack configurado. |
Extracción de Datos de Formularios de HubSpot
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 utilizando programaciones de operaciones. El flujo de trabajo filtra y prepara los datos del formulario para su uso en el siguiente flujo de trabajo de procesamiento de envíos.
Procesamiento de Envíos de Formularios
Este flujo de trabajo recupera los 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 en el formato de integración requerido y almacena la carga útil transformada para su uso en el flujo de trabajo de búsqueda de leads en Salesforce.
Búsqueda de Leads en Salesforce
Este flujo de trabajo consulta el objeto Lead de Salesforce utilizando 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 su uso en el siguiente flujo de trabajo de actualización de leads.
Actualización de Lead de Salesforce
Este flujo de trabajo mapea los campos de envío de HubSpot a los campos de lead de Salesforce y realiza una operación de upsert en el registro de lead correspondiente. El flujo de trabajo almacena la respuesta de Salesforce para su uso en el flujo de trabajo de enriquecimiento de ZoomInfo.
Autenticación de ZoomInfo
Este flujo de trabajo se autentica con ZoomInfo para obtener un token JWT requerido para las llamadas a la 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 su uso en el flujo de trabajo de extracción de token.
Extracción de Token
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 su uso 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 lead 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 su uso 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, mapea los campos enriquecidos al objeto Lead de Salesforce y actualiza el registro de lead en Salesforce con los datos enriquecidos.
Notificación de Éxito en Slack
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 con éxito. La notificación incluye el nombre de la operación, la marca de tiempo de ejecución y el estado de integración.
Activar los flujos de trabajo del proyecto
El agente se ejecuta automáticamente en un horario horario. También puedes 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ú de acciones de la operación programada y selecciona Configuración > Horarios.
Notificaciones de Slack
Después de 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 encuentras problemas, revisa los siguientes recursos para obtener información detallada sobre la solución de problemas:
Para asistencia adicional, contacta al soporte de Jitterbit.