[Exemplo] Enviando dados para Airtable (POST)

Dados coletados dentro dos bots geralmente são enviados para um banco de dados externo. Uma maneira fácil de fazer isso é integrando com Airtable. Airtable é uma ferramenta que permite criar uma planilha com a qual você pode se comunicar por meio de uma API.

Observe que o termo estado do diálogo se refere à mesma coisa que bloco, no contexto de ferramentas de desenvolvimento.

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.

• Comece criando um fluxo curto que você usará para coletar alguns dados sobre o usuário, por exemplo:

• Este fluxo adiciona as variáveis "customerType" e "firstName" à sessão do usuário.

• Configure um Airtable que tenha uma coluna para cada variável que você deseja salvar. Serão adicionadas linhas para cada cliente.

Neste tutorial, vamos usar este Airtable. Fique à vontade para reutilizá-lo!

• No ponto do fluxo em que você quiser enviar os dados para o Airtable, adicione uma Action contendo um plug-in de Código.

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

• No nosso exemplo, queremos enviar o tipo de cliente e o primeiro nome. Além disso, queremos ir para outro diálogo do bot assim que os dados forem enviados. Comece adicionando esses parâmetros no topo do seu editor de código.

• Depois, adicione o código abaixo ao plug-in e salve o diálogo da sua Action.

const body = {
    "records": [{
        "fields": {
            "Nome": args.firstName,
            "Tipo de Cliente": args.customerType
        }
    }]
}
const airtableResult = await fetch('https://api.airtable.com/v0/(yourAppId)/(yourTableName)', {
    method: 'POST',
    body: JSON.stringify(body),
    headers: {
        'Authorization': 'Bearer (insert token here)',
        'Content-Type': 'application/json'
    }
}).then(r => r.json())

ChatlayerResponseBuilder()
    .setNextDialogState(args.nextDialogState)
    .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.

• Pronto! Agora, toda vez que um usuário passar pelo seu fluxo, os dados dele serão enviados para o Airtable, e ele continuará para o diálogo de bot Success.

• Se houver algum erro com sua conexão ao Airtable, você pode encontrá-los na aba de logs de erro no Chatlayer.ai.