Gerar Salesforce OAuth tokens

Para conectar Salesforce a uma base de conhecimento, você deve fornecer suas credenciais de Salesforce à NiCE Serviços Profissionais ou inseri-las você mesmo em Knowledge Hub. Esta página descreve como criar e configurar um aplicativo conectado em Salesforce e, em seguida, inserir os detalhes de conexão do Salesforce em Knowledge Hub e autenticar a conexão lá. Depois de autenticar, Knowledge Hub gera os tokens necessários automaticamente em segundo plano.

Complete cada uma dessas tarefas na ordem indicada.

Criar e configurar um Aplicativo conectado em Salesforce

Criar um Aplicativo conectado

Na primavera de 2026, Salesforce não permitirá mais que você crie aplicativos conectados. Você poderá continuar usando os aplicativos conectados existentes, mas precisará contatar o Suporte da Salesforce para criar novos. Consulte o anúncio da Salesforce Icon of a square with an arrow pointing out from the top right corner para mais informações.

  1. Faça login no Salesforce usando uma conta com privilégios administrativos.

  2. Clique em Setup Icon of gray gear with a lightning bolt in the center na parte superior direita.

  3. Use a caixa Quick Encontrar para pesquisar App Manager e selecioná-lo nos resultados.

  4. Clique em Novo Aplicativo conectado.

  5. Na janela pop-up que aparece, selecione Criar um Aplicativo conectado e clique em Continuar.

  6. Se aparecer uma mensagem informando que a página não pode ser exibida porque o navegador bloqueia cookies entre domínios, clique em ver esta página no Salesforce Classic.

  7. Enter um Nome do Aplicativo conectado. O nome da API é gerado automaticamente; ele é o Nome do Aplicativo conectado sem espaços.

  8. Em Contact Email, insira um endereço DE e-mail válido ao qual você tenha acesso.

  9. Em API (ativar Configurações de OAuth), selecione ativar Configurações de OAuth e configure os campos exibidos.

    1. Em URL de Retorno de chamada, insira http://localhost:8000.

    2. Em Selected OAuth Scopes, selecione os seguintes Escopos e clique em AddIcon of black right-pointing triangle:

      • Gerenciar dados do usuário por meio de APIs (API)

      • Execute solicitações a qualquer momento (refresh_token, offline_access)

  10. Certifique-se de que as seguintes configurações estejam selecionadas:

    • Exigir Secreto para Fluxo de Servidor Web

    • Exigir Secreto para o Fluxo de Token de Atualização

    • Habilitar Fluxo de Credenciais do cliente

    • Habilitar Fluxo de Código de Autorização e Credenciais

    • Habilitar Fluxo de troca de token

    • Exigir Secreto para Fluxo de Troca de Token

    • Habilitar rotação de Refresh Token

  11. Clique em Salvar.

Copiar e armazenar a Chave do Consumidor e o Secreto do Consumidor

Depois de criar e configurar o aplicativo conectado em Salesforce, o sistema gera as credenciais necessárias para a integração com Knowledge Hub. Em Salesforce, elas são identificadas como Chave do Consumidor e Segredo do Consumidor. Em Knowledge Hub, você deve inserir esses valores como Id DO cliente e Segredo do cliente, respectivamente.

  1. No Salesforce, use a caixa localização rápida para procurar Gerenciador de aplicativos e, em seguida, clique em Gerenciador de aplicativos.

  2. No Lightning Experience App Manager, encontre o aplicativo conectado que você criou. Clique em Actions Icon of downward-pointing triangle in a rounded square button > View na linha referente a esse aplicativo conectado.

  3. Em API (ativar Configurações de OAuth), clique em Gerenciar Detalhes do consumidor.

  4. Se solicitado, autentique-se inserindo o código enviado para seu e-mail.

  5. Copie a Chave do Consumidor e o Secreto do Consumidor e armazene-os em um local seguro. Você usa esses valores posteriormente como o Id DO cliente e o Segredo do cliente em Knowledge Hub.

Configurar as Configurações do Aplicativo conectado

