Airtable

Com esta integração você pode buscar, ler e atualizar dados no seu banco de dados Airtable muito mais facilmente do que ter que criar uma API.

Você pode conectar seu App do Airtable de 2 maneiras:

1. Via bloco de Açãobloquear quando você estiver construindo seu bot

2. A partir do menu da página inicial do Chatlayer: principalmente antes de construir seu bot, quando você sabe que vai criar solicitações para uma ou mais tabelas do Airtable

1 – Via bloco de Ação

Configure seu App do Airtable diretamente em um bloco de Ação clicando na opção 'Adicionar ação' e então em 'Integração':

Se ainda não houver um app do Airtable configurado (conforme descrito na parte 2 deste guia), um pop-up aparecerá:

Você pode encontrar sua Chave de API na página da sua Conta do Airtable. Saiba mais d.

Ou você também pode regenerar a chave:

Ao clicar na Chave de API, você poderá visualizá-la. Então clique, selecione, copie e cole-a no campo correspondente do pop-up:

Você verá um novo campo para selecionar integrações. Escolha 'Airtable'

No campo Conta do Airtable, você verá todos os Apps que talvez já tenha criado seguindo os passos na segunda parte deste guia, ou você pode criar um novo clicando em 'Conectar nova conta':

Uma vez que você escolha o App integrado que já possui (ou criou um novo), você verá o campo 'Selecionar Ação'. Existem três ações possíveis: Pesquisar, Criar e Atualizar registros do seu Airtable

Três novos campos vazios aparecerão nesta tela. Veja como você deve preenchê-los:

Você obterá a informação para o campo “Base” a partir da URL do Airtable. A sintaxe da URL é:

https://airtable.com/appXXXXXXX[use isto para “Base”]/tblYYYYYY[use isto para “Tabela”]/…

É assim que seu bloco de Ação ficará uma vez preenchido:

Para a Ação Pesquisar, preencha o 'Campo de Pesquisa' (use o nome da coluna da sua tabela) e o Valor de Pesquisa (um variável que o usuário irá inserir, que deve corresponder a um dos pontos de dados do Campo de Pesquisa) ou crie sua própria Fórmula de Pesquisa.

Mais informações sobre o que preencher se você quiser usar a opção 'Fórmula de Pesquisa' aqui.

Agora construa sua sintaxe de resposta:

Você saberá que está certo quando seu bot exibir os dados corretos da sua tabela:

2. A partir do menu da página inicial do Chatlayer

Você pode configurar a integração Airtable diretamente a partir do menu lateral em app.chatlayer.ai

Você também pode criá-la clicando no botão '+ Adicionar Conta', após o qual você verá este pop-up:

Você pode encontrar sua Chave de API na página da sua Conta do Airtable. Saiba mais aqui

Ou você pode regenerar uma chave:

Ao clicar na Chave de API, você poderá visualizá-la. Clique, selecione, copie e cole-a no campo correspondente do pop-up:

É assim que ficará quando você tiver conectado com sucesso

Ao clicar nos três pontos à direita, você pode gerenciar sua integração de app. Existem quatro ações:

• Reconectar: abrirá um novo pop-up permitindo que você altere a Chave de API

• Testar Conexão (em breve)

• Alterar Nome da Conta: abrirá um pop-up para que você possa renomear seu App integrado

• Remover: Atenção! Ao clicar neste botão, sua integração do App será imediatamente removida

Como usar cada tipo de Ação possível na Integração do App Airtable

Pesquisar, Criar e Atualizar Registro são as ações possíveis:

Criar Registro

Para criar um registro, você deve selecionar o App do Airtable e a conta do Airtable (conectando-se a uma existente ou conectando a outra), escolher a ação Criar Registro, informar Base e Tabela, conforme explicado em A.8.1(link).

A etapa seguinte é preencher os campos do Registro. No campo em branco à esquerda, deve-se informar o nome da coluna no seu Airtable, e no campo em branco à direita, deve-se informar o valor “hard-coded” ou a variável (entre chaves).

No exemplo abaixo, a coluna a ser atualizada se chama ‘Number’ e a variável se chama numberChosen. A variável informada pelo usuário foi salva em uma etapa anterior através de uma Validação de Entrada bloco.

Atualizar Registro

Para Atualizar um registro, você deve selecionar o App do Airtable e a conta do Airtable (conectando-se a uma existente ou conectando a outra), escolher a ação Atualizar Registro, informar Base e Tabela, conforme explicado em A.8.1(link).

Leia sobre campos Record ID e Cell Values abaixo da imagem.

ID do Registro do Airtable

O ID do Registro é o que está destacado na URL da captura de tela abaixo – você não pode usar apenas o valor informado pelo cliente; para se referir ao ID correto, você coleta o ID informado pelo cliente em uma variável (através de uma Validação de Entrada xv).

A sintaxe correta para recuperar o Record ID é {apps.airtable.read_record._id}

Em Cell Values, o nome da coluna onde o valor será atualizado é informado no campo em branco à esquerda, neste caso ‘Number’, e a variável que contém o novo valor é informada no campo em branco à direita, neste exemplo {numberUpdate}

A captura de tela a seguir mostra um exemplo do fluxo que é explicado na tabela mais abaixo.

Agora você está pronto para criar uma experiência de bot personalizada para seus clientes!