Jitterbit Lead Ops Agent
Visão Geral
A Jitterbit fornece o Lead Ops Agent aos clientes por meio do Jitterbit Marketplace. Este agente automatiza o enriquecimento de leads conectando envios de formulários do HubSpot ao Salesforce e ZoomInfo, ajudando as organizações a manter dados de leads precisos e completos sem esforço manual.
O agente recupera envios de formulários do HubSpot, verifica se existem registros de leads correspondentes no Salesforce e enriquece esses registros com dados adicionais de contato e empresa do ZoomInfo. Os dados atualizados são gravados de volta no Salesforce, e notificações no Slack mantêm sua equipe informada sobre o status da execução e erros.
O agente realiza 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 email do envio.
- Atualiza o registro de lead existente no Salesforce com dados do envio do HubSpot.
- Autentica-se com o ZoomInfo para obter um token JWT para chamadas da API de enriquecimento.
- Enriquece o registro de lead do Salesforce com dados adicionais de contato e empresa do ZoomInfo.
- Grava os dados de lead enriquecidos de volta no Salesforce.
- Envia notificações no Slack após a execução bem-sucedida, incluindo nome da operação, timestamp da execução e status da integração.
Este documento explica como configurar e operar este agente de IA. Ele abrange arquitetura e pré-requisitos, e 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 a cada 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 email do envio para verificar se existe um registro de lead correspondente.
- Se um lead correspondente existir, o agente mapeia os campos de envio do HubSpot para os campos de lead do Salesforce e realiza uma operação de upsert.
- O agente autentica-se com o ZoomInfo para obter um token JWT, 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 enriquecidos de volta no Salesforce, atualizando o registro de lead com informações adicionais de contato e empresa do ZoomInfo.
- Após a execução bem-sucedida, o agente envia uma notificação no Slack com o nome da operação, timestamp da execução e status da integração.
- Cada etapa registra sua carga útil de entrada e saída para suportar a solução de problemas e auditoria.
Diagrama de fluxo de trabalho
O diagrama a seguir ilustra como o agente move dados de leads do HubSpot através do Salesforce e ZoomInfo.
As duas chamadas de API sequenciais do HubSpot (recuperando formulários e, em seguida, envios) são mostradas como uma única troca para clareza. As chamadas de autenticação e enriquecimento do ZoomInfo são mostradas como nós separados porque utilizam 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 do 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 um complemento de licença
Endpoints suportados
O agente de IA se conecta aos seguintes serviços externos. Você pode acomodar outros sistemas modificando as configurações de endpoint e fluxos de trabalho do projeto.
HubSpot
O agente utiliza a API do HubSpot para recuperar definições de formulários e registros de envios. Você deve ter uma conta do HubSpot com acesso à API e uma chave de API válida.
Salesforce
O agente utiliza a API REST do Salesforce para consultar e atualizar registros de leads. Você deve ter uma conta do Salesforce com credenciais que tenham permissão para ler e escrever objetos Lead.
ZoomInfo
O agente utiliza a API do ZoomInfo para enriquecer dados de leads. Você deve ter uma conta do ZoomInfo com um ID de cliente e um segredo de cliente que tenham permissão para chamar a API de enriquecimento.
Serviço de notificação
O agente utiliza o Slack para enviar notificações de sucesso e erro. Você deve 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 fluxos de trabalho ao esquema exigido pelo serviço escolhido.
Instalação, configuração e operação
Siga estas etapas para instalar, configurar e operar este agente de IA:
- Baixar e instalar o projeto
- Configurar variáveis do projeto
- Testar conexões
- Implantar o projeto
- Revisar fluxos de trabalho do projeto
- Acionar os fluxos de trabalho do projeto
Para orientações de solução de problemas, consulte Solução de Problemas.
Baixar e instalar o projeto
Siga estas etapas para baixar e instalar o projeto Studio para o agente de IA:
-
Faça login no portal Harmony em https://login.jitterbit.com e abra o Marketplace.
-
Localize o agente de IA chamado Jitterbit Lead Ops Agent. Para localizar o agente, use a barra de pesquisa ou, no painel Filtros sob Tipo, selecione Agente de IA para limitar a exibição aos agentes de IA.
-
Clique no link Documentação do agente de IA para abrir sua documentação em uma nova aba. Mantenha a aba aberta para referência.
-
Clique em Iniciar Projeto para abrir um diálogo de configuração em duas etapas para importar o agente de IA como um projeto Studio.
Nota
Se você ainda não adquiriu o agente de IA, Obter este agente é exibido em vez disso. Clique nele para abrir um diálogo informativo, em seguida, clique em Enviar para que um representante entre em contato com você sobre a compra do agente de IA.
-
Na etapa de configuração 2, Criar um Novo Projeto, selecione um ambiente onde o projeto Studio será criado, em seguida, clique em Criar Projeto.
-
Um diálogo de progresso é exibido. Assim que indicar que o projeto foi criado, use o link do diálogo Ir para o Studio ou abra o projeto diretamente na página Projetos do Studio.
Configurar variáveis do projeto
No projeto Studio instalado a partir do Marketplace, você deve definir valores para as seguintes variáveis do projeto.
Para configurar variáveis de projeto, use o menu de ações da barra de ferramentas do projeto para selecionar Variáveis de Projeto 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 da API usada para autenticar chamadas da API do 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 do cliente usado para autenticar chamadas da API do ZoomInfo. |
ZoomInfo_Client_Secret |
Segredo do cliente usado para autenticar chamadas da API do ZoomInfo. |
Slack
| Nome da variável | Descrição |
|---|---|
Slack_Webhook_URL |
URL do Webhook para o canal do Slack onde as notificações são enviadas. |
Testar conexões
Teste as configurações de endpoint para verificar a conectividade usando os valores de variáveis de projeto que você configurou.
Para testar conexões, vá para a aba Endpoints e Conectores do Projeto na paleta de componentes de design , passe o mouse sobre cada endpoint e clique em Testar.
Implantar o projeto
Implemente o projeto do Studio.
Para implantar o projeto, use o menu de ações da barra de ferramentas do projeto para selecionar Implantar.
Revisar fluxos de trabalho do projeto
Cada fluxo de trabalho desempenha uma função específica no fluxo de dados entre HubSpot, ZoomInfo e Salesforce.
| Workflow | Descrição |
|---|---|
| HubSpot Forms Data Extraction | Recupera os formulários disponíveis do HubSpot. |
| Form Submission Processing | Busca e transforma os dados de envio do formulário. |
| Salesforce Lead Lookup | Consulta o Salesforce para encontrar um lead correspondente pelo endereço de email. |
| Salesforce Lead Update | Atualiza ou insere os dados de envio do HubSpot no lead correspondente do Salesforce. |
| ZoomInfo Authentication | Autentica-se com o ZoomInfo para recuperar um token JWT. |
| Token Extraction | Extrai o token JWT da resposta de autenticação do ZoomInfo. |
| Data Enrichment via ZoomInfo | Envia dados do lead para o ZoomInfo e recupera informações enriquecidas. |
| Post-Enrichment Salesforce Update | Escreve os dados enriquecidos do ZoomInfo de volta no Salesforce. |
| Success Slack Notification | Envia uma notificação de sucesso para o canal Slack configurado. |
HubSpot Forms Data Extraction
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 estão configuradas para serem executadas a cada hora usando agendas de operação. O fluxo de trabalho filtra e prepara os dados do formulário para uso no seguinte fluxo de processamento de envio.
Form Submission Processing
Este fluxo de trabalho recupera os registros de envio para cada formulário obtido no fluxo de trabalho anterior. O fluxo de trabalho converte os dados de envio do HubSpot no formato de integração necessário e armazena a carga útil transformada para uso no fluxo de trabalho de consulta de lead do Salesforce.
Salesforce Lead Lookup
Este fluxo de trabalho consulta o objeto Lead do Salesforce usando o endereço de email de envio como a 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 subsequente de atualização de lead.
Atualização de Lead do Salesforce
Este fluxo de trabalho mapeia os campos de submissão do HubSpot para os campos de lead do Salesforce e realiza 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-se 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 do 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 lead atualizados do Salesforce 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 todos os fluxos de trabalho serem concluídos com sucesso. A notificação inclui o nome da operação, o timestamp de execução e o status da integração.
Acionar os fluxos de trabalho do projeto
O agente é executado automaticamente em uma programação horária. Você também pode acionar 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 da programação, abra o menu de ações da operação agendada e selecione Configurações > Programações.
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 da execução
- Status da integração
Solução de Problemas
Se você encontrar problemas, revise os seguintes recursos para obter informações detalhadas sobre solução de problemas:
Para assistência adicional, entre em contato com o suporte do Jitterbit.