View a markdown version of this page

Integração ao Salesforce - Amazon Quick
O que é possível fazerAntes de começarEtapa 1: configurar o aplicativo conectado ao SalesforceEtapa 2: Configurar detalhes do consumidor e usuário de execuçãoEtapa 3: configurar o conector de ação do SalesforceEtapa 4: associar o conector de ação aos grupos de automaçãoAções de tarefas disponíveisCompartilhe integraçõesGerenciar conectores de ação do Salesforce

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

O que é possível fazer

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

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 aplicativos OAuth (se estiver usando a autenticação do usuário).

Etapa 1: configurar o aplicativo conectado ao Salesforce

nota

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

Crie um aplicativo conectado no Salesforce para habilitar a autenticação OAuth 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.

  2. Na barra Busca rápidaApps, digite e siga estas etapas:

    • Selecione aplicativos de cliente externos

    • Selecione Configurações

    • Em Configurações, crie um novo aplicativo conectado

  3. Escolha Novo aplicativo conectado.

  4. Escolha Criar um aplicativo conectado.

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

  6. Na seção Configurações do OAuth, marque as seguintes caixas de seleção:

    • Ativar configurações de OAuth

    • 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

  7. Adicione os seguintes escopos de OAuth necessários:

    • api- Acesse as APIs do Salesforce

    • 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- Web-based acesso

    • 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

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

  9. Escolha Salvar.

Etapa 2: Configurar detalhes do consumidor e usuário de execução

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.

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

  3. Escolha Aplicar.

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

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

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

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

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

    4. Escolha Salvar.

Etapa 3: configurar o conector de ação do Salesforce

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

  2. Escolha a guia Criar para sua equipe.

  3. Encontre e escolha o Salesforce.

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

  5. Escolha seu tipo de conexão:

    • Autenticação do usuário - OAuth-based autenticação para acesso individual do usuário.

    • Autenticação de serviço - Service-to-service autenticação para acesso ao aplicativo.

  6. 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 token Salesforce OAuth.

      • URL de autenticação - ponto final de autorização do Salesforce OAuth.

      • URL de redirecionamento - URI de redirecionamento OAuth configurado em seu aplicativo conectado.

  7. Selecione Criar e continuar.

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

  9. Clique em Next.

Etapa 4: associar o conector de ação aos grupos de automação

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.

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

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

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

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.

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

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

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

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.