Agente Lead Ops do Jitterbit
Visão geral
O Jitterbit fornece o Agente Lead Ops aos clientes através do Jitterbit Marketplace. Este agente automatiza o enriquecimento de leads conectando envios de formulários do HubSpot ao Salesforce e ZoomInfo, ajudando organizações a manter dados de leads precisos e completos sem esforço manual.
O agente recupera envios de formulários do HubSpot, verifica registros de leads correspondentes no Salesforce e amplia esses registros com dados adicionais de contato e empresa do ZoomInfo. Os dados atualizados são gravados no Salesforce, e notificações do Slack mantêm sua equipe informada sobre o status de execução e erros.
O agente executa as seguintes tarefas:
- Recupera formulários disponíveis e dados de envio do HubSpot.
- Consulta o Salesforce para verificar se existe um registro de lead correspondente usando o endereço de e-mail do envio.
- Atualiza o registro de lead existente do Salesforce com dados do envio do HubSpot.
- Autentica com ZoomInfo para obter um token JWT para chamadas de API de enriquecimento.
- Amplia o registro de lead do Salesforce com dados adicionais de contato e empresa do ZoomInfo.
- Grava os dados de lead ampliados de volta no Salesforce.
- Envia notificações do Slack após execução bem-sucedida, incluindo nome da operação, data/hora de execução e status de integração.
Este documento explica como configurar e operar este agente de IA. Ele aborda a arquitetura e pré-requisitos, além das etapas para instalar, configurar e operar o agente de IA.
Arquitetura do agente de IA
Este agente de IA conecta HubSpot, Salesforce e ZoomInfo para coletar, atualizar e enriquecer registros de leads. Um fluxo de trabalho típico segue estas etapas:
- As operações do agente são executadas por hora em um cronograma. O agente recupera todos os formulários disponíveis do HubSpot e, em seguida, busca registros de envio para cada formulário.
- Para cada envio, o agente consulta o Salesforce usando o endereço de e-mail do envio para verificar se existe um registro de lead correspondente.
- Se existe um lead correspondente, o agente mapeia campos de envio do HubSpot para campos de lead do Salesforce e executa uma operação de upsert.
- O agente autentica com o ZoomInfo para obter um token JWT e, em seguida, envia os dados de lead atualizados do Salesforce para a API de Enriquecimento do ZoomInfo para recuperar dados adicionais de contato e empresa.
- O agente grava os dados ampliados de volta no Salesforce, atualizando o registro de lead com informações adicionais de contato e empresa do ZoomInfo.
- Após execução bem-sucedida, o agente envia uma notificação do Slack com o nome da operação, data/hora de execução e status de integração.
- Cada etapa registra suas cargas úteis de entrada e saída para oferecer suporte à solução de problemas e auditoria.
Diagrama de fluxo de trabalho
O diagrama a seguir mostra como o agente move dados de leads do HubSpot através do Salesforce e ZoomInfo.
As duas chamadas de API sequenciais do HubSpot (recuperação de formulários e depois envios) são mostradas como uma única troca para maior clareza. As chamadas de autenticação e enriquecimento do ZoomInfo são mostradas como nós separados porque usam endpoints 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
Pré-requisitos
Você precisa dos seguintes componentes para usar este agente de IA.
Componentes Harmony
Você deve ter uma licença do Jitterbit Harmony com acesso aos seguintes componentes:
- Jitterbit Studio
- Jitterbit API Manager
- Agente Lead Ops adquirido como complemento de licença
Endpoints suportados
O agente de IA se conecta aos seguintes serviços externos. Você pode adaptar outros sistemas modificando as configurações de endpoints e fluxos de trabalho do projeto.
HubSpot
O agente usa a API do HubSpot para recuperar definições de formulários e registros de envio. Você deve ter uma conta do HubSpot com acesso de API e uma chave de API válida.
Salesforce
O agente usa a API REST do Salesforce para consultar e atualizar registros de leads. É necessário ter uma conta Salesforce com credenciais que tenham permissão para ler e gravar objetos Lead.
ZoomInfo
O agente usa a API ZoomInfo para enriquecer dados de leads. É necessário ter uma conta ZoomInfo com um ID de cliente e segredo de cliente que tenham permissão para chamar a API de enriquecimento.
Serviço de notificação
O agente usa Slack para enviar notificações de sucesso e erro. É necessário ter uma URL de webhook do Slack configurada para o canal onde as notificações devem ser enviadas. Você pode substituir o Slack por outro serviço de notificação modificando as configurações de endpoint do projeto e adaptando os workflows para o schema exigido pelo seu serviço escolhido.
Instalação, configuração e operação
Siga estas etapas para instalar, configurar e operar este agente IA:
- Baixar e instalar o projeto
- Configurar variáveis do projeto
- Testar conexões
- Implementar o projeto
- Revisar workflows do projeto
- Ativar os workflows do projeto
Para obter orientação sobre resolução de problemas, consulte Resolução de problemas.
Baixar e instalar o projeto
Siga estas etapas para baixar e instalar o projeto Studio para o agente IA:
-
Faça login no portal Harmony em https://login.jitterbit.com e abra Marketplace.
-
Localize o agente IA chamado Jitterbit Lead Ops Agent. Para localizar o agente, use a barra de pesquisa ou, no painel Filters em Type, selecione AI Agent para limitar a exibição aos agentes IA.
-
Clique no link Documentation do agente IA para abrir sua documentação em uma aba separada. Mantenha a aba aberta para referência.
-
Clique em Start Project para abrir um diálogo de configuração em duas etapas para importar o agente IA como um projeto Studio.
Nota
Se você ainda não adquiriu o agente IA, Get agent é exibido. Clique nele para abrir um diálogo informativo e clique em Submit para ter um representante contatá-lo sobre a compra do agente IA.
-
Na etapa de configuração 2, Create a New Project, selecione um ambiente onde o projeto Studio será criado e clique em Create Project.
-
Um diálogo de progresso é exibido. Assim que indicar que o projeto foi criado, use o link do diálogo Go to Studio ou abra o projeto diretamente na página Projects do Studio.
Configurar variáveis do projeto
No projeto Studio instalado do Marketplace, é necessário definir valores para as seguintes variáveis de projeto.
Para configurar variáveis de projeto, use o menu de ações da barra de ferramentas do projeto para selecionar Project Variables e abrir um painel na parte inferior da página onde você pode revisar e definir valores.
HubSpot
| Nome da variável | Descrição |
|---|---|
Hubspot_API_Key |
Chave de API usada para autenticar chamadas da API HubSpot. |
Salesforce
| Nome da variável | Descrição |
|---|---|
Salesforce_Username |
Nome de usuário da conta Salesforce usada pela integração. |
Salesforce_Password |
Senha da conta Salesforce usada pela integração. |
ZoomInfo
| Nome da variável | Descrição |
|---|---|
ZoomInfo_Client_ID |
ID de cliente usado para autenticar chamadas da API ZoomInfo. |
ZoomInfo_Client_Secret |
Segredo de cliente usado para autenticar chamadas da API ZoomInfo. |
Slack
| Nome da variável | Descrição |
|---|---|
Slack_Webhook_URL |
URL do Webhook do canal Slack onde as notificações são enviadas. |
Testar conexões
Teste as configurações do endpoint para verificar a conectividade usando os valores de variáveis de projeto que você configurou.
Para testar conexões, acesse a aba Endpoints e conectores de projeto na paleta de componentes de design, passe o mouse sobre cada endpoint e clique em Testar.
Implantar o projeto
Implante o projeto do Studio.
Para implantar o projeto, use o menu Ações da barra de ferramentas do projeto e selecione Implantar.
Revisar fluxos de trabalho do projeto
Cada fluxo de trabalho executa uma função específica no fluxo de dados entre HubSpot, ZoomInfo e Salesforce.
| Fluxo de trabalho | Descrição |
|---|---|
| Extração de dados de formulários HubSpot | Recupera formulários disponíveis do HubSpot. |
| Processamento de envios de formulário | Busca e transforma dados de envios de formulário. |
| Pesquisa de leads do Salesforce | Consulta o Salesforce para procurar um lead correspondente por endereço de email. |
| Atualização de leads do Salesforce | Faz upsert de dados de envios do HubSpot no lead correspondente do Salesforce. |
| Autenticação do ZoomInfo | Autentica com o ZoomInfo para recuperar um token JWT. |
| Extração de token | Extrai o token JWT da resposta de autenticação do ZoomInfo. |
| Enriquecimento de dados via ZoomInfo | Envia dados de lead ao ZoomInfo e recupera informações enriquecidas. |
| Atualização do Salesforce pós-enriquecimento | Escreve dados enriquecidos do ZoomInfo no Salesforce. |
| Notificação de sucesso no Slack | Envia uma notificação de sucesso para o canal Slack configurado. |
Extração de dados de formulários HubSpot
Este fluxo de trabalho inicializa a integração e recupera todos os formulários disponíveis do HubSpot. As operações no fluxo de trabalho são configuradas para executar a cada hora usando cronogramas de operação. O fluxo de trabalho filtra e prepara os dados do formulário para uso no fluxo de trabalho de processamento de envios a seguir.
Processamento de envios de formulário
Este fluxo de trabalho recupera registros de envios para cada formulário obtido no fluxo de trabalho anterior. O fluxo de trabalho converte dados de envios do HubSpot para o formato de integração necessário e armazena a carga transformada para uso no fluxo de trabalho de pesquisa de leads do Salesforce.
Pesquisa de leads do Salesforce
Este fluxo de trabalho consulta o objeto Lead do Salesforce usando o endereço de email do envio como chave primária para verificar se existe um registro de lead correspondente. O fluxo de trabalho armazena os resultados da consulta para uso no fluxo de trabalho de atualização de leads subsequente.
Atualização de leads do Salesforce
Este fluxo de trabalho mapeia campos de envio do HubSpot para campos de lead do Salesforce e executa uma operação de upsert no registro de lead correspondente. O fluxo de trabalho armazena a resposta do Salesforce para uso no fluxo de trabalho de enriquecimento do ZoomInfo.
Autenticação do ZoomInfo
Este fluxo de trabalho autentica com o ZoomInfo para obter um token JWT necessário para chamadas da API de enriquecimento. O fluxo de trabalho envia uma solicitação de autenticação para a API de autenticação do ZoomInfo e armazena a resposta para uso no fluxo de trabalho de extração de token.
Extração de token
Este fluxo de trabalho lê a resposta de autenticação do ZoomInfo e extrai o token JWT. O fluxo de trabalho salva o token em variáveis globais para uso no fluxo de trabalho de enriquecimento de dados.
Enriquecimento de Dados via ZoomInfo
Este fluxo de trabalho lê os dados de leads do Salesforce atualizados e envia uma solicitação de enriquecimento para a API de Enriquecimento do ZoomInfo. O fluxo de trabalho armazena a resposta enriquecida para uso no fluxo de trabalho de atualização do Salesforce pós-enriquecimento.
Atualização do Salesforce Pós-Enriquecimento
Este fluxo de trabalho lê a resposta de enriquecimento do ZoomInfo, mapeia os campos enriquecidos para o objeto Lead do Salesforce e atualiza o registro de lead no Salesforce com os dados enriquecidos.
Notificação de Sucesso no Slack
Este fluxo de trabalho envia uma notificação de sucesso para o canal do Slack configurado após a conclusão bem-sucedida de todos os fluxos de trabalho. A notificação inclui o nome da operação, o timestamp de execução e o status da integração.
Dispare os fluxos de trabalho do projeto
O agente é executado automaticamente em um cronograma horário. Também é possível disparar fluxos de trabalho manualmente.
Para executar uma operação manualmente, passe o mouse sobre o nome da operação no Studio e selecione a opção Executar.
Dica
Para alterar a frequência do cronograma, abra o menu de ações da operação programada e selecione Configurações > Cronogramas.
Notificações do Slack
Após a execução bem-sucedida, o agente envia uma notificação do Slack para o canal configurado na variável de projeto Slack_Webhook_URL.
Cada notificação inclui as seguintes informações:
- Nome da operação
- Timestamp de execução
- Status da integração
Solução de problemas
Se encontrar problemas, consulte os seguintes recursos para obter informações detalhadas de solução de problemas:
Para assistência adicional, entre em contato com suporte do Jitterbit.