Agente de Contato CRM Jitterbit

Visão Geral

O Jitterbit fornece o Agente de Contato CRM aos clientes através do Jitterbit Marketplace. Este agente utiliza IA para gerenciar registros de contato para sistemas de CRM, como Salesforce, por meio de uma interface conversacional, ajudando as equipes de vendas a encontrar, criar e atualizar contatos de forma mais eficiente. Este agente utiliza a técnica de Geração Aumentada por Recuperação (RAG), que combina o raciocínio de LLM com acesso a ferramentas externas e fontes de dados.

O agente recebe solicitações em linguagem natural através do Slack e determina a intenção do usuário usando Azure OpenAI. Com base em cada solicitação, o agente pesquisa no Salesforce por contatos existentes, recupera dados de contato do ZoomInfo e realiza operações de criação ou atualização no Salesforce mediante aprovação do usuário. O agente mantém o histórico de conversas no Jitterbit Cloud Datastore para fornecer respostas contextualizadas ao longo de uma sessão.

O agente realiza as seguintes tarefas:

• Recebe solicitações em linguagem natural dos usuários através do Slack.
• Usa o Azure OpenAI para extrair o nome da conta e determinar a intenção de cada solicitação.
• Pesquisa no Salesforce por contatos existentes associados à conta especificada.
• Consulta o ZoomInfo para dados de contato que ainda não estão no Salesforce, incluindo cargos, números de telefone e endereços de email.
• Compara os registros de contato do Salesforce com os dados do ZoomInfo para identificar informações desatualizadas ou ausentes.
• Apresenta listas de contatos e recomendações de atualização ao usuário no Slack para aprovação antes de fazer quaisquer alterações no Salesforce.
• Cria ou atualiza registros de contato no Salesforce mediante aprovação do usuário.
• Armazena o histórico de conversas no Cloud Datastore para manter o contexto entre as mensagens dentro de uma janela de sessão de 30 minutos.
• Envia notificações no Slack para um canal de alertas de vendas configurado quando um contato é identificado como não mais pertencente à empresa.

Este documento explica como configurar e operar este agente de IA. Ele abrange arquitetura e pré-requisitos, orientações sobre como solicitar ao agente e etapas para instalar, configurar e operar o agente de IA.

Arquitetura do agente de IA

Este agente de IA gerencia contatos do Salesforce através de uma interface conversacional no Slack. Uma interação típica segue estas etapas:

1. Um usuário envia uma mensagem em linguagem natural para o Agente de Contato CRM através do Slack.
2. O agente recupera o histórico da conversa do Cloud Datastore para manter o contexto da sessão, em seguida, chama o Azure OpenAI para extrair o nome da conta da solicitação.
3. O agente consulta o Salesforce para validar o nome da conta e recuperar o ID da conta do Salesforce.
4. O agente chama o Azure OpenAI uma segunda vez, com as ferramentas disponíveis, para determinar a intenção do usuário e selecionar a ferramenta apropriada para executar.
5. A ferramenta selecionada consulta o Salesforce e o ZoomInfo conforme necessário para coletar dados de contato.
6. Para operações que criam ou atualizam contatos, o agente apresenta um resumo ao usuário no Slack e aguarda aprovação antes de tomar uma ação no Salesforce.
7. O agente chama o Azure OpenAI sem ferramentas para formatar a resposta final usando um prompt específico do contexto, em seguida, publica a resposta de volta ao usuário no Slack.
8. O histórico da conversa é salvo no Cloud Datastore para uso em mensagens subsequentes dentro da mesma sessão.

Diagrama de fluxo de trabalho

O diagrama a seguir mostra o principal fluxo de trabalho de manipulação de solicitações para o Agente de Contato CRM.

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 Cloud Datastore para armazenar o histórico da conversa e os dados de preparação de contatos.
• Agente de Contato CRM Jitterbit adquirido como um complemento de licença.

Endpoints suportados

O agente de IA se conecta aos seguintes endpoints. Você pode acomodar outros sistemas modificando as configurações de endpoint e fluxos de trabalho do projeto.

Modelo de linguagem grande (LLM)

