Centro de suporte da Workiva

Com o conector do Salesforce®, você pode usar os comandos para interagir com o Salesforce como parte de uma cadeia. Por exemplo, com esse conector, você pode:

• Fazer upload, extrair e excluir dados no Salesforce por meio de SOQL e operações em massa
• Criar e gerenciar objetos do Salesforce
• Atualizar e criar registros no Salesforce

O conector interage com todas as versões do Salesforce Sales Cloud:

• Salesforce Essentials® - Salesforce Net Zero Cloud
• Salesforce Net Zero Cloud
• Lightning® Professional
• Lightning Enterprise
• Lightning Unlimited

Observação: Esse conector foi criado pela Workiva e se conecta a um sistema de terceiros. Embora nossa equipe de suporte possa ajudar a configurar esse conector no seu espaço de trabalho, não podemos solucionar problemas ou ajudar com problemas que se originem fora da plataforma Workiva.

Requisitos

Para tornar o conector disponível para uso em sua organização, um administrador de segurança da organização deve primeiro habilitá-lo.

Você pode então proteger sua conexão com o Salesforce usando um dos métodos a seguir:

• Autenticação do Salesforce OAuth, usando um ID de cliente, um segredo e um escopo
• Autenticação básica, usando um nome de usuário e uma senha
• Credenciais do cliente, utilizando apenas um ID de cliente e um segredo
   

Autenticação do Salesforce OAuth

Para se conectar à Workiva, você precisará do ID do cliente e do segredo do Salesforce, bem como do escopo OAuth do aplicativo conectado .

A autenticação OAuth exige, além disso, o uso de um aplicativo conectado ao Salesforce. Para criá-lo no Salesforce, acesse , configure o aplicativo e defina as seguintes configurações obrigatórias:

• Para o URL de retorno de chamada d , insira uma das opções a seguir que corresponda ao seu AppSpot:
  • EUA, América Central, América do Sul: https://h.app.wdesk.com/s/wdata/oc/app/oauth/callback
  • APAC: https://h.apac.wdesk.com/s/wdata/oc/app/oauth/callback
  • Canadá: https://h.ca.wdesk.com/s/wdata/oc/app/oauth/callback
  • EMEA: https://h.eu.wdesk.com/s/wdata/oc/app/oauth/callback
• Em Escopos OAuth selecionados, inclua Execute solicitações em seu nome a qualquer momento (refresh_token, offline_access) e pelo menos um outro escopo.
   

Autenticação básica

Para se conectar à Workiva, você precisará do nome de usuário do usuário de integração, da senha e do token de segurança do Salesforce.

A autenticação básica requer um usuário de integração com permissões habilitadas para API, além das permissões relacionadas a quaisquer tarefas que o conector executará.

Nota: Para definir as permissões do usuário de integração no Salesforce, selecione Administrar, Gerenciar usuários, Perfis e selecione o perfil.

1. Em “ ” (Permissões administrativas), selecione “ API Enabled” (API do ativada).
2. Para permitir que o conector execute um comando, o usuário precisa de pelo menos Permissões de leitura para seus dados relacionados. 
3. Para realizar atualizações em massa nos objetos do Salesforce, o usuário precisa de permissões Edit para o objeto.
    

Autenticação de credencial do cliente

Para se conectar à Workiva, você precisará do ID do cliente e do segredo do Salesforce.

A autenticação por credenciais do cliente requer o uso de um aplicativo conectado ao Salesforce. Para criá-lo no Salesforce, configure o aplicativo utilizando o fluxo de credenciais do cliente .

Configure o conector do Salesforce para autenticação OAuth

A autenticação OAuth permite que você acesse o Salesforce usando um ID de cliente e um segredo. Diferentemente do método de login com credencial do cliente, a autenticação OAuth inclui um token de atualização e requer um escopo.

Esse método é recomendado para comandos de execução mais longa que, de outra forma, poderiam atingir o tempo limite usando o método de credenciais do cliente.

