Antes de incluir ações externas nos seus fluxos de ação, é preciso conectar o criador de ações ao sistema externo.

Qual é o meu plano?
Suite, todas as versões Team, Growth, Professional, Enterprise ou Enterprise Plus
Support Team, Professional ou Enterprise

Resumo: ◀▼

Você pode conectar o Airtable a fluxos de ação para automatizar tarefas, como criar, atualizar, excluir e pesquisar registros. Use um token de acesso pessoal para autenticação e uma conta de serviço dedicada para segurança. As ações disponíveis incluem operações em lote, adição de comentários e recuperação de esquemas de tabela, ajudando você a integrar o gerenciamento de dados do Airtable diretamente a seus fluxos de dados para fins de melhoria na colaboração e no gerenciamento de dados.

Ao conectar o criador de ações a sistemas externos, como o Airtable, administradores podem integrar o Zendesk a sistemas externos em fluxos de trabalho automatizados, melhorando a colaboração e mantendo uma experiência contínua em várias plataformas.
Observação: as etapas associadas aos sistemas externos em fluxos de ação são chamadas coletivamente de ações externas.
Este artigo contém os seguintes tópicos:
  • Conexão do Airtable ao criador de ações
  • Uso de ações do Airtable em fluxos de ação

Conexão do Airtable ao criador de ações

Antes de incluir ações externas nos seus fluxos de ação, é preciso conectar o criador de ações ao sistema externo.

Ao se conectar a sistemas externos para uso em fluxos de ação, as seguintes práticas recomendadas devem ser observadas:
  • Todas as ações externas realizadas por um fluxo de ação são atribuídas ao usuário que conectou o sistema externo. Portanto, é uma prática recomendada usar uma conta de serviço dedicada em vez de credenciais pessoais ao se conectar a cada sistema externo.
  • Todas as integrações solicitam acesso aos escopos necessários. No entanto, é importante que você avalie e valide os escopos antes de autorizar a conexão com o sistema externo.
  • Ao gerenciar credenciais para ferramentas baseadas em chave de API, como a OpenAI, recomendamos armazenar as chaves em um cofre seguro ou em um gerenciador de credenciais.

Como criar um token de acesso pessoal

A conexão do Airtable requer um token de acesso pessoal (PAT) para autenticação. Consulte a documentação do Airtable para obter detalhes.
  1. Crie um token de acesso pessoal em https://airtable.com/create/tokens.
  2. Conceda ao token acesso às bases específicas que você deseja usar.
  3. Confirme se o token tem os seguintes escopos: data.records:read, data.records:write, data.recordComments:read, data.recordComments:write,schema.bases:read
  4. Salve o token ou mantenha a janela aberta para poder copiá-lo e colá-lo no Zendesk.

    Você precisará dele ao conectar o Airtable ao criador de ações.

Como conectar o criador de ações ao Airtable
  1. Na Central de administração, clique em Aplicativos e integrações na barra lateral e selecione Ações > Fluxos de ação.
  2. Crie ou edite um fluxo de ação.
  3. Abra a barra lateral da etapa.
  4. Em Ações externas, clique em Airtable.
  5. Clique em Conectar.
  6. Siga as solicitações do Airtable para inserir seu token de acesso do Airtable e concluir a conexão.
    Observação: Todas as ações externas realizadas por um fluxo de ação são atribuídas ao usuário que conectou o sistema externo. Portanto, é uma prática recomendada usar uma conta de serviço dedicada em vez de credenciais pessoais ao se conectar a cada sistema externo.

Após conectar-se ao sistema, você verá um indicador de que a conexão foi estabelecida e detalhes sobre a instância à qual está conectado, bem como as ações disponíveis para o Airtable.

Uso de ações do Airtable em fluxos de ação

As seguintes ações do Airtable estão disponíveis:
  • Criar registro
  • Atualizar registro
  • Apagar registro
  • Consultar registro
  • Pesquisar registros
  • Pesquisar comentários
  • Criar registros em lote
  • Apagar registros em lote
  • Adicionar comentário ao registro
  • Pesquisar esquema da tabela

Criação de um registro

Use a ação Criar registro para criar um novo registro em uma tabela do Airtable.

As entradas e saídas dessa ação são:

  Variáveis
Entradas Obrigatórias: Base ID, Table name, Record fields (ou campos dinâmicos específicos da tabela)

O ID da base começa com "app" (por exemplo, appAbCd1234EfGhIj) e pode ser encontrado na sua URL do Airtable.

É possível especificar o nome da tabela (por exemplo, "Contatos") ou o ID da tabela (começa com "tbl").

Depois de selecionar uma base e uma tabela, a ação carregará dinamicamente os campos específicos dessa tabela. Os campos de registro devem estar formatados como "FieldName: Value, Field2: Value2" para matrizes que usam ponto e vírgula (Tags: tag1; tag2).
Saída Detalhes do registro, incluindo ok status, baseId, tableName e objeto de registro (com id, createdTime e campos).

Atualização de um registro

Use a ação Atualizar registro para modificar um registro resistente em uma tabela do Airtable.

As entradas e saídas dessa ação são:

  Variáveis
Entradas Obrigatórias: Base ID, Table name, Record ID, Record fields (ou campos dinâmicos específicos da tabela)

O ID do registro começa com "rec" (por exemplo, recAbCd1234EfGhIj).

Depois de selecionar uma base e uma tabela, a ação carregará dinamicamente os campos específicos dessa tabela. Forneça valores somente para campos que deseja atualizar. Os valores existentes para os campos que você não especificar permanecerão inalterados.
Saída Detalhes do registro, incluindo ok status, baseId, tableName e objeto de registro (com id e campos atualizados).