O agente de IA usa Azure OpenAI como o provedor de LLM. Para usar o Azure OpenAI, você deve ter uma assinatura do Microsoft Azure com permissões para criar um recurso do Azure OpenAI com um modelo implantado.

Sistema CRM

O agente consulta e atualiza registros de contato no Salesforce. Para usar o Salesforce, você deve ter uma conta do Salesforce com acesso à API e permissões para ler e escrever registros de contato.

Provedor de dados de contato

O agente recupera dados de contato do ZoomInfo para complementar os registros existentes do Salesforce. Para usar o ZoomInfo, você deve ter uma conta do ZoomInfo com credenciais de acesso à API.

Plataforma de mensagens

O agente usa o Slack como sua interface de conversação e canal de notificações. Para usar o Slack, você deve ter um espaço de trabalho do Slack com um aplicativo Slack configurado para receber e responder a mensagens. Para instruções detalhadas sobre como criar um aplicativo Slack, consulte Criar um aplicativo Slack.

Solicitações do agente

O Agente de Contato CRM recebe todas as solicitações como mensagens em linguagem natural enviadas para o aplicativo Slack. Esta seção descreve as regras para solicitações eficazes e fornece exemplos de solicitações.

Diretrizes de solicitação

Siga estas diretrizes ao enviar mensagens para o agente:

• Inclua o nome da conta em cada solicitação. O LLM tenta inferir o nome da conta a partir do histórico de conversas (limpo a cada 30 minutos), mas incluí-lo explicitamente em cada mensagem produz resultados mais confiáveis.

• Para criar novos contatos, você deve primeiro pedir ao agente para encontrá-los usando uma solicitação de Novos contatos. O agente apresenta uma lista de contatos para aprovação antes de criar registros no Salesforce.

• Para atualizar contatos existentes, você deve primeiro executar uma verificação de atualização usando uma solicitação de Higiene de dados e atualizações. O agente apresenta recomendações de atualização para sua aprovação antes de escrever as alterações no Salesforce.

Exemplos de solicitações

Os seguintes exemplos de solicitações mostram os tipos de solicitações que o agente pode lidar. Substitua {Account Name} pelo nome da conta do Salesforce e {list of roles} por uma lista de títulos de trabalho relevantes separados por vírgulas.

Novos contatos

Use estes comandos para encontrar e criar novos contatos para uma conta usando dados do ZoomInfo:

Higiene de dados e atualizações

Use estes comandos para identificar dados de contato desatualizados ou ausentes e aplicar atualizações:

Contatos existentes

Use estes comandos para pesquisar e relatar contatos já no Salesforce:

Comandos de acesso especial

Os seguintes comandos requerem acesso de nível administrador, conforme configurado no script set.user.roles. Essas operações consomem créditos do ZoomInfo da sua cota de conta:

Instalação, configuração e operação

Siga estas etapas para instalar, configurar e operar este agente de IA:

1. Baixar e instalar o projeto
2. Criar recursos do Microsoft Azure
3. Criar o aplicativo Slack
4. Configurar o Cloud Datastore
5. Configurar variáveis do projeto
6. Testar conexões
7. Implantar o projeto
8. Revisar fluxos de trabalho do projeto
9. 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 instalar o projeto do Studio para o agente de IA:

1. Faça login no portal Harmony em https://login.jitterbit.com e abra o Marketplace.

2. Localize o agente de IA chamado Jitterbit CRM Contact 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 a agentes de IA.

3. Clique no link Documentação do agente para abrir sua documentação em uma nova aba. Mantenha a aba aberta para consultar depois de iniciar o projeto.

4. Clique em Iniciar Projeto para abrir uma caixa de diálogo de configuração em duas etapas.

   Nota

   Se você ainda não comprou o agente de IA, Obter este agente é exibido em vez disso. Clique nele para abrir uma caixa de diálogo informativa e, em seguida, clique em Enviar para que um representante entre em contato com você sobre a compra do agente de IA.

5. Na etapa de configuração 1, Baixar Personalizações, baixe quaisquer arquivos de configuração fornecidos.

6. Clique em Próximo.

7. Na etapa de configuração 2, Criar um Novo Projeto, selecione um ambiente onde o projeto do Studio será criado e, em seguida, clique em Criar Projeto.

