[Exemplo] Enviando dados para o Airtable (POST)

Dados coletados dentro dos bots frequentemente 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 via API.

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

• Comece construindo um fluxo curto que você use para coletar alguns dados sobre seu 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. Linhas serão adicionadas para cada cliente.

• No ponto do fluxo onde você deseja enviar os dados para o Airtable, adicione uma Ação contendo um plugin de Código.

• No nosso exemplo, queremos enviar o tipo do cliente e o primeiro nome. Além disso, queremos pular 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.

• Em seguida, adicione o código abaixo ao plugin e salve seu diálogo de Ação.

const body = {
    "records": [{
        "fields": {
            "First Name": args.firstName,
            "Customer Type": 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()

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

• Se houver quaisquer erros com sua conexão ao Airtable, você pode encontrá-los na aba de Logs de Erro no Chatlayer.ai.