Exclusão de um registro

Use a ação Apagar registro para apagar permanentemente um registro específico de uma tabela do Airtable.
Importante: essa ação apaga permanentemente o registro e não pode ser desfeita. Use com cuidado.

As entradas e saídas dessa ação são:

  Variáveis
Entradas Obrigatórias: Base ID, Table name, Record ID
Saída Detalhes da exclusão, incluindo ok status, baseId, tableName, confirmação excluída e ID do registro.

Pesquisa de registro

Use a ação Consultar registro para recuperar um registro por seu ID de uma tabela do Airtable. Use essa ação para recuperar informações detalhadas sobre um registro específico, incluindo todos os seus valores de campo. O esquema de saída reflete dinamicamente a estrutura real do campo da tabela.

As entradas e saídas dessa ação são:

  Variáveis
Entradas Obrigatórias: Base ID, Table name, Record ID
Saída Detalhes do registro, incluindo ok status, baseId, tableId, tableName e objeto de registro (com id, createdTime e campos com os respectivos valores).

Pesquisa de registros

Use a ação Pesquisar registros para encontrar registros em uma tabela usando filtros, classificação e paginação.

As entradas e saídas dessa ação são:

  Variáveis
Entradas Obrigatórias: Base, Table

Opcionais: Filter by formula, View, Sort field, Sort direction, Max records, Page size, Offset, Return fields by field ID

O filtro por fórmula usa a sintaxe da fórmula do Airtable (por exemplo, "{Name} = 'John'"). A visualização restringe os resultados a uma visualização específica. As opções de direção de classificação são Crescente e Decrescente. O tamanho máximo da página é 100. Use o valor de compensação da resposta para buscar a próxima página de resultados. O retorno de campos por ID de campo determina se devem ser usados nomes de campo ou IDs de campo na saída.
Saída Matriz de registros com ok status, baseId, tableId, tableName, registros (cada um com ID, createdTime e campos) e deslocamento de paginação.

Pesquisa de comentários

Use a ação Pesquisar comentários para recuperar todos os comentários em um registro do Airtable.

As entradas e saídas dessa ação são:

  Variáveis
Entradas Obrigatórias: Base ID, Table name, Record ID

Opcionais: Page size, Offset

O tamanho de página controla quantos comentários retornar por solicitação (1 a 100, padrão: 100). Use o valor de deslocamento da resposta para buscar a próxima página de comentários. Uma cadeia de caracteres de deslocamento vazia indica que não há mais páginas disponíveis.
Saída Matriz de comentários com ok status, baseId, tableName, recordId, comentários (cada um com id, text, createdTime, lastUpdatedTime e detalhes de autor) e deslocamento de paginação.

Criação de registros em lote

Use a ação Criar registros em lote para criar vários registros de uma só vez em uma tabela do Airtable.

As entradas e saídas dessa ação são:

  Variáveis
Entradas Obrigatórias: Base ID, Table name, Records

Formate vários registros como "FieldName: Value, Field2: Value2" e separe cada registro com "---" (três traços). Exemplo: "Name: John Doe, Status: Active\n---\nName: Jane Smith, Status: Done". Isso é útil para operações de importação de dados em massa.
Saída Registra matriz com ok status, baseId, tableName e matriz de registros criados (cada uma com id e createdTime)

Exclusão de registros em lote

Use a ação Apagar registros em lote para apagar vários registros de uma só vez de uma tabela do Airtable. Esta ação é útil para operações de limpeza em massa.
Importante: essa ação apaga permanentemente todos os registros e não pode ser desfeita. Use com cuidado.

As entradas e saídas dessa ação são:

  Variáveis
Entradas Obrigatórias: Base ID, Table name, Record IDs

IDs de registro podem ser fornecidos separados por vírgula ou um por linha (por exemplo, "recAbCd123, recEfGh456, recIjKl789").
Saída Registra matriz com ok status, baseId, tableName e matriz de registros (cada uma com id e confirmação excluída)

Adição de comentários a um registro

Use a ação Adicionar comentário ao registro para publicar um comentário em um registro do Airtable. Os comentários são visíveis a todos os colaboradores com acesso ao registro. Use esta ação para adicionar observações, atualizações ou contexto para registros de seus fluxos de trabalho do Zendesk.

As entradas e saídas dessa ação são:

  Variáveis
Entradas

Obrigatórias: Base ID, Table name or ID, Record ID, Comment text
Saída Detalhes de comentários, incluindo ok status, baseId, tableIdOrName, recordId e objeto de comentário (com id, text, createdTime e detalhes de autor, incluindo id, e-mail e nome).

Pesquisa de um esquema de tabela

Use a ação Pesquisar esquema da tabela para recuperar as definições de esquema e campo de uma tabela do Airtable. Use esta ação para descobrir a estrutura de uma tabela, incluindo todos os campos disponíveis e seus tipos. Isso é útil principalmente ao criar fluxos de trabalho dinâmicos que precisam se adaptar a estruturas de tabela diferentes. O tableId dessa resposta pode ser usado para referências de tabela mais confiáveis em outras ações.

As entradas e saídas dessa ação são:

  Variáveis
Entradas

Obrigatórias: Base ID, Table ID or name
Saída Esquema de tabela, incluindo ok status, baseId, tableId, tableName e objeto de tabela (com id, nome, primaryFieldId, descrição, matriz de campos com id/nome/tipo/descrição e matriz de visualizações com id/nome/tipo).
Powered by Zendesk