8. Após a caixa de diálogo de progresso indicar que o projeto foi criado, use o link da caixa de diálogo Ir para o Studio ou abra o projeto diretamente na página Projetos do Studio.

Criar recursos do Microsoft Azure

Crie os seguintes recursos do Microsoft Azure e anote as informações para configurar o agente de IA. Para criar e gerenciar esses recursos, você deve ter uma assinatura do Microsoft Azure com as permissões apropriadas.

Você deve criar um recurso do Azure OpenAI e implantar um modelo através do portal do Azure AI Foundry.

Observe o nome da implantação, a URL do endpoint e a chave da API. Insira esses valores ao configurar variáveis do projeto.

Para encontrar esses valores, siga estas etapas:

1. No portal do Azure AI Foundry, abra o recurso OpenAI específico.

2. Na página de início do recurso, copie a URL do endpoint (para a variável do projeto Openai.token) e a chave da API.

3. No menu de navegação em Recursos compartilhados, selecione Implantações. Copie o nome da implantação (para a variável do projeto Openai.model).

Criar o aplicativo Slack

Para habilitar a interface do Slack do agente, siga estas etapas:

1. Crie um aplicativo Slack e instale-o em seu espaço de trabalho Slack.

2. Obtenha o token do bot e mantenha-o para a variável do projeto Slack.token.

3. Identifique o canal Slack onde o agente responderá às mensagens dos usuários e mantenha-o para a variável do projeto Slack.channel.

4. Identifique o canal Slack designado para receber notificações do executivo de contas e mantenha-o para a variável do projeto salesforce.sales.alerts.channel.

Configurar o Cloud Datastore

O agente utiliza três armazenamentos de chave do Cloud Datastore para gerenciar o histórico de conversas e os dados de estágio de contato:

Para cada armazenamento de chave, siga estas etapas:

1. Crie o armazenamento de chave com o nome e os campos personalizados especificados abaixo.
2. Na aba Componentes do projeto Studio em Endpoints, localize cada atividade do Cloud Datastore associada a esse armazenamento. Cada atividade é prefixada com o nome do armazenamento de chave (por exemplo, CACHE DE CONTATOS - Excluir Itens Cache CDS). Clique duas vezes para abri-la, atribua o nome do armazenamento e salve.

Agente Slack AI

Crie um armazenamento de chave chamado Agente Slack AI e adicione os seguintes campos personalizados:

• system_content_big (texto grande)
• created_on (texto)
• slack_channel_id (texto)
• user_content (texto)

Use este armazenamento para todas as atividades do Cloud Datastore prefixadas com SLACK AGENT AI.

Cache de Contato

Crie um armazenamento de chave chamado Cache de Contato e adicione os seguintes campos personalizados:

• create_or_update (texto)
• jsonbody (texto grande)
• contactbody (texto grande)

Use este armazenamento para todas as atividades do Cloud Datastore prefixadas com CONTACT CACHE.

Custo de Token LLM

Crie um armazenamento de chave chamado Custo de Token LLM e adicione os seguintes campos personalizados:

• total_tokens (texto)
• prompt_tokens (texto)
• completion_tokens (texto)
• createdDate (texto)
• content (texto grande)

Use este armazenamento para todas as atividades do Cloud Datastore prefixadas com LLM TOKEN COST.

Configurar variáveis do projeto

No projeto do Studio instalado a partir do Marketplace, defina valores para as seguintes variáveis do projeto.

Para configurar variáveis do projeto, use o menu de ações do projeto e selecione Variáveis do Projeto para abrir o painel de configuração.

ZoomInfo

Salesforce

Slack

Azure OpenAI

Cloud Datastore

Configurações de conversa

Testar conexões

Teste as configurações de endpoint para verificar a conectividade usando os valores de variáveis de projeto definidos.

Para testar conexões, vá para a aba Endpoints e conectores do projeto no painel 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 de ações do projeto e selecione Implantar.

Criar a API personalizada do Jitterbit

Crie uma API personalizada usando a opção Publicar como uma API para a operação Receiver - Slack API request handler no fluxo de trabalho Main Entry - Slack API Request Handler.

