[Exemplo] Recuperando dados do Airtable (GET)

Bots são frequentemente usados para mostrar dados de fontes externas ao usuário. Uma maneira fácil de gerenciar esses dados é usando Airtable. Airtable é uma ferramenta que permite criar uma planilha com a qual você pode se comunicar por meio de uma API.

Neste tutorial, vamos configurar uma integração com o Airtable. Por causa de todo o código, parece bem técnico, mas, na verdade, é bem fácil.

Se você é novo no uso de variáveis no Chatlayer.ai, siga este o tutorial primeiro.

Como exemplo, vamos construir um bot que mostra informações sobre encontros de chatbots.

• A primeira coisa que precisamos fazer é criar alguns dados de encontros. Neste exemplo, vamos usar este Airtable. Fique à vontade para reutilizá-lo!

• Comece criando um fluxo curto que explique o propósito do bot e pergunte de qual mês o usuário quer saber informações sobre encontros.

• Para a pergunta sobre o mês, certifique-se de usar uma validação de entrada que salva a resposta como amês variável e que continue para a próxima etapa: um bloco de Ação.

• Configure o bloco de Ação que é acionado após a validação de entrada com um plug-in de código. Adicione a variável "month" como argumento, conforme mostrado na captura de tela:

Quer saber mais sobre as possibilidades do plug-in de Código? Você pode encontrá-lo aqui.

• Em seguida, adicione este trecho de código:

const { month } = args;

const { records = [] } = await fetch(
  "https://api.airtable.com/v0/(yourAppId)/(yourTableName)",
  {
    method: "GET",
    headers: {
      Authorization: "Bearer (insert token here)",
    },
  }
).then((res) => res.json());

const found = records.filter((rec) => rec.fields.Month === month.toLowerCase());

const builder = ChatlayerResponseBuilder();

if (found.length) {
  builder.addSessionVariable("meetups", found);
} else {
  builder.addSessionVariable("nomeetups", found);
}

builder.send();

Lembre-se de obter o app id, o nome da tabela e o bearer token corretos para o seu Airtable. Você pode encontrá-los aqui.

• Este bloco de código pesquisa na tabela por um encontro no mês informado pelo usuário e, se encontrar um, retorna essas informações para o Chatlayer.ai. Se nenhum encontro for encontrado, a nomeetups variável é salva na sessão do usuário.

• Se você seguir o fluxo até este ponto, ele ficará mais ou menos assim:

• E os seguintes dados são salvos na sessão:

• Agora tudo o que precisamos fazer é mostrar esses dados! Adicione um Go To ao final do bloco de Ação onde você adicionou o bloco de código.

• Configure este Go To da seguinte forma:

• Dessa forma, o usuário receberá uma resposta diferente se não houver encontros no mês sobre o qual ele perguntou.

• Por fim, configure as mensagens em "show meetup info" para exibir as informações recuperadas da planilha do Airtable.

• Pronto! Agora você pode testar o fluxo completo.