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
Com o conector de ação do Salesforce no Amazon Quick, você pode realizar ações dentro das organizações do Salesforce, incluindo o gerenciamento de registros, a consulta de dados e a interação com as APIs do Salesforce. Para obter os requisitos de assinatura do Amazon Quick, consulte[Configurar integrações no console](integration-console-setup-process.md).
**nota**
A partir da versão Salesforce Spring '26 (fevereiro de 2026), a criação de novos aplicativos conectados está desativada por padrão em todas as organizações da Salesforce. Este guia usa os aplicativos de cliente externo (ECAs) da Salesforce, que são totalmente compatíveis com o conector Amazon Quick Salesforce.
## Pré-requisitos
Antes de configurar a integração com o Salesforce, verifique se você tem o seguinte:
+ Uma organização da Salesforce com acesso de administrador do sistema.
+ Função Amazon Quick Author ou superior.
+ Sua URL de instância do Amazon Quick (por exemplo,`https://us-east-1.quicksight.aws.amazon.com`).
## Etapa 1: criar um aplicativo cliente externo no Salesforce
Crie um aplicativo cliente externo (ECA) no Salesforce para habilitar a autenticação OAuth com o Amazon Quick.
### Navegue até External Client App Manager
1. Entre na sua organização do Salesforce e escolha **Configuração** (ícone de engrenagem no canto superior direito).
1. No painel de navegação, expanda **Ferramentas da plataforma** > **Aplicativos > Aplicativos** **clientes externos > Gerenciador de aplicativos** **clientes externos**.
1. Escolha **Novo aplicativo cliente externo**.
### Preencha as informações básicas
Insira as seguintes informações básicas para seu aplicativo cliente externo:
**Informações básicas do aplicativo cliente externo**
| Campo | Valor |
| --- | --- |
| Nome do aplicativo cliente externo | Um nome descritivo (por exemplo, “Amazon Quick Integration”) |
| Nome da API | Auto-generated do nome do aplicativo |
| E-mail de contato | Seu endereço de e-mail de administrador |
| Estado de distribuição | Local (padrão) |
## Etapa 2: definir as configurações do OAuth
### Habilitar o OAuth
Na seção **API (Ativar configurações do OAuth)**, selecione **Ativar OAuth para expandir o painel de configuração do OAuth**.
### Definir URL de retorno de chamada
Insira a URL de retorno de chamada do Amazon Quick OAuth no campo URL de **retorno de chamada**:
`{{}}/sn/oauthcallback`
Por exemplo: `https://us-east-1.quicksight.aws.amazon.com/sn/oauthcallback`
### Adicionar escopos do OAuth
**Mova os seguintes escopos de Escopos **OAuth disponíveis para Escopos OAuth** selecionados:**
+ Acessar o serviço de URL de identidade (ID, perfil, e-mail, endereço, telefone)
+ Gerenciar dados do usuário via APIs (api)
+ Gerencie os dados do usuário por meio de navegadores da Web (web)
+ Acesso total (completo)
+ Acesse os aplicativos do Visualforce (visualforce)
+ Executar solicitações a qualquer momento (refresh\_token, offline\_access)
+ Acessar identificadores de usuário exclusivos (openid)
+ Acessar permissões personalizadas (custom\_permissions)
+ Acesse os recursos da API REST do Connect (chatter\_api)
+ Acesse os recursos da API REST do Analytics (wave\_api)
+ Acesse os gráficos da API REST do Analytics e recursos de geodados (eclair\_api)
+ Gerenciar serviços do Pardot (pardot\_api)
### Ativar fluxos OAuth
Selecione as seguintes opções de fluxo:
+ **Ativar fluxo de credenciais do cliente**
+ **Ativar código de autorização e fluxo de credenciais**
+ **Ativar fluxo de troca de tokens**
### Ativar configurações de segurança
Selecione as seguintes opções de segurança:
+ **Exigir chave de prova para troca de código (PKCE)**
+ **Exigir segredo para o fluxo do servidor Web** (selecionado por padrão)
+ **Exigir segredo para atualizar o fluxo do token** (selecionado por padrão)
Escolha **Criar** para salvar o aplicativo cliente externo.
## Etapa 3: obter as credenciais do consumidor
1. Após a criação, você está na página de detalhes do ECA.
1. Navegue até a guia **Configurações** ou escolha **Gerenciar detalhes do consumidor**.
1. Talvez seja necessário verificar sua identidade (código de verificação de e-mail).
1. Copie a **chave do consumidor** (ID do cliente) e o **segredo do consumidor** (segredo do cliente).
**Importante**
Salve essas credenciais com segurança. Você precisa deles ao configurar o conector no Amazon Quick.
## Etapa 4: Configurar o conector Salesforce no Amazon Quick
### Navegue até Conectores
1. Abra o Amazon Quick e escolha **Conectores**.
1. Escolha a guia **Criar para sua equipe**.
1. Encontre e escolha o **Salesforce**.
1. Se for solicitado que um conector já existe, escolha **Não, crie um novo**.
### Preencha os detalhes da conexão
Insira os seguintes detalhes da conexão:
**Detalhes da conexão do conector Salesforce**
| Campo | Valor |
| --- | --- |
| Nome | Um nome descritivo (por exemplo, “Salesforce ECA”) |
| Rede | Rede pública |
| Tipo de autenticação | Aplicativo OAuth personalizado |
| URL base | https://{{}}.my.salesforce.com/services/data/v60.0 |
| ID do cliente | Chave do consumidor a partir da etapa 3 |
| Segredo do cliente | Segredo do consumidor a partir da etapa 3 |
| URL do token | https://{{}}.my.salesforce.com/services/oauth2/token |
| URL de autorização | https://{{}}.my.salesforce.com/services/oauth2/authorize |
| URL de redirecionamento | Pre-filled (não mude) |
Escolha **Próximo** para continuar.
## Etapa 5: verificar e publicar
1. Na página de **revisão**, verifique as ações disponíveis do Salesforce (até 42 ações).
1. Escolha **Avançar** para continuar com o compartilhamento de usuários.
1. Selecione usuários ou grupos que devem ter acesso a esse conector.
1. Escolha **Publicar** para publicar o conector.
Depois de publicar o conector, você pode usar as ações do Salesforce no chat, nos fluxos e nas automações do Amazon Quick.
## Ações disponíveis
Depois de configurar o conector, as seguintes ações do Salesforce estarão disponíveis:
+ 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.
**nota**
A integração com o Salesforce oferece suporte somente à 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.
## Solução de problemas
Para editar, compartilhar ou excluir seu conector, consulte[Gerenciando integrações existentes](integration-workflows.md#managing-existing-integrations).
+ **Erro “O URL não existe mais”** — Verifique se você está usando o domínio correto do Salesforce no URL do token e no URL de autorização. Não use endpoints legados.
+ **Falha na validação do OAuth** — Verifique se o PKCE está ativado no ECA e se o URL de retorno de chamada corresponde exatamente ao URL da sua instância Amazon Quick anexado. `/sn/oauthcallback`
+ **Erro de escopos ausentes** **— Volte para a configuração do ECA no Salesforce e certifique-se de que todos os escopos OAuth necessários estejam na lista **Selecionados**, não ainda em Disponível.**
+ A **opção “Aplicativo conectado” está acinzentada** — isso é esperado após o Salesforce Spring '26. Em vez disso, use um aplicativo cliente externo. Os ECAs são os substitutos compatíveis.