1. No Chain Builder do , clique em compare_arrows Connections na barra lateral esquerda e, em seguida, em compare_arrows Create no canto superior direito.
2. Em Connector Connection, selecione Salesforce e o CloudRunner padrão.
3. Em Basic Info, digite um nome e uma descrição exclusivos para ajudar a identificar o conector.

4. Em “ ” (Propriedades), insira a instância do Salesforce ou o domínio personalizado ao qual deseja se conectar:

   Propriedade	Detalhes
   Instância	Digite a instância do Salesforce à qual você deve se conectar. Se sua organização utiliza um domínio personalizado do Salesforce, deixe este campo em branco. Observação: No URL do Salesforce, os caracteres antes de salesforce.com-como na73-representam a instância.
   Domínio personalizado	Digite o domínio personalizado do Salesforce ao qual você deve se conectar, se usado. Nota: Para visualizar seu domínio personalizado no Salesforce, selecione Configurações da empresa, Meu domínio. Um domínio personalizado geralmente termina com .my.salesforce.com.

5. Para o tipo de autenticação, selecione Salesforce OAuth.

6. Insira o ID do cliente, o segredo e o escopo em “ ” (Autenticação) e, em seguida, clique em “ ” (Conectar).
   

   Observação: Quando a conexão com o Salesforce for bem-sucedida, o token de atualização do conector , o token de acesso e e o token de acessosão preenchidos automaticamente. Se a conexão falhar, clique em Stop e aguarde para se conectar novamente.

   Nota: Todas as credenciais confidenciais são automaticamente criptografadas e armazenadas com criptografia AES-256.

7. Selecione os ambientes a serem usados com a conexão e clique em Salvar.
8. Para testar a conexão, crie e execute uma cadeia com o comando Obter lista de relatório do conector 2 e verifique se ele retorna uma saída válida.

Configure o conector do Salesforce para autenticação básica

A autenticação básica permite que você faça login no Salesforce usando o nome de usuário e a senha de um usuário de integração.

1. No Chain Builder do , clique em compare_arrows Connections na barra lateral esquerda e, em seguida, em compare_arrows Create no canto superior direito.
2. Em Connector Connection, selecione Salesforce e o CloudRunner padrão.
3. Em Basic Info, digite um nome e uma descrição exclusivos para ajudar a identificar o conector.

4. Em “ ” (Propriedades), insira a instância do Salesforce ou o domínio personalizado ao qual deseja se conectar:

   Propriedade	Detalhes
   Instância	Digite a instância do Salesforce à qual você deve se conectar. Se sua organização usa um domínio personalizado do Salesforce, deixe em branco. Observação: No URL do Salesforce, os caracteres antes de salesforce.com-como na73-representam a instância.
   Domínio personalizado	Digite o domínio personalizado do Salesforce ao qual você deve se conectar, se usado. Nota: Para visualizar seu domínio personalizado no Salesforce, selecione Configurações da empresa, Meu domínio. Um domínio personalizado geralmente termina com .my.salesforce.com.

5. Para o tipo de autenticação, selecione Basic Auth.

6. Em Authentication, digite o nome de usuário, a senha e o token de segurança do usuário de integração.

   Observação: Todas as credenciais confidenciais são automaticamente criptografadas e armazenadas com criptografia Advanced Encryption Standard (AES) 256.

7. Selecione os ambientes a serem usados com a conexão e clique em Salvar.
8. Para testar a conexão, crie e execute uma cadeia com o comando Obter lista de relatório do conector 2 e verifique se ele retorna uma saída válida.
    

Configure o conector do Salesforce para credenciais de cliente

A autenticação de credenciais de cliente permite que você acesse o Salesforce usando um ID de cliente e um segredo. Isso difere do método de login OAuth porque não exige um escopo e você não precisará se autenticar no Salesforce por meio do botão Connect. 

Aviso: Este método de autenticação não inclui um token de atualização. Por esse motivo, ele não é adequado para comandos de longa duração e pode levar a tempos limite em determinadas cadeias.

