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á.

# Integração ao Salesforce
<a name="salesforce-integration"></a>

Com o conector de ação do Salesforce no Amazon Quick, você pode realizar ações dentro das organizações do Salesforce, incluindo gerenciar registros, consultar dados e interagir com o Salesforce. APIs Esse conector de ação suporta somente a execução de tarefas e requer o nível Amazon Quick Pro ou superior.

## O que é possível fazer
<a name="salesforce-integration-capabilities"></a>

Com a integração com o Salesforce, você pode realizar ações em suas organizações do Salesforce por meio do conector de ação.

**Conector de ação**  
Crie, atualize e consulte objetos do Salesforce, como leads, contas, contatos e oportunidades.

**nota**  
A integração com o Salesforce não oferece suporte ao acesso a dados ou à criação de base de conhecimento. Ele foi projetado especificamente para execução de tarefas e interações de API com objetos do Salesforce.

## Antes de começar
<a name="salesforce-integration-prerequisites"></a>

Antes de configurar a integração com o Salesforce, verifique se você tem o seguinte:
+ Organização do Salesforce com as permissões apropriadas.
+ Credenciais de acesso ao aplicativo conectado ou à API do Salesforce.
+ Amazon Quick Author ou superior.
+ Acesso administrativo para configurar OAuth aplicativos (se estiver usando a autenticação do usuário).

## Etapa 1: configurar o aplicativo conectado ao Salesforce
<a name="salesforce-connected-app-setup"></a>

**nota**  
Crie um aplicativo conectado no Salesforce. Não crie um aplicativo cliente externo. Aplicativos clientes externos não são compatíveis com essa integração.

Crie um aplicativo conectado no Salesforce para habilitar a OAuth autenticação com o Amazon Quick.

1. Faça login na sua conta do Salesforce e navegue até a página de configuração usando o ícone de configuração no canto superior direito.

1. Na barra Busca rápida**Apps**, digite e siga estas etapas:
   + Selecione **aplicativos de cliente externos**
   + Selecione **Configurações**
   + Em Configurações, crie um novo aplicativo conectado

1. Escolha **Novo aplicativo conectado**.

1. Escolha **Criar um aplicativo conectado**.

1. Na seção Informações básicas, insira as seguintes informações obrigatórias:
   + **Nome do aplicativo conectado** - Um nome descritivo para seu aplicativo conectado.
   + **Nome da API** - Um nome de API exclusivo para seu aplicativo.
   + **E-mail de contato** - Seu endereço de e-mail de contato.

1. Na seção OAuth Configurações, marque as seguintes caixas de seleção:
   + **Ativar OAuth configurações**
   +  **Exigir a extensão Proof Key for Code Exchange (PKCE) para fluxos de autorização compatíveis** *(recomendado)* 

      Ative essa opção para adicionar uma camada de segurança adicional ao fluxo do Código de Autorização.
   + **Exigir segredo para o fluxo do servidor Web**
   + **Exigir segredo para atualizar o fluxo do token**
   + **Ativar fluxo de credenciais do cliente**
   + **Ativar código de autorização e fluxo de credenciais**
   + **Ativar fluxo de troca de tokens**
   + **Exigir segredo para o fluxo de troca de tokens**

1. Adicione os seguintes OAuth escopos obrigatórios:
   + `api`- Acesse o Salesforce APIs
   + `refresh_token`- Mantenha o acesso quando o usuário estiver offline
   + `offline_access`- Execute solicitações a qualquer momento
   + `full`- Acesso total a todos os dados
   + `web`- Acesso baseado na web
   + `visualforce`- Acesse as páginas do Visualforce
   + `custom_permissions`- Acesse permissões personalizadas
   + `chatter_api`- Acesse a API do Chatter
   + `wave_api`- Acesse a API de análise
   + `eclair_api`- Acesse a API do Einstein Analytics
   + `pardot_api`- Acesse a API do Pardot
   + `id`- Acesse informações de identidade
   + `email`- Endereço de e-mail de acesso
   + `profile`- Acesse informações básicas do perfil
   + `address`- Informações de endereço de acesso
   + `phone`- Acesse o número de telefone
   + `open_id`- Acesse o OpenID Connect

1. Insira o URL de retorno de chamada no formato: `<quicksuite-url>/sn/oauthcallback`

1. Escolha **Salvar**.

## Etapa 2: Configurar detalhes do consumidor e usuário de execução
<a name="salesforce-consumer-details"></a>

Configure os detalhes do consumidor e configure um usuário de execução para o fluxo de credenciais do cliente.

1. Na página Gerenciar aplicativos conectados, escolha **Gerenciar detalhes do consumidor**. Talvez seja necessário verificar sua identidade.

1. Copie a **chave do consumidor (ID do cliente)** e o **segredo do consumidor (segredo do cliente)**.

