

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Conecte-se ao Salesforce
<a name="connectors-salesforce"></a>

Para conectar o App Studio ao Salesforce para permitir que os criadores acessem e usem os recursos do Salesforce em aplicativos, você deve criar e configurar um aplicativo conectado no Salesforce e criar um conector do Salesforce no App Studio.

**Para conectar o Salesforce ao App Studio**

1. No App Studio, no painel de navegação, escolha **Conectores na seção** **Gerenciar**. Você será direcionado para uma página exibindo uma lista de conectores existentes com alguns detalhes sobre cada um.

1. Escolha **\$1 Criar conector**.

1. Escolha **Salesforce** na lista de tipos de conectores para abrir a página de criação de conectores.

1. Anote o **URL de redirecionamento**, que você usará para configurar o Salesforce nas etapas a seguir.

1. A próxima etapa é criar um aplicativo conectado no Salesforce. Em outra guia ou janela, navegue até sua instância do Salesforce.

1. Na caixa Busca rápida, pesquise **App Manager** e selecione **Gerenciador de aplicativos**.

1. Escolha **Novo aplicativo conectado**.

1. Em **Nome do aplicativo conectado** e **Nome da API**, insira um nome para seu aplicativo. Ele não precisa corresponder ao nome do seu aplicativo do App Studio.

1. Forneça as informações de contato conforme necessário.

1. Na seção **API (Ativar OAuth configurações)**, ative **Ativar OAuth configurações**.

1. Em **URL de retorno** de chamada, insira o **URL de redirecionamento** que você anotou anteriormente no App Studio.

1. Em ** OAuth Escopos selecionados**, adicione os escopos de permissões necessários da lista. O App Studio pode interagir com o Salesforce REST APIs para realizar operações CRUD em cinco objetos: contas, casos, contatos, leads e oportunidades. É recomendável adicionar **acesso total (completo)** para garantir que seu aplicativo do App Studio tenha todas as permissões ou escopos relevantes.

1. Desative a opção **Exigir chave de prova para a extensão PKCE (Code Exchange) para fluxos de autorização suportados**. O PKCE não é compatível com o App Studio.

1. Ative **Exigir segredo para fluxo do servidor Web** e **Exigir segredo para atualização do fluxo de token** para seguir as melhores práticas de segurança.

1. O App Studio é compatível com os dois fluxos de autenticação a seguir:
   + **Fluxo de credenciais do cliente**: ideal para server-to-server interações em que o aplicativo age em seu próprio nome sem a interação do usuário. Por exemplo, listar todas as informações de leads de uma equipe de funcionários temporários que não têm acesso ao Salesforce.
   + **Fluxo de código de autorização**: adequado para aplicativos que agem em nome de um usuário, como ações ou acesso a dados pessoais. Por exemplo, listar os leads de cada gerente de vendas fornecidos ou pertencentes a eles para realizar outras tarefas por meio desse aplicativo.
   + Para o fluxo de credenciais do cliente:

     1. Habilite **Ativar fluxo de credenciais do cliente**. Revise e confirme a mensagem.

     1. Salve o aplicativo.

     1. Você deve selecionar um usuário de execução, embora não haja interação do usuário no fluxo. Ao selecionar um usuário de execução, o Salesforce retorna tokens de acesso em nome do usuário.

        1. No **Gerenciador de aplicativos**, na lista de aplicativos, escolha a seta do aplicativo App Studio e escolha **Gerenciar**.

        1. Escolha **Editar políticas**

        1. No **Fluxo de credenciais do cliente**, adicione o usuário apropriado.
   + Para o fluxo de código de autorização, habilite **Habilitar código de autorização e fluxo de credenciais**

1. O Salesforce fornece um ID do cliente e um segredo do cliente, que devem ser usados para configurar o conector no App Studio nas etapas a seguir.

   1. No **Gerenciador de aplicativos**, escolha a seta do aplicativo App Studio e escolha **Exibir**.

   1. Na seção **API (Ativar OAuth configurações)**, escolha **Gerenciar detalhes do consumidor**. Isso pode enviar um e-mail com uma chave de verificação, que você precisa inserir para confirmação.

   1. Anote a **Chave do Consumidor** (ID do Cliente) e o **Segredo do Consumidor** (Segredo do Cliente).

1. De volta ao App Studio, configure e crie seu conector preenchendo os campos a seguir.

1. Em **Nome**, insira um nome para seu conector do Salesforce.

1. Em **Descrição**, insira uma descrição para seu conector do Salesforce.

1. Em **URL base**, insira a URL base da sua instância do Salesforce. Deve ter a seguinte aparência:`https://hostname.salesforce.com/services/data/v60.0`, *hostname* substituindo pelo nome da sua instância do Salesforce.

1. Em **Método de autenticação**, certifique-se de que **OAuth 2.0** esteja selecionado.

1. No **OAuth 2.0 Flow**, selecione o método de OAuth autenticação e preencha os campos relacionados:
   + Selecione **o fluxo de credenciais do cliente** para uso em aplicativos que atuam em seu próprio nome, para system-to-system integrações.

     1. Em **ID do cliente**, insira a **chave do consumidor** obtida anteriormente da Salesforce.

     1. Em **Segredo do cliente**, insira o **Segredo do consumidor**, obtido anteriormente da Salesforce.

     1. Em **URL do token de acesso**, insira o endpoint do token OAuth 2.0. Deve ter a seguinte aparência:`https://hostname/services/oauth2/token`, *hostname* substituindo pelo nome da sua instância do Salesforce. Para obter mais informações, consulte a documentação do [Salesforce OAuth Endpoints](https://help.salesforce.com/s/articleView?id=sf.remoteaccess_oauth_endpoints.htm&type=5).

     1. Escolha **Verificar conexão** para testar a autenticação e a conexão.
   + Selecione **Fluxo de código de autorização** para uso em aplicativos que atuam em nome do usuário.

     1. Em **ID do cliente**, insira a **chave do consumidor** obtida anteriormente da Salesforce.

     1. Em **Segredo do cliente**, insira o **Segredo do consumidor**, obtido anteriormente da Salesforce.

     1. Em **URL de autorização**, insira o endpoint de autorização. Deve ter a seguinte aparência:`https://hostname/services/oauth2/authorize`, *hostname* substituindo pelo nome da sua instância do Salesforce. Para obter mais informações, consulte a documentação do [Salesforce OAuth Endpoints](https://help.salesforce.com/s/articleView?id=sf.remoteaccess_oauth_endpoints.htm&type=5).

     1. Em **URL do token de acesso**, insira o endpoint do token OAuth 2.0. Deve ter a seguinte aparência:`https://hostname/services/oauth2/token`, *hostname* substituindo pelo nome da sua instância do Salesforce. Para obter mais informações, consulte a documentação do [Salesforce OAuth Endpoints](https://help.salesforce.com/s/articleView?id=sf.remoteaccess_oauth_endpoints.htm&type=5).

1. Em **Operações**, selecione as operações do Salesforce que seu conector suportará. As operações nessa lista são predefinidas e representam tarefas comuns no Salesforce, como criar, recuperar, atualizar ou excluir registros de objetos comuns.

1. Escolha **Criar**. O conector recém-criado aparecerá na lista de **conectores**.