1. No Chain Builder do , clique em compare_arrows Connections na barra lateral esquerda e, em seguida, em compare_arrows Create no canto superior direito.
2. Em Connector Connection, selecione Salesforce e o CloudRunner padrão.
3. Em Basic Info, digite um nome e uma descrição exclusivos para ajudar a identificar o conector.

4. Em “ ” (Propriedades), insira a instância do Salesforce ou o domínio personalizado ao qual deseja se conectar:

   Propriedade	Detalhes
   Instância	Digite a instância do Salesforce à qual você deve se conectar. Se sua organização usa um domínio personalizado do Salesforce, deixe em branco. Observação: Na sua URL do Salesforce, os caracteres que precedem salesforce.com —como na73—representam a instância.
   Domínio personalizado	Digite o domínio personalizado do Salesforce ao qual você deve se conectar, se usado. Nota: Para visualizar seu domínio personalizado no Salesforce, selecione Configurações da empresa, Meu domínio. Um domínio personalizado geralmente termina com .my.salesforce.com.

5. Para Tipo de autenticação, selecione Credenciais de cliente.

6. Em Authentication, digite a ID e o segredo do cliente.

   Nota: Todas as credenciais confidenciais são automaticamente criptografadas e armazenadas com criptografia AES-256.

7. Selecione os ambientes a serem usados com a conexão e clique em Salvar.
8. Para testar a conexão, crie e execute uma cadeia com o comando Obter lista de relatório do conector 2 e verifique se ele retorna uma saída válida.

Solução de problemas

Se a conexão com o Salesforce falhar, você pode verificar várias definições de configuração, dependendo do tipo de autenticação.

 

Autenticação OAuth2

Se a conexão com o aplicativo conectado ao Salesforce falhar quando você clicar pela primeira vez em Connect, clique em Stop e aguarde para se conectar novamente. Se a conexão continuar a falhar ao usar a autenticação OAuth2:

• Verifique se a instância do Salesforce ou o domínio personalizado corretos foram inseridos para o conector.
• Verifique o ID do cliente e o segredo do aplicativo conectado ao Salesforce que o conector usa.
• No aplicativo conectado ao Salesforce:
  • Verifique se a URL de retorno de chamada está correta:
  • Para os EUA, América Central e América do Sul: https://h.app.wdesk.com/s/wdata/oc/app/oauth/callback
  • Para a região Ásia-Pacífico: https://h.apac.wdesk.com/s/wdata/oc/app/oauth/callback
  • Para o Canadá: https://h.ca.wdesk.com/s/wdata/oc/app/oauth/callback
  • Para a região EMEA: https://h.eu.wdesk.com/s/wdata/oc/app/oauth/callback
  • Certifique-se de que os escopos OAuth selecionados incluam Realizar solicitações em seu nome a qualquer momento (refresh_token, offline_access) e pelo menos um outro escopo.

Se o conector perder a conexão com o aplicativo Salesforce, você poderá fazer o seguinte:

1. No Chain Builder do , clique em compare_arrows Conexões na barra lateral esquerda e, em seguida, clique em Editar (ícone de lápis) para a conexão.
2. Em OAuth, clique em Reset.
3. Para permitir que o conector se conecte ao Salesforce, clique em Allow.
    

Autenticação básica

Se a conexão falhar usando a autenticação básica:

• Verifique as credenciais de login e o token de segurança do usuário de integração. Para solicitar um novo token de segurança no Salesforce, faça login como usuário de integração e selecione Configurações, Minhas informações pessoais e clique em Redefinir token de segurança.
• Verifique se a instância correta do Salesforce ou o domínio personalizado foram inseridos para o conector.
• Certifique-se de que o usuário de integração tenha API Enabled permissões, além das permissões relacionadas a quaisquer tarefas que o conector execute.
   

Autenticação de credencial do cliente

Se a conexão falhar usando a autenticação de credencial do cliente:

• Verifique se a instância correta do Salesforce ou o domínio personalizado foram inseridos para o conector.
• Verifique o ID do cliente e o segredo do aplicativo conectado ao Salesforce que o conector usa.