Configure estas definições para o serviço:

Após configurar o serviço, publique a API personalizada.

Copie a URL do serviço da API. Para encontrar a URL do serviço, vá até o painel de detalhes da API na aba Serviços, passe o mouse sobre a coluna Ações do serviço e clique em Copiar URL do serviço da API.

Na configuração do seu aplicativo Slack, navegue até Recursos > Assinaturas de Eventos e habilite os eventos. Em seguida, cole a URL do serviço da API no campo URL de Solicitação. O Slack enviará uma solicitação com um parâmetro challenge. Assim que o Slack confirmar que a URL é válida, clique em Salvar Alterações.

Revisar fluxos de trabalho do projeto

O projeto Studio contém 18 fluxos de trabalho que implementam a funcionalidade do Agente de Contato CRM, organizados em cinco grupos funcionais.

Ponto de entrada

Entrada Principal - Manipulador de Solicitações da API Slack

Este fluxo de trabalho recebe mensagens do Slack e executa o script do controlador principal (controller.receiver.async). O controlador orquestra todo o processo de manipulação de solicitações: recupera o histórico de conversas do Cloud Datastore, chama o Azure OpenAI para extrair o nome da conta e determinar a intenção, roteia a solicitação para a ferramenta apropriada, formata a resposta do LLM e publica o resultado de volta para o usuário do Slack.

Integrações de API

API - Slack Handler

Este fluxo de trabalho contém todas as operações da API do Slack usadas pelo agente, incluindo a consulta ao perfil do usuário no Slack, a postagem de um indicador de "digitando...", a postagem da resposta final e a exclusão do indicador de digitação após o envio da resposta.

API - Azure Open AI

Este fluxo de trabalho contém dois tipos de chamadas da API Azure OpenAI:

• Open AI - Prompt HTTP Com Ferramentas: Envia uma solicitação para o Azure OpenAI com uma lista de ferramentas disponíveis. Esta chamada é usada para extrair o nome da conta da mensagem do usuário e para determinar a intenção da solicitação.
• Open AI - Prompt HTTP Sem Ferramentas: Envia uma solicitação para o Azure OpenAI sem ferramentas, após a ferramenta selecionada ter reunido todos os dados necessários. Esta chamada gera a resposta final pronta para o Slack usando um prompt específico para o contexto.

As duas chamadas usam históricos de conversa separados. A chamada de determinação de intenção usa o histórico específico da conta, enquanto a chamada de extração do nome da conta usa o histórico completo da conversa. Essa separação mantém o contexto enviado ao LLM focado e reduz o uso desnecessário de tokens.

API - Zoom Info

Este fluxo de trabalho abriga todas as operações da API do ZoomInfo. As operações são organizadas por tipo de dado em vez de por ferramenta, tornando-as reutilizáveis em várias ferramentas. Todas as operações do ZoomInfo exigem que você defina a variável de projeto core.zoom.resource para um valor válido. Os valores válidos a partir de março de 2026 são contact, authenticate, enrich_contact e scoop.

O script core. Load Zoom API Resource centraliza todas as URLs base da API e objetos da web, facilitando a troca para um provedor de dados de contato diferente, se necessário. Todas as chamadas de dados de contato compartilham a atividade padrão de POST do ZoomInfo. A chamada de autenticação usa uma atividade separada.

Memória e estado

Memória - Cloud Datastore

Este fluxo de trabalho gerencia quatro tipos de operações do Cloud Datastore distribuídas em três armazenamentos do Cloud Datastore:

• Obter Histórico de Slack Específico da Conta: Recupera o histórico de conversas para uma conta específica do Salesforce, fornecendo ao LLM um contexto focado relevante para a solicitação atual.
• Obter Histórico Completo do Slack: Recupera o histórico completo de conversas para o usuário do Slack. O agente usa isso apenas ao chamar o LLM para extrair o nome da conta.
• Controlador de Última Mensagem em Cache: Armazena dados de contato logo antes que uma ação de criação ou atualização seja aprovada. O agente chaveia os dados por uma combinação do ID do usuário do Slack e do ID da conta do Salesforce, garantindo que a lista de contatos correta seja referenciada quando o usuário aprova uma ação. Se a chave armazenada no cache não corresponder à conta atualmente referenciada, o agente relata uma discrepância e não prossegue.
• Armazenar Custos de Token em Cache: Registra o uso de tokens de cada chamada à API do Azure OpenAI para revisão do cliente e relatórios de custos.

