Conector para o Salesforce

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, usando apenas um ID e um segredo do cliente

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 .

Autenticação OAuth Além disso, a autenticação requer o uso de um aplicativo conectado ao Salesforce. Para criar esse no Salesforce, configure o aplicativo e defina as seguintes configurações necessárias:

Para URL de retorno de chamada, insira uma das seguintes opções que corresponda ao seu AppSpot:
- PROD: https://h.app.wdesk.com/s/wdata/oc/app/oauth/callback
- EMEA - https://h.eu.wdesk.com/s/wdata/oc/app/oauth/callback
- APAC: https://h.apac.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.

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

Autenticação da credencial do cliente

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

A autenticação de credenciais de cliente requer o uso de um aplicativo conectado ao Salesforce. Para criar esse no Salesforce, configure o aplicativo usando o fluxo de credenciais de 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.

Em Construtor de cadeia, clique em Conexões compare_arrows e, em seguida, Criar no canto superior direito.
Em Connector Connection, selecione Salesforce e o CloudRunner padrão.
Em Basic Info, digite um nome e uma descrição exclusivos para ajudar a identificar o conector.

Em Properties, insira a instância do Salesforce ou o domínio personalizado ao qual você deve 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`.

Para o tipo de autenticação, selecione Salesforce OAuth.
Digite o ID do cliente, o segredo e o escopo em Authentication e, em seguida, clique em Connect.
Observação: Quando a conexão com o Salesforce for bem-sucedida, o token de atualização e o token de acesso do conector serão preenchidos automaticamente. Se a conexão falhar, clique em Stop e aguarde para se conectar novamente.

Observação: Todas as credenciais confidenciais são automaticamente criptografadas e armazenadas com criptografia AES-256.
Selecione os ambientes a serem usados com a conexão e clique em Salvar.
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.

Em Construtor de cadeia, clique em Conexões compare_arrows e, em seguida, Criar no canto superior direito.
Em Connector Connection, selecione Salesforce e o CloudRunner padrão.
Em Basic Info, digite um nome e uma descrição exclusivos para ajudar a identificar o conector.

Em Properties, insira a instância do Salesforce ou o domínio personalizado ao qual você deve 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`.

Para o tipo de autenticação, selecione Basic Auth.
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.
Selecione os ambientes a serem usados com a conexão e clique em Salvar.
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.

Em Construtor de cadeia, clique em Conexões compare_arrows e, em seguida, Criar no canto superior direito.
Em Connector Connection, selecione Salesforce e o CloudRunner padrão.
Em Basic Info, digite um nome e uma descrição exclusivos para ajudar a identificar o conector.

Em Properties, insira a instância do Salesforce ou o domínio personalizado ao qual você deve 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`.

Para Tipo de autenticação, selecione Credenciais de cliente.
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.
Selecione os ambientes a serem usados com a conexão e clique em Salvar.
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 o URL de retorno de chamada é:
  - PROD: https://h.app.wdesk.com/s/wdata/oc/app/oauth/callback
  - EMEA - https://h.eu.wdesk.com/s/wdata/oc/app/oauth/callback
  - APAC: https://h.apac.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:

Em Chains, clique em Connections compare_arrows, selecione o conector e clique em Edit.
Em OAuth, clique em Reset.
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 do Salesforce ou o domínio personalizado corretos 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.

Suporte

Comunidade

Centro de suporte da Workiva

Conector para o Salesforce

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.