Configurar a integração com o Salesforce conecta sua base de conhecimento do Document360 ao seu console Salesforce. Uma vez configurados, os agentes de suporte podem buscar artigos, obter recomendações e criar conteúdo de base de conhecimento diretamente do Salesforce. Este artigo guia você por todas as etapas do processo de configuração, desde a instalação do aplicativo Document360 no Salesforce até a autorização da conexão pelo seu portal Document360.
Antes de começar
- Você precisa de uma conta na plataforma Salesforce Lightning. Se você não tiver um, inscreva-se para um teste gratuito na página de cadastração do Salesforce. Se você já tem uma conta, pule para Instalar o aplicativo Document360 no Salesforce.
- Você deve ser administrador tanto na sua organização Salesforce quanto no seu projeto Document360.
- A integração com o Salesforce é uma compra adicional. Vá em Configurações > Extensões no seu portal do Document360 e clique em Comprar agora no bloco Salesforce antes de começar.
Como configurar a integração com o Salesforce
Configurar a integração envolve cinco etapas. Preencha em ordem:
- Crie uma conta Salesforce (pule se você já tiver uma)
- Instale o aplicativo Document360 no Salesforce
- Configurar configurações do Gerenciador de Aplicativos
- Adicionar uma página no Visualforce
- Conceda acesso de aplicativos aos perfis de usuário
- Autorize a integração do Document360
Crie uma conta Salesforce
Se você já tem uma conta na plataforma Salesforce Lightning, pule esta seção.
- Vá para a página de cadastro do Salesforce.
- Insira os dados necessários e clique em Iniciar meu teste gratuito.
- Visite a página de preços da Salesforce para escolher e adquirir um plano que atenda às suas necessidades.
- Verifique seu e-mail registrado para uma mensagem contendo seu link de verificação, URL da conta e nome de usuário. Clique em Verificar Conta no e-mail.
- Insira o código de verificação no e-mail de acompanhamento e clique em Verificar.
O código de verificação chega em um e-mail separado do e-mail inicial do link de verificação.
Você é redirecionado para a página inicial do Salesforce.
Instale o aplicativo Document360 no Salesforce
- Vá para a lista do Document360 no AppExchange.
- Clique em tentar.
- Faça login com sua conta Trailblazer.
- Selecione o ambiente onde deseja instalar o app:
- Instalar em Produção — instala o Document360 no ambiente de produção do seu projeto Salesforce.
- Instale no Sandbox — instale o Document360 no ambiente sandbox do seu projeto Salesforce.
- Revise os detalhes da instalação e clique em Confirmar e Instalar.
- Insira suas credenciais do Salesforce e clique em Logar.
- Selecione quem deve ter acesso ao aplicativo Document360:
- Instalação apenas para administradores — restringe o acesso apenas para administradores.
- Instalar para todos os usuários — dá acesso a todos os usuários da sua organização.
- Instalar para perfis específicos — limita o acesso a perfis de usuário selecionados.
Essa seleção determina quais usuários da sua organização Salesforce podem acessar o aplicativo Document360. Você pode ajustar o acesso depois atualizando os perfis dos usuários.
- Clique em instalar.
- Espere a instalação terminar e então clique em Concluído.
Configurar configurações e políticas do Gerenciador de Aplicativos
Após instalar o aplicativo Document360, configure suas políticas OAuth no Salesforce para controlar quem pode autorizar a integração.
- Na sua configuração do Salesforce, navegue até Ferramentas de Plataforma > Apps > Gerenciador de Apps no painel de navegação esquerdo. Essa etapa garante autorização segura e controle de acesso adequado para usuários que interagem com a integração do Document360.
- Na página do Gerenciador de Apps Lightning Experience , encontre o Document360 na lista de aplicativos.
- Clique na seta para baixo no final da linha do aplicativo Document360 e selecione Gerenciar.
- Na página de detalhes do aplicativo conectado ao Document360, clique em Editar Políticas.
- No menu suspenso de Usuários Permitidos , selecione quem pode autorizar o aplicativo a acessar os dados em seu nome. Existem duas opções:
- Todos os usuários podem se autoautorizar — qualquer usuário da sua organização pode autorizar individualmente o aplicativo quando necessário. Isso funciona bem para organizações com diferentes funções ou departamentos que precisam usar a integração de forma independente.
- Usuários aprovados por administradores são pré-autorizados — usuários administradores são automaticamente autorizados sem passar pelo processo de autenticação a cada vez. Isso é útil quando o administrador é o usuário principal da integração.
Selecionar usuários aprovados por Administrador como pré-autorizados é uma ação única. Uma vez configurado, o administrador não precisará autenticar manualmente novamente.
Adicione uma página do Visualforce no console de desenvolvedores Salesforce
Você precisa criar uma página Visualforce no seu console de desenvolvedor Salesforce para incorporar o aplicativo Document360 ao seu ambiente Salesforce.
- No campo Busca Rápida no canto superior esquerdo da sua configuração do Salesforce, procure por Páginas Visualforce e selecione-o nos resultados.
- Clique em Novo.
- Insira um rótulo, nome e descrição para a página.
- Selecione a caixa de seleção Disponível para Lightning Experience, sites Experience Builder e o aplicativo móvel .
- Cole o código a seguir na seção de Marcação Visualforce :
<apex:page standardController="Case"> <apex:canvasApp applicationName="Document360" namespacePrefix="Document360" height="800" width="750px"/> </apex:page>
Você pode editar os valores de altura e largura na marcação para se adequar ao seu layout. Por exemplo: height="800px" width="750px". Anote o valor de altura que você definiu aqui — você precisará dele ao adicionar o componente Visualforce à sua página de Casos.
- Clique em Salvar.
Conceda acesso de aplicativos aos perfis de usuário
O administrador da organização deve conceder acesso ao aplicativo Document360 aos perfis de usuário relevantes. Sem essa etapa, os usuários verão um erro de Privilégios Insuficientes ao acessar a aba de Conhecimento.
- Navegue até a página de Configuração no seu ambiente Salesforce.
- No painel de navegação à esquerda, vá para Administração > Usuários > Perfis.
- Na lista de perfis, clique no perfil atribuído à equipe ou indivíduo que gerencia a página do caso e as configurações de integração.
- Na página do perfil, clique em Editar.
- Desça até a seção Acesso ao Aplicativo Conectado .
- Selecione a caixa de seleção Document360 .
- Clique em Salvar.
Repita isso para cada perfil que precisar de acesso ao app Document360 no Salesforce.
Autorize a integração com o Salesforce a partir do seu portal Document360
O passo final é autorizar a conexão pelo seu portal Document360.
- Acesse seu portal do Document360.
- Navegue até Configurações na barra de navegação esquerda.
- Vá em Extensões no painel de navegação esquerdo.
- Clique em Salesforce na seção de Helpdesk .
Salesforce é uma compra adicional. Se você ainda não comprou, clique em Comprar agora no bloco Salesforce.
- Clique em Conectar.
- Selecione seu tipo de autorização:
- Em direto — autoriza seu projeto de produção no Salesforce.
- Sandbox — autoriza seu projeto sandbox no Salesforce.
- No painel Permitir acesso , clique em Permitir e espere alguns segundos.
- O bloco Salesforce agora mostra o status como Projeto conectado ao Salesforce , junto com a URL da conta Salesforce associada ao seu projeto.
- Clique em Detalhes no bloco Salesforce para ver todas as informações de configuração.
Para remover a integração, clique no ícone Excluir no bloco Salesforce.
A integração com o Salesforce já está configurada. Seus agentes agora podem pesquisar sua base de conhecimento, obter recomendações de artigos e criar artigos diretamente do console Salesforce. Em seguida, aprenda a usar o Document360 no Salesforce.
Melhores práticas
- Complete as cinco fases em ordem. Cada estágio depende do anterior. Pular a configuração do App Manager, por exemplo, pode causar erros de autorização posteriormente.
- Teste no Sandbox antes de lançar. Use o ambiente Sandbox para verificar se a integração funciona como esperado antes de conectar seu projeto de produção no Salesforce.
- Defina o acesso ao perfil antes de autorizar. Conceda acesso ao app Document360 a todos os perfis de usuário relevantes antes que os agentes tentem usar a integração, para evitar erros de Privilégios Insuficientes.
- Anote a altura da sua página no Visualforce. Quando você adiciona o Document360 à sua página de Casos, a altura deve igualar ou superar o valor definido na marcação da página do Visualforce.
- Use usuários aprovados por Administrador pré-autorizados para uma experiência mais tranquila. Se seu administrador for o usuário principal da integração, essa configuração elimina a necessidade de repetidos prompts de autenticação.
- Ao atualizar a integração, revise as notas de atualização do Document360 e do Salesforce para quaisquer alterações na API ou funcionalidades, teste em um ambiente de staging e depois confirme a compatibilidade antes de implantar para produção.
FAQ
Qual é a arquitetura técnica da integração entre Document360 e Salesforce?
A integração utiliza APIs de ambas as plataformas para permitir a transferência de dados e a sincronização entre Document360 e Salesforce.
Como o versionamento de documentos é tratado durante a sincronização?
A integração acompanha as mudanças no Document360 e atualiza os registros correspondentes no Salesforce para manter a precisão e consistência dos dados.
Quais passos estão envolvidos para atualizar a integração quando novas versões forem lançadas?
Revise as notas de atualização para quaisquer alterações em APIs ou recursos, teste a atualização em um ambiente de staging e depois confirme a compatibilidade antes de implantar para produção.