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, consulteConfigurar integrações no console.
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
-
Entre na sua organização do Salesforce e escolha Configuração (ícone de engrenagem no canto superior direito).
-
No painel de navegação, expanda Ferramentas da plataforma > Aplicativos > Aplicativos clientes externos > Gerenciador de aplicativos clientes externos.
-
Escolha Novo aplicativo cliente externo.
Preencha as informações básicas
Insira as seguintes informações básicas para seu 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:
<your-quick-instance-url>/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
-
Após a criação, você está na página de detalhes do ECA.
-
Navegue até a guia Configurações ou escolha Gerenciar detalhes do consumidor.
-
Talvez seja necessário verificar sua identidade (código de verificação de e-mail).
-
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
-
Abra o Amazon Quick e escolha Conectores.
-
Escolha a guia Criar para sua equipe.
-
Encontre e escolha o Salesforce.
-
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:
| Campo | Valor |
|---|---|
| Nome | Um nome descritivo (por exemplo, “Salesforce ECA”) |
| Rede | Rede pública |
| Tipo de autenticação | Aplicativo OAuth personalizado |
| URL base | https:// |
| 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:// |
| URL de autorização | https:// |
| URL de redirecionamento | Pre-filled (não mude) |
Escolha Próximo para continuar.
Etapa 5: verificar e publicar
-
Na página de revisão, verifique as ações disponíveis do Salesforce (até 42 ações).
-
Escolha Avançar para continuar com o compartilhamento de usuários.
-
Selecione usuários ou grupos que devem ter acesso a esse conector.
-
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, consulteGerenciando integrações existentes.
-
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.