Controlador de Limpeza de Conversas

Este fluxo de trabalho remove o histórico de conversas que excede o limite de cleanup.historytime. Quando o LLM recebe mais dados de conversação do que pode processar efetivamente, pode não ser capaz de determinar a intenção da solicitação atual. Nesse caso, o agente reduz a janela de histórico para 10 minutos e pede ao usuário para reenviar o prompt.

Gerenciador de Tarefas do Agendador

Este fluxo de trabalho gerencia quaisquer operações configuradas para serem executadas em agendas de operações.

Duas operações têm requisitos específicos de agendamento:

• Controlador de Limpeza de Conversas: Agendar para ser executado pelo menos a cada 5 minutos. Isso controla quão de perto a retenção real corresponde ao limite de cleanup.historytime. Quanto menos frequentemente for executado, mais tempo o histórico pode permanecer além do limite configurado.

• Notificações de Executivos de Conta: Agendar para ser executado uma vez por dia. A consulta padrão é limitada aos dados daquele dia, portanto, executá-la mais de uma vez retorna duplicatas.

Para configurar um cronograma, abra o menu de ações da operação e selecione Configurações > Cronogramas.

Utilitários

Ferramentas de Utilidade

Este fluxo de trabalho contém scripts de utilidade reutilizáveis que podem ser chamados em vários fluxos de trabalho de ferramentas:

• Utility- Get Account id from Salesforce: Procura um ID de conta do Salesforce pelo nome da conta.
• Utility- Check for Email COMs by Name: Pesquisa no Salesforce por conversas de email pelo nome do contato e domínio. Requer que um nome de contato e domínio sejam definidos como argumentos antes que o script seja chamado.
• Utility- Get Number of Contacts for SF Account: Retorna o número de contatos associados a uma conta do Salesforce. Esta utilidade não está atualmente em uso.
• Utility- Check Empty Email Contacts: Itera através de um dicionário de contatos que não têm endereço de email no Salesforce e chama a verificação de comunicações por email para cada um, buscando qualquer atividade de email relacionada.

Supervisor de Ferramentas

Este fluxo de trabalho lê o valor da intenção retornado pelo Azure OpenAI (armazenado na variável de projeto openai.response.route) e usa uma declaração de caso para roteirizar a solicitação para o fluxo de trabalho de ferramenta apropriado. Se um nome de conta for encontrado, mas nenhuma rota puder ser determinada (tipicamente devido a um longo histórico de conversas), o agente limpa o histórico e pede ao usuário para reenviar o prompt.

Ferramentas do Agente

Buscar Contato Existente

Este fluxo de trabalho recupera todos os contatos de uma conta especificada do Salesforce. O nome do script é search_existing_contact - controller. O fluxo de trabalho armazena os dados de contato em salesforce.response.body, escreve-os em $tool.response para processamento LLM e define a verificação de resposta para master_prompt.

Buscar Novos Contatos

Este fluxo de trabalho recupera dados de contato do ZoomInfo para uma conta especificada. O nome do script é search_new_contact Controller. O fluxo de trabalho faz uma chamada à API do ZoomInfo para cada cargo configurado na variável de projeto $zoom.query_jobTitle. Limite essa variável a quatro ou cinco funções para manter os tempos de resposta aceitáveis.

O fluxo de trabalho primeiro executa uma busca aberta sem filtros de função para recuperar uma lista de contatos irrestrita, e então faz chamadas específicas para cada função. O fluxo de trabalho mapeia os resultados para um esquema JSON compartilhado (contactdata.json) usado em outras ferramentas. O fluxo de trabalho faz uma referência cruzada de cada novo contato com o Salesforce para verificar se já existe para a conta. A ferramenta também verifica a atividade de email para contatos encontrados através do ZoomInfo usando a utilidade Utility- Check Empty Email Contacts.

Confirmar Criação de Contato

