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 com o Airtable Com o conector de ação Airtable, você pode acessar a plataforma Airtable diretamente no Amazon Quick por meio de linguagem natural. Você pode criar e atualizar registros, gerenciar bases e tabelas, filtrar visualizações e realizar operações de dados relacionais sem sair do Amazon Quick. O Amazon Quick oferece suporte a vários métodos de autenticação para o Airtable. Escolha o método que melhor se adapta aos requisitos de segurança da sua organização. + Aplicativo **OAuth padrão — usa um aplicativo** OAuth AWS gerenciado. Nenhuma credencial adicional é necessária. Os usuários se autenticam diretamente com sua conta Airtable. + Aplicativo **OAuth personalizado — usa um aplicativo** OAuth gerenciado pelo cliente registrado no Airtable. Essa opção dá à sua organização controle total sobre a configuração do OAuth. + **Chave de API** — usa um token de acesso pessoal Airtable para autenticação. Adequado para uso ou teste individual. Para obter mais informações sobre os métodos de autenticação compatíveis com o Amazon Quick, consulte[Métodos de autenticação](quick-action-auth.md). ## Antes de começar Verifique se você tem o seguinte antes de configurar a integração. + Uma conta Airtable ativa com acesso às bases e dados que você deseja usar. + Para o **aplicativo OAuth personalizado**: Acesse o [Airtable Builder Hub no site do Airtable](https://airtable.com/create/oauth) para registrar uma integração com o OAuth. + Para **chave de API**: um token de acesso pessoal do [Airtable Builder Hub](https://airtable.com/create/tokens) no site da Airtable. + Para obter os requisitos de assinatura do Amazon Quick, consulte[Configurar integrações no console](integration-console-setup-process.md). ## Configurando o Airtable Se você estiver usando a autenticação **padrão do aplicativo OAuth**, pule esta seção e prossiga para. [Configurando o conector no Amazon Quick](#airtable-quicksuite-setup) Para autenticação personalizada do aplicativo OAuth ou da chave de API, conclua as etapas aplicáveis no Airtable antes de configurar o Amazon Quick. ### Registrar uma integração OAuth (aplicativo OAuth personalizado) Crie uma integração OAuth no Airtable Builder Hub para obter as credenciais de cliente que você precisa para o Amazon Quick. 1. Faça login no [Airtable Builder Hub](https://airtable.com/create/oauth) no site da Airtable e escolha as integrações **OAuth**. 1. Escolha **Registrar nova integração OAuth.** 1. Insira um **nome** para sua integração. 1. Para **URLs de redirecionamento do OAuth**, insira o URL de redirecionamento do Amazon Quick: `https://{{{region}}}.quicksight.aws.amazon.com/sn/oauthcallback` 1. Escolha **Registrar integração**. 1. Após o registro, gere um segredo do cliente escolhendo **Regenerar segredo do cliente**. 1. Registre os seguintes valores. Você precisa deles ao configurar o Amazon Quick. + **ID do cliente** + **Segredo do cliente** 1. Em **Escopos**, selecione as permissões que sua integração exige. Para obter a lista completa dos escopos recomendados, consulte[Escopos recomendados](#airtable-oauth-scopes). ### Crie um token de acesso pessoal (chave de API) Crie um token de acesso pessoal no Airtable Builder Hub para autenticação da chave de API. 1. Faça login no [Airtable Builder Hub](https://airtable.com/create/tokens) no site da Airtable e escolha Tokens de **acesso pessoal**. 1. Selecione **Criar token**. 1. Configure o nome do token, os escopos e o acesso básico conforme necessário para seu caso de uso. 1. Copie e armazene com segurança o token gerado. Você precisa dele ao configurar o Amazon Quick. ### Escopos recomendados Ao registrar uma integração OAuth ou criar um token de acesso pessoal, configure os escopos a seguir com base nas ações que você deseja usar. **Escopos recomendados pela Airtable** | Escopo | Description | | --- | --- | | data.records:read | Leia os dados nos registros. | | data.records:write | Crie, edite e exclua registros. | | data.recordComments:read | Leia os comentários nos registros. | | data.recordComments:write | Crie, edite e exclua comentários do registro. | | schema.bases:read | Leia a estrutura das bases, incluindo nomes de tabelas e tipos de campos. | | schema.bases:write | Edite a estrutura das bases, incluindo nomes de tabelas e tipos de campo. | | user.email:read | Leia o endereço de e-mail do usuário autenticado. | ## Configurando o conector no Amazon Quick ### Conecte-se a partir da guia Disponível Se quiser usar a autenticação padrão do aplicativo OAuth, você pode se conectar diretamente da guia **Disponível** sem configuração adicional. 1. No console do Amazon Quick, escolha **Conectores**. 1. Na guia **Disponível**, localize **Airtable** e escolha **Connect**. 1. Conclua o fluxo de login do Airtable e conceda as permissões solicitadas. Para configurar um conector com o aplicativo OAuth personalizado ou a chave de API, use a guia **Criar para sua equipe**, conforme descrito abaixo. ### Crie a partir da guia Criar para sua equipe Depois de concluir qualquer configuração necessária do Airtable, crie o conector no Amazon Quick. 1. No console do Amazon Quick, escolha **Conectores**. 1. Escolha a guia **Criar para sua equipe**. 1. Encontre e escolha **Airtable.** **nota** Se um conector Airtable já existir, uma caixa de diálogo será exibida com seus conectores existentes. Para usar um conector existente, escolha-o. Para criar um novo, escolha **Não, criar novo**. 1. Insira um **nome** para seu conector. Opcionalmente, escolha **\+ Adicionar descrição** para adicionar uma descrição. 1. Em **Tipo de conexão**, escolha **Rede pública**. 1. Para **Configuração do OAuth**, escolha um dos métodos de autenticação a seguir e configure os campos obrigatórios. 1. Para o **aplicativo OAuth padrão**: Nenhuma credencial adicional é necessária. Escolha **Próximo** para continuar. 1. Para o **aplicativo OAuth personalizado**, configure os seguintes campos: + **URL base** (opcional) — A URL base da API Airtable. Exemplo: `https://api.airtable.com` + **ID do cliente** — O ID do cliente da sua integração com o Airtable OAuth. + **Segredo do cliente** — O segredo do cliente da sua integração com o Airtable OAuth. + **URL do token** — O endpoint do token. Exemplo: `https://airtable.com/oauth2/v1/token` + **URL de autorização** — O endpoint de autorização. Exemplo: `https://airtable.com/oauth2/v1/authorize` + URL de **redirecionamento — Pre-filled com o URL** de retorno de chamada do Amazon Quick. 1. Para a **chave de API**, configure os seguintes campos: + **URL base** (opcional) — A URL base da API Airtable. Exemplo: `https://api.airtable.com` + **Chave de API** — Seu token de acesso pessoal do Airtable. + **E-mail** (opcional) — O endereço de e-mail associado à sua conta Airtable. 1. Escolha **Próximo**. 1. Se você escolher o aplicativo **OAuth padrão ou o aplicativo** **OAuth personalizado, uma janela de autorização do** Airtable será aberta. Analise as permissões solicitadas, escolha as bases e os espaços de trabalho aos quais conceder acesso e escolha **Conceder acesso**. 1. Na página **Revisar**, revise as ações disponíveis para o conector. Escolha **Próximo**. 1. Na página **Publicar**, escolha quem pode acessar o conector. Você pode habilitar o acesso para todos em sua organização ou pesquisar equipes ou grupos específicos. 1. Selecione **Publish**. ## Ações disponíveis Depois de configurar o conector, as ações a seguir estarão disponíveis. **Ações disponíveis do Airtable** | Categoria | Ação | Description | | --- | --- | --- | | Registros | Listar registros | Lista os registros em uma tabela com filtragem e classificação opcionais. | | Registros | Obter registro | Recupera um registro específico por ID. | | Registros | Registro de criação em lote | Cria um ou mais novos registros em uma tabela. | | Registros | Atualizar registro | Atualiza campos em um registro existente. | | Registros | Registro de atualização em lote | Atualiza vários registros em uma única operação usando PATCH. | | Registros | Registro em Batch Put | Atualiza vários registros em uma única operação usando PUT. | | Comentários | Listar comentários | Lista os comentários em um registro. | | Comentários | Criar comentário | Adiciona um comentário a um registro. | | Comentários | Atualizar comentário | Edita um comentário existente em um registro. | | Schema | Bases da lista | Lista todas as bases acessíveis ao usuário autenticado. | | Schema | Obtenha o esquema básico | Recupera o esquema de uma base, incluindo tabelas e definições de campo. | | Schema | Criar tabela | Cria uma nova tabela em uma base. | | Schema | Atualizar tabela | Atualiza as propriedades da tabela, como nome ou descrição. | | Schema | Criar campo | Adiciona um novo campo a uma tabela. | | Schema | Atualizar campo | Atualiza as propriedades do campo, como nome ou tipo. | | Anexos | Criar anexo | Carrega um anexo em um registro. | | Usuários | Obter informações do usuário | Recupera informações sobre o usuário autenticado. | **nota** As ações que você pode usar dependem das bases e dos espaços de trabalho acessíveis ao usuário autenticado. ## Gerenciamento e solução de problemas Para editar, compartilhar ou excluir seu conector, consulte[Gerenciando integrações existentes](integration-workflows.md#managing-existing-integrations). ### Problemas de autenticação + **Sign-in falha (aplicativo OAuth padrão ou aplicativo OAuth personalizado)** — Verifique se sua conta do Airtable está ativa e se você pode entrar diretamente no [airtable.com no site do Airtable](https://airtable.com). Para o aplicativo OAuth personalizado, confirme se o URL de redirecionamento em sua integração com o Airtable OAuth corresponde ao URL de retorno de chamada do Amazon Quick. + **Credenciais de cliente inválidas (aplicativo OAuth personalizado)** — Verifique se o ID do cliente e o segredo do cliente correspondem aos valores em sua integração com o Airtable OAuth. Se você regenerou o segredo do cliente, atualize o valor no Amazon Quick. + **Chave de API rejeitada** — Verifique se seu token de acesso pessoal está ativo e tem os escopos necessários. Os tokens podem ser revogados ou expirados no Airtable Builder Hub. + **Permissões insuficientes** — Verifique se os escopos configurados para seu método de autenticação incluem as permissões necessárias para as ações que você deseja usar. Consulte [Escopos recomendados](#airtable-oauth-scopes).