1. Escolha **Aplicar**.

1. Escolha **Token de acesso inicial** e, em seguida, escolha **OK**.

1. Configure o usuário de execução:

   1. Na página de detalhes do aplicativo conectado, escolha **Editar** na coluna Ação.

   1. Em OAuth Políticas > Política de atualização de token, selecione **Expirar imediatamente o token de atualização**.

   1. Em Fluxo de credenciais do cliente, em Executar como, escolha o usuário para atribuir o fluxo de credenciais do cliente.

   1. Escolha **Salvar**.

## Etapa 3: configurar o conector de ação do Salesforce
<a name="salesforce-integration-setup"></a>

Depois de preparar suas credenciais do aplicativo conectado ao Salesforce, crie o conector de ação do Salesforce no Amazon Quick.

A integração com o Salesforce suporta somente a execução de ações - o acesso aos dados e a criação da base de conhecimento não estão disponíveis para os sistemas Salesforce.

1. No console do Amazon Quick, escolha **Integrações.**

1. Escolha **Salesforce** nas opções de integração e clique no botão Adicionar (mais “\$1”).

1. Preencha os detalhes da integração:
   + **Nome - Nome** descritivo do seu conector de ação do Salesforce.
   + **Descrição** (opcional) - Finalidade do conector de ação.

1. Escolha seu tipo de conexão:
   + **Autenticação de usuário** - autenticação OAuth baseada em autenticação para acesso de usuários individuais.
   + **Autenticação de serviço** - Service-to-service autenticação para acesso ao aplicativo.

1. Preencha as configurações de conexão com base no método de autenticação selecionado (usuário ou serviço):

   1. Para **autenticação do usuário (OAuth)**, configure os seguintes campos:
     + **URL base - URL** da instância do Salesforce (por exemplo, https://your-domain.salesforce.com).
     + **ID do cliente** - chave do consumidor do aplicativo conectado ao Salesforce.
     + **Segredo do cliente - segredo** do consumidor do aplicativo conectado à Salesforce.
     + **URL do token** - ponto final do OAuth token Salesforce.
     + **URL de autenticação - ponto final** de autorização do Salesforce. OAuth 
     + **URL de redirecionamento** - OAuth redireciona o URI configurado em seu aplicativo conectado.

1. Selecione **Criar e continuar**.

1. Escolha usuários com os quais compartilhar a integração.

1. Clique em **Next**.

## Etapa 4: associar o conector de ação aos grupos de automação
<a name="salesforce-automation-group-setup"></a>

Para usar ações do Salesforce em automações, você deve associar o conector de ação aos seus grupos de automação.

1. Navegue até as configurações do seu grupo de automação.

1. Associe o conector de ação do Salesforce ao grupo de automação que usará essas ações.

1. Crie uma nova automação para o grupo de automação acessar as ações do Salesforce em seus fluxos de trabalho.

## Ações de tarefas disponíveis
<a name="salesforce-integration-actions"></a>

Depois de criar sua integração com o Salesforce, você pode revisar as ações disponíveis para interagir com objetos do Salesforce. As ações comuns da Salesforce incluem:
+ Operações de criação, leitura, atualização e exclusão (CRUD) em objetos padrão e personalizados.
+ Consulte dados do Salesforce usando SOQL (Salesforce Object Query Language).
+ Gerencie leads, contas, contatos e oportunidades.
+ Execute métodos do Apex e lógica personalizada.
+ Gerencie casos, tarefas e atividades.
+ Acesse relatórios e painéis.

## Compartilhe integrações
<a name="salesforce-integration-sharing"></a>

Você pode compartilhar conectores de ação do Salesforce com outros usuários em sua organização. Siga estas etapas:

1. Depois de criar a integração, escolha **Compartilhar integração**.

1. Selecione usuários ou grupos com os quais compartilhar a integração.

1. Defina as permissões apropriadas para acesso compartilhado.

1. Confirme as configurações de compartilhamento.

Usuários compartilhados podem usar a integração com o Salesforce para realizar ações na organização conectada do Salesforce, de acordo com as permissões configuradas na configuração de autenticação original.

## Gerenciar conectores de ação do Salesforce
<a name="salesforce-integration-management"></a>

Depois de criar seu conector de ação do Salesforce, você pode gerenciá-lo usando estas opções:
+ **Editar conector de ação** - Atualize as configurações de autenticação ou a configuração da instância do Salesforce.
+ **Compartilhar conector de ação** - Disponibilize o conector de ação para outros usuários em sua organização.
+ **Monitore o uso** - Visualize a atividade do conector de ação e as métricas de uso da API.
+ **Revise as ações** - Veja a lista completa das ações disponíveis do Salesforce.
+ **Excluir conector de ação** - remova o conector de ação e revogue a autenticação associada.