Este fluxo de trabalho recupera a lista de contatos armazenada pelo fluxo de trabalho Buscar Novos Contatos do armazenamento de chave Cloud Datastore Cache de Contatos e a envia para o Azure OpenAI com um prompt confirm_create_contact. O LLM infere endereços de email a partir dos dados disponíveis do Salesforce e apresenta uma lista de contatos estruturada ao usuário no Slack, solicitando aprovação antes de criar os registros. O fluxo de trabalho armazena os dados de contato aprovados de volta no Cache de Contatos para uso no fluxo de trabalho Executar Criação de Contato.

Executar Criação de Contato

Este fluxo de trabalho recupera a lista de contatos aprovados do armazenamento de chave Cloud Datastore Cache de Contatos e compara o ID da conta do Salesforce na chave do cache com a conta atualmente referenciada na conversa. Se os IDs coincidirem, o fluxo de trabalho cria registros de contato no Salesforce usando uma operação de upsert com base no endereço de email. Se houver uma discrepância, o agente notifica o usuário e não prossegue com a criação.

Verificação de Higiene

Este fluxo de trabalho recupera todos os contatos de uma conta do Salesforce e, em seguida, consulta o ZoomInfo para cada contato a fim de identificar discrepâncias de título ou informações ausentes. O fluxo de trabalho adiciona contatos sem um endereço de email no Salesforce a um dicionário e verifica sua atividade de email usando a utilidade Utility- Check Empty Email Contacts. O fluxo de trabalho armazena dados tanto do Salesforce quanto do ZoomInfo em $tool.response e define a verificação de resposta como hygiene_check.

Verificação de Higiene Enriquecida

Este fluxo de trabalho opera de maneira semelhante ao fluxo de trabalho de Verificação de Higiene, mas é restrito a administradores, conforme configurado no script set.user.roles. Este fluxo de trabalho consome créditos do ZoomInfo da sua cota de conta. Este fluxo de trabalho define a verificação de resposta como enriched_hygiene_check.

Notificações de Executivos de Conta

Este fluxo de trabalho envia uma notificação no Slack para o canal configurado em salesforce.sales.alerts.channel quando o agente identifica um contato associado a uma conta conhecida do Salesforce como não mais pertencente àquela empresa.

Confirmar Atualização de Contato

Este fluxo de trabalho recupera todos os contatos da conta do Salesforce especificada e consulta o ZoomInfo para cada contato a fim de verificar se o título mudou. Ele também verifica a atividade de email no Salesforce associada a cada contato. Com base nessas verificações, uma transformação atribui a cada contato uma das três ações recomendadas: recommend_update, recommend_donotupdate ou recommend_delete. O agente apresenta essas recomendações ao usuário para aprovação antes de tomar qualquer ação. Observe que o Agente de Contato do CRM não exclui contatos do Salesforce; a ação recommend_delete indica ao usuário que um contato pode precisar ser removido.

Executar Atualização de Contato

Este fluxo de trabalho recupera dados de atualização aprovados do armazenamento de chave Cloud Datastore do Cache de Contato, verifica se a conta referenciada corresponde ao ID da conta armazenado na chave do cache e, em seguida, aplica as atualizações aprovadas aos registros de contato do Salesforce. O fluxo de trabalho relata o sucesso ou a falha de cada atualização de volta ao usuário no Slack.

Acionar os fluxos de trabalho do projeto

O Agente de Contato do CRM é acionado por mensagens recebidas do aplicativo Slack conectado ao fluxo de trabalho Entrada Principal - Manipulador de Solicitações da API do Slack. Não é necessário executar manualmente uma operação para iniciar o agente; o aplicativo Slack cuida do acionamento automaticamente quando os usuários enviam mensagens.

O fluxo de trabalho Gerenciador de Tarefas do Agendador suporta agendamentos de operações para quaisquer operações que você escolher executar de forma recorrente. Para configurar um agendamento, abra o menu de ações da operação e selecione Configurações > Agendamentos.

Solução de Problemas

Se você encontrar problemas, revise os seguintes logs para obter informações detalhadas de solução de problemas:

• Logs da API
• Logs da operação

Para assistência adicional, entre em contato com o suporte da Jitterbit.