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

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 OAuth aplicativos (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. 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.

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

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

  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 OAuth Políticas > 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 Integrações.

  2. Escolha Salesforce nas opções de integração e clique no botão Adicionar (mais “+”).

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

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

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

  6. Selecione Criar e continuar.

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

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