Em seguida, configure algumas das configurações do aplicativo conectado que você criou.

  1. Em Gerenciar Detalhes do Consumidor em Salesforce, clique em voltar para Gerenciar Aplicativos conectados.

  2. Clique em Gerenciar na parte superior.

  3. Clique em editar políticas.

  4. Em Políticas de OAuth, configure os seguintes campos:

    1. No dropdown Permitted Users, selecione Admin approved users are pre-authorized.

    2. Em Refresh Token Policy, selecione Expire refresh token if not used for, depois insira 2 e selecione Hora(s).

    3. Selecione Habilitar Fluxo de Troca de Token.

  5. Em Configurações de provisionamento de usuário, selecione ativar provisionamento de usuário.

  6. Clique em Salvar.

Atribuir o Perfil do Admin ao Aplicativo conectado

Em seguida, atribua o perfil de Administrador do Sistema ao aplicativo conectado.

  1. De volta ao aplicativo conectado, role para baixo até a seção Profiles e clique em Manage Profiles.

  2. Marque a caixa ao lado de Administrador do Sistema.

  3. Clique em Salvar.

Configurar Configurações OAuth

Em seguida, configure as configurações de OAuth em Salesforce.

  1. Em Salesforce, clique em Setup Icon of gray gear with a lightning bolt in the center na parte superior direita.

  2. Use a caixa localização Rápida para pesquisar OAuth e, em seguida, clique em OAuth e OpenID Connect Settings.

  3. Ative as seguintes configurações:

    • Permitir OAuth Fluxos de Nome do usuário-Senha

    • Permitir OAuth Fluxos de User-Agent

    • Permitir Fluxos de Código de Autorização e Credenciais

Obter o nome do Objeto

Por fim, obtenha o nome do objeto em Salesforce. Esta é a última credencial que você precisa fornecer para Knowledge Hub.

  1. Faça login no Salesforce.

  2. Clique em Configuração na parte superior direita.

  3. Use a caixa de Encontrar Rápido para pesquisar Object Manager e, em seguida, clique em Object Manager.

  4. Encontrar o objeto com o nome de API Knowledge_kav.

Configurar e Autenticar Salesforce em Knowledge Hub

  1. Em NiCE CXone, clique no seletor de aplicativos Icon of three-by-three grid of white squares on a blue background e selecione Geral > AI Studio > Knowledge Hub.

  2. Clique em Editar Fonteicon of a gray pencil and paper. na linha da fonte de conhecimento para a qual você deseja fornecer credenciais.

  3. Na página Configuração de Fonte, insira os detalhes dos campos a seguir,

    1. Fonte de conhecimento

    2. Id DO cliente

    3. Segredo do cliente

    4. URL da instância

    5. Nome do objeto

  4. Depois de informar todos os campos obrigatórios de Salesforce, o botão Autenticar é habilitado. Selecione Autenticar para entrar em Salesforce e concluir a verificação.

  5. Na janela de login do Salesforce, insira o nome do usuário e a senha da conta associada ao id DO cliente e ao segredo do cliente.

  6. Conclua a etapa de verificação de identidade. Salesforce envia um código de verificação para o endereço DE e-mail ou número de telefone registrado.

  7. Após a autenticação ser concluída com sucesso, Knowledge Hub gera os tokens necessários automaticamente em plano de fundo.

  8. Quando a autenticação for concluída, os campos de configuração se tornam somente leitura. Se a criação ou sincronização da fonte falhar, você pode editar a configuração novamente.

  9. Selecione Próximo.

Selecionar metadados para a ingestão

Após a autenticação, selecione os campos Salesforce que Knowledge Hub deve ingerir. Você pode escolher tanto campos de metadados quanto campos de corpo do artigo. Alguns campos são obrigatórios por padrão e não podem ser removidos. Os campos disponíveis podem variar de acordo com a configuração do Salesforce.

  1. Em Artigo Meta Campos de Dados, selecione os campos para ingerir como metadados.

  2. Em Campo/s de Corpo do Artigo, selecione o campo ou os campos que contêm o corpo do artigo.

    Não selecione o mesmo campo tanto na lista campo de metadados quanto na lista campo de corpo do artigo. Mantenha selecionados os campos obrigatórios padrão. Esses campos não podem ser removidos.

  3. Clique em Salvar.

Reautenticar a Fonte Salesforce

Se a autenticação do Salesforce for revogada, expirar ou parar de funcionar, atualize os detalhes da conexão, se necessário, e, em seguida, autentique novamente na mesma página de configuração. Após autenticar com sucesso, continue com a seleção de metadados.