Instalando a extensão do pacote de integração do gerenciador de transações do Salesforce

Para usar o Gerenciador de transações com o Salesforce, você deve primeiro seguir estas etapas para instalar e configurar a Extensão do pacote de integração do Gerenciador de transações do Salesforce.

Pré-requisitos

Este guia presume que você CPQ O ambiente está integrado a uma organização do Salesforce e esse Gerenciador de transações está habilitado. Se sua organização do Salesforce não tiver CPQ pacotes instalados, instale a versão 2,7 ou posterior do CPQ Pacote gerenciado. Para obter instruções, consulte Guia de instalação e configuração para ambientes vinculados a organizações do Salesforce.

Nota:

CPQ O Gerenciador de transações não tem dependências no Salesforce CPQ. Você pode ignorar todas as etapas ou referências específicas ao Salesforce CPQ.

Envie um tíquete de suporte solicitando que o Gerenciador de transações seja ativado em seu CPQ ambiente.

Sobre o. CPQ Extensão do Gerenciador de transações

. CPQ A extensão do gerenciador de transações é um pacote de componentes que os administradores do Salesforce instalam em seu ambiente do Salesforce para facilitar a integração entre o Salesforce e. CPQ Gerenciador de transações.

Entre em contato com o suporte ao cliente da ServiceNow para obter informações sobre a versão mais recente e como acessar o pacote gerenciado para instalação.

Os administradores podem instalar o pacote somente para administradores, para todos os usuários ou para perfis específicos. O pacote inclui conjuntos de permissões para o Gerenciador de transações que podem ser atribuídos a indivíduos ou replicados em perfis. Para exibir os conjuntos de permissões, em Configuração, acesse Usuários e, em seguida, consulte Logik.ai Acesso total opção em Conjuntos de permissões .

Depois de instalado, você pode exibir a versão do pacote no Pacotes Instalados Configuração do Salesforce.

Salesforce: Habilite campos de endereço personalizados

O ambiente do Salesforce deve ter Campos de endereço personalizados habilitados. Se este recurso não estiver habilitado, consulte este artigo para obter mais informações: Habilite os campos de endereço personalizado

Salesforce: Permitir exceções de segurança para CPQ

Adicionar URLs confiáveis:

1. Na página inicial de configuração do Salesforce, acesse Configurações > Segurança > URLs confiáveis. Crie um novo URL confiável.
2. Forneça um nome de API.
3. Insira o URL do CPQ ambiente, conforme mostrado abaixo.

   

4. De acordo com as Diretivas de CSP, certifique-se de que pelo menos frame-src (conteúdo do iframe) está habilitado e clique em Salvar .

   

Defina as configurações do local remoto:

1. Na página inicial de configuração do Salesforce, acesse Configurações > Segurança > Configurações de local remoto. Crie um novo local remoto.
2. Forneça um nome.
3. Insira o URL do CPQ conforme mostrado na imagem abaixo, e clique em Salvar .

   

Opcionalmente, permita o acesso ao microfone para o Cosmo Converse (atualmente em beta). O Cosmo Converse permite que o usuário se comunique por voz com o Gerenciador de transações. Por padrão, este recurso não está habilitado. Para usar o Cosmo Converse, envie um tíquete de suporte que descreva seu caso de uso. Para se preparar para o Cosmo Converse, atualize as configurações do Salesforce para permitir o acesso ao microfone.

1. Na página inicial de configuração, acesse Configurações > Segurança > Configurações de sessões.
2. Em Permissões do recurso do navegador , certifique-se de que a caixa de seleção para Cabeçalho HTTP de política de permissões está desabilitado.
3. Se necessário, clique em Salvar .

CPQ: Configure o token do cliente de tempo de execução

. CPQ O token do cliente de tempo de execução facilita a autenticação das comunicações do Salesforce para CPQ. Para etapas para criar um token de cliente de tempo de execução em CPQ, consulte Configure um cliente de tempo de execução. Para este caso de uso do Gerenciador de transações, habilite as permissões neste cliente de tempo de execução para TRANSAÇÃO e adicione um ID de usuário válido que seja reconhecido pelo ambiente do Salesforce correspondente.

Observe que em CPQ Administrador, o token do cliente de tempo de execução deve ser atualizado para incluir A TRANSAÇÃO em suas permissões e em si mesmo como uma origem. (Por exemplo, o token do cliente de tempo de execução para https://test-txn.test02.logik.io deve ter uma origem de https://test-txn.test02.logik.io .) Além disso, quando um token de cliente de tempo de execução inclui UMA TRANSAÇÃO, um usuário deve ser incluído. Certifique-se de que o usuário tenha permissão para executar o evento Criar transação.

Quando você tiver configurado o token do cliente de tempo de execução, copie-o para a área de transferência local para uso no próximo procedimento.

Instale o. CPQ Token de tempo de execução da transação no Salesforce

1. No Inicializador de apps do Salesforce, pesquise e abra Configurações personalizadas do administrador do Logik.io .
2. Pressione Definido botão ao lado de Token do cliente de tempo de execução campo para habilitá-lo.
3. Cole o token de CPQ no campo editável e clique em Salvar .

Nota:

O token do cliente de tempo de execução não é exibido na página Configurações personalizadas do administrador depois de ser salvo.

Salesforce: Atualize o layout da oportunidade para abrir o Gerenciador de transações

1. No Salesforce, clique no ícone de engrenagem no canto superior direito.
2. Navegar até Configuração > Gerenciador de objetos > Oportunidade > Layouts de página.
3. Selecione o layout da página a ser editado. (Se você tiver vários layouts, escolha aquele associado ao tipo de registro relevante ou aos perfis de usuário.)

   

4. Role para baixo no editor de layout até ver Listas relacionadas seção.

   

5. Arraste o objeto Transações da lista de listas relacionadas disponíveis na paleta superior para a posição desejada no Listas relacionadas seção.

   

6. Clique no ícone de chave inglesa do objeto Transação para abrir as propriedades da lista relacionada.

   

7. Em Campos selecionados , selecione Editar transação do Campos disponíveis coluna. Clique em Adicionar para movê-lo para Campos selecionados coluna. Reorganize os campos conforme necessário e clique em OK para salvar as mudanças. Depois de fazer as mudanças, clique em Salvar no canto superior esquerdo.

   

8. Teste o layout atualizado.

   • Como usuário final (no lado de compra do Salesforce), navegue até um registro de oportunidade.

   • Certifique-se de que a lista relacionada à transação apareça na página e que Editar transação o link está visível e funcional.

Solução de problemas: Se o botão Transação estiver ausente

Se o botão de transação estiver ausente na página de detalhes da oportunidade de compra, siga estas etapas.

1. No canto superior direito da página, clique no ícone de engrenagem e, em seguida, clique em Editar página . Isso abre o Construtor de apps do Lightning para a página de registro de oportunidade.

   

2. Selecione o componente Listas relacionadas da página. Em Atribuir layouts de página localize o nome do layout de página atribuído no momento. (Na imagem, o layout correto é indicado com a palavra "(visualizado).")

   

3. Clique no layout visualizado e repita as etapas de 4 a 7 na seção "Salesforce: Atualizar o layout da oportunidade para abrir o Gerenciador de transações" (acima). Em seguida, no lado de compra, navegue até um registro de oportunidade. Verifique o. Listas relacionadas para confirmar que o objeto de transação é exibido. Clique na seta e crie uma nova transação para validar essa Editar transação (EditLink__c) o campo está disponível.

   

   

Salesforce: Configure mapeamentos de campo personalizados

Quando um novo CPQ o registro de transação foi iniciado em CPQ, Pode ser útil transferir dados essenciais do registro de transação do Salesforce. Esta seção configura mapeamentos de campo que copiam (ou "gêmeos") informações de um campo no Salesforce para um campo no CPQ ou vice-versa, durante o fluxo de criação da transação. Como exemplo, é comum que o administrador dê o dobro do valor mantido LGK__OpportunityId__cpara o correspondente CPQ campo de transação, txn.opportunity.id.

1. No Salesforce, vá para Configuração.
2. Na barra de Localização rápida, pesquise Tipos de metadados personalizados .
3. Nos resultados da pesquisa, em Código personalizado, clique em Metadados personalizados .

   

4. Para acessar os mapeamentos de campo existentes, localize Mapeamento do campo de transação Logik.io na lista de tipos de metadados personalizados e clique em Gerenciar registros link ao lado dele.

   

5. Clique em Novo , preencha os detalhes necessários e clique em Salvar .

   Campos de origem:

   • Ambiente: Escolha a origem do valor do campo:

     • Selecione Salesforce Para campos originados no Salesforce.

     • Selecione Logik para campos originados em CPQ.

   • Objeto: Insira Transação .
   • Campo: Especifique o nome do campo.

     • Para campos do Salesforce, inclua o. __c sufixo (por exemplo, CustomField__c ). Revise os nomes exatos dos campos de Salesforce > Configuração > Gerenciador de objetos > Transação > Campos e relacionamentos.

       

     • Para CPQ campos, incluem prefixos como transf. ou txn.linha. para denotar o campo (por exemplo, Valor total.txn ). Certifique-se de usar os nomes exatos das variáveis de campo de Administrador > Transação > Campos associados.

       

   Campos de destino:

   • Ambiente: Indique onde o valor do campo deve ser atualizado (Salesforce ou CPQ).
   • Campo: Insira o nome do campo do destino no mesmo formato (por exemplo, campos do Salesforce com __c ou CPQ campos com transf. prefixos).

     

Nota:

• Um registro de mapeamento de campo é incluído como referência. Isso não pode ser excluído, mas os detalhes de origem e destino podem ser editados. Verifique se o registro de campo personalizado adicionado corresponde a ele.
• Se você estiver desinstalando o pacote gerenciado, todos os registros criados para novos campos personalizados deverão ser excluídos primeiro.

Salesforce: Ative a linha de transação para sincronização de linha de oportunidade e fluxos de ativos

Nota:

Por padrão, os seguintes fluxos estão ativos:

• Transação de cópia Logik.ai
• Logik.ai Criar transação (gatilho de registro)
• Logik.ai Criar transação (tela)

1. Na página inicial de configuração do Salesforce, pesquise "Fluxos". Clique Automação de Processo > Fluxos.

2. Procure o seguinte. Você executará a etapa 3 para cada:

   • Sincronização de linha de oportunidade do Logik.io (upsert)
   • Sincronização de linha de oportunidade do Logik.io (Excluir)
   • Mudança de transação primária do Logik.io
3. Para cada um dos três fluxos identificados na etapa 2, ative uma das seguintes opções:
   • Opção 1: Usando o menu suspenso:
     • Clique na seta à direita do nome do fluxo.

       

     • Selecione Exibir detalhes e versões .
     • Clique em Ativar para a versão mais recente do fluxo.

       

   • Opção 2: Abrir o fluxo:
     • Clique no nome do fluxo para abri-lo no Construtor de fluxo.

       

     • Clique em Ativar No canto superior direito do Construtor de fluxo.

       

Certifique-se de que todos os fluxos estejam no status ativo.

Nota:

A sincronização de linha de oportunidade é aplicada somente à transação atribuída ao campo Oportunidade de transação primária.

Fluxo do usuário final: Iniciando um CPQ Transação da Salesforce

• Crie um registro de transação no Salesforce

  Há várias maneiras de o usuário final iniciar um CPQ Transação no Salesforce. O fluxo mais comum começa no registro de oportunidade.

  1. Em um registro de oportunidade, clique na seta na lista relacionada da transação e clique em Novo .

     

  2. Uma nova transação é aberta com Oportunidade campo preenchido. Preencha Conta , Contato primário e todos os campos opcionais. Clique em Salvar.

     

  3. Um fluxo acionado por registro no pacote gerenciado cria uma nova transação em CPQ. O UUID do novo CPQ Atualizações de registro de transação no Salesforce ( LGK__TransactionUUID__c). Se o ID da transação não aparecer imediatamente, atualizar o navegador geralmente corrige a anomalia.

     

     . ID da transação O campo permanece vazio após uma atualização do navegador. Consulte a seção Solução de problemas abaixo.

• Edite uma transação

  Em uma transação do Salesforce (ou uma lista relacionada a transações), o Gerenciador de transações pode ser iniciado usando o. Editar transação botão na página de detalhes da transação ou no link disponível por meio do Editar transação campo. Isso carrega um CPQ transação baseada em ID da transação No registro do Salesforce.

  O Gerenciador de transações é carregado em um iFrame, substituindo a subguia atual no Salesforce.

  Nota:

  A IU clássica do Salesforce não é compatível.
• Copiar transação

  Clicando em Clone No registro de transação do Salesforce, os usuários podem chamar um CPQ Copie o evento para recriar a transação e as linhas no Gerenciador de transações. Esta ação é baseada no ID da transação no registro de cabeçalho no Salesforce e resulta em um registro de transação clonado.

  Nota:

  A clonagem de uma transação do Salesforce não faz cópias automaticamente dos registros de linha afiliados para as novas transações. Para clonar as linhas para a nova transação, inicie o novo registro de transação (clonado) no Gerenciador de transações e inicie uma sincronização do Salesforce.

Solução de problemas: CPQ Falha ao iniciar com um erro "Não foi possível encontrar a transação com ID "nulo"

Este erro ocorre quando a criação de um novo CPQ O registro de transação é iniciado por meio de uma chamada de API do Salesforce e falha. Essa falha geralmente ocorre devido a um de dois motivos:

• O token de tempo de execução da transação está configurado incorretamente ou expirou. Revise as etapas na seção " CPQ: Configurar o token do cliente de tempo de execução" acima.
• O usuário que está criando o. CPQ O registro de transação da IU do Salesforce não tem permissão para fazer isso.

Para solucionar erros de permissões, siga estas etapas.

1. Em Administração de transações, clique em Personas .
2. Na lista de personas, observe qual persona é rotulada COMO PADRÃO. A captura de tela abaixo mostra que "Representante de vendas" é a persona padrão. Por padrão, todos os novos usuários recebem esta persona.

   

3. Abra cada registro de persona. Encontre seu nome de usuário. O usuário que você está depurando só deve estar visível em uma persona. Depois de encontrar a persona apropriada, observe a exibição que gerencia o acesso dessa persona. No exemplo, o usuário está entre os nomes de usuário listados na persona do representante de vendas. O acesso desta persona é gerenciado pela exibição "vendas".

   

4. Abra a exibição que gerencia o acesso da persona. Em nosso exemplo, a exibição é chamada "vendas". Para abrir a exibição, em CPQ Página inicial do administrador de transações, acesse Exibições e clique na exibição de gerenciamento.

   

5. Na página de detalhes da exibição, clique em Acesso , clique em Eventos e pesquise por CriarTransação . Na fase inicial, o evento Criar transação (varname: CreateTransaction) deve ser definido como Ativo .

   

Para resumir: Para um determinado usuário, o administrador deve gerenciar os itens na tabela a seguir.

Ocorrência	Correção
Atribuição de persona do usuário	Navegue até Personas em CPQ Administrador de transações e selecione um registro de persona. Para adicionar um usuário a uma persona, clique em Associe usuários . Para remover um usuário de uma persona, selecione um nome de usuário e clique em Remover selecionados .
Atribuição de exibição de persona	Em CPQ Administrador de transações, acesse Exibições , selecione um registro de exibição e clique em Personas associadas .
Exibição: Acesso a cada evento, por fase	Para obter informações sobre como executar a administração de acesso refinada (recomendado), consulte a seção Arquivo CSV de eventos em Gerenciador de transações: Exibições. Para administrar o acesso de maneira menos precisa, acesse Eventos em CPQ Administrador de transações, clique em Criar transação evento, clique em Editar acesso ao evento E defina o acesso ao evento como Ativo. Por padrão, o evento está ativo em todas